[Extensión] Cómo integrar Bitrix24 a Blip

1. Introducción

2. Funcionalidades

3. Requisitos previos

4. Instalación y configuración

5. Ejemplos de uso

6. Buenas prácticas

7. Soporte

Descripción breve: Crea leads, contactos y empresas en el CRM de Bitrix24 automáticamente a partir de las conversaciones de tu chatbot en Blip, usando los datos recopilados durante la atención.

Introducción

La extensión de Bitrix24 conecta tu chatbot de Blip al CRM de Bitrix24. Durante una conversación, el flujo envía los datos que proporcionó el contacto (nombre, correo electrónico, teléfono y otros) directamente a Bitrix24 y crea un lead, un contacto o una empresa, sin que el equipo tenga que registrar nada manualmente.

Por ejemplo, cuando un cliente proporciona su nombre, correo electrónico y teléfono durante la atención por WhatsApp, el flujo crea un lead en Bitrix24 con esta información ya completada. La extensión es desarrollada por Wiv y está disponible en Blip Store.

Funcionalidades

• Crear leads en Bitrix24 con los datos recopilados en la conversación.

• Al crear un lead, vincular automáticamente un contacto (cuando hay teléfono o correo electrónico) y una empresa (cuando hay nombre de empresa).

• Crear contactos en Bitrix24.

• Crear empresas en Bitrix24.

• Completar los campos del registro con valores fijos o variables de Blip. Los campos disponibles varían según el tipo de registro: correo electrónico, teléfono, sitio web y parámetros UTM (source, medium, campaign, content y term) aplican para lead, contacto y empresa; nombre aplica para lead y contacto; título aplica para lead y empresa; y nombre de la empresa, dirección y ciudad aplican únicamente para el lead.

• Guardar el resultado de la operación en una variable de retorno del flujo, para tratar el éxito o el error en los bloques siguientes.

Compatible con los siguientes canales: todos los canales disponibles en la plataforma Blip.

Requisitos previos

Antes de comenzar, necesitas:

• Acceso administrativo a tu cuenta de Bitrix24.

• Acceso al bot de Blip donde se usará la extensión.

• Google Chrome para instalar la extensión de Builder (consulta el paso 5).

Instalación y configuración

Sigue los pasos a continuación para activar la extensión, conectar tu cuenta de Bitrix24 y usar la integración dentro de un flujo.

1. Activa la extensión e instálala en el bot

Activa la extensión Bitrix24 en Blip Store e instálala en el bot de atención donde creas el flujo en Builder. La extensión aparecerá entre las extensiones instaladas del bot.

2. Crea el webhook en Bitrix24

Ingresa a tu cuenta de Bitrix24 y selecciona el entorno que se integrará.

En el menú lateral, accede a Aplicaciones > Recursos para desarrolladores.

Selecciona Otro > Webhook entrante.

En la pantalla de configuración, copia el primer enlace que aparece en el campo del webhook. Esta dirección conecta Bitrix24 con la extensión en Blip, así que guárdala para el paso 4.

Atención: la dirección del webhook funciona como una credencial de acceso. No compartas este enlace públicamente.

Si tienes dudas sobre dónde encontrar esta dirección, consulta el video: 

3. Configura los permisos del webhook

Aún en la configuración del webhook, habilita el permiso CRM (crm) y haz clic en Guardar. Sin este permiso, la extensión no puede crear leads, contactos o empresas en Bitrix24.

4. Conecta Bitrix24 a Blip

En Blip, abre la extensión Bitrix24 en el bot donde se instaló. En el campo Webhook Url (Inbound), pega la dirección copiada de Bitrix24 y haz clic en Guardar. La conexión con tu CRM quedará activa.

5. Instala la extensión de Builder en el navegador

En la pantalla de configuración, haz clic en Instalar extensión. Se abrirá una nueva pestaña en Chrome Web Store.

Haz clic en Usar en Chrome o Agregar a Chrome y, al terminar, regresa a Blip y actualiza la página.

Nota: cada persona que configure las acciones de la extensión en Builder debe instalar esta extensión en su propio navegador.

6. Agrega la integración al flujo

Abre el Builder del bot y haz clic en Agregar bloque > Nueva integración.

Selecciona el nuevo bloque, abre el área de acciones y haz clic en Integración. Después, configura la acción de Bitrix24:

• En Bitrix, elige el tipo de registro: Contacto, Lead o Empresa.

• En Acción, elige la operación (Crear contacto, Crear lead o Crear empresa).

• Completa los campos con valores fijos o variables de Blip.

• En Variable de resultado, indica la variable que guardará el retorno de la operación.

7. Publica y prueba

Guarda el bloque y haz clic en Publicar, en el ícono de cohete. Inicia una conversación de prueba, recorre la ruta del flujo que contiene la integración y verifica en Bitrix24 que se haya creado el lead, contacto o empresa.

Consulta también la variable de retorno configurada en el bloque: muestra el resultado de la operación o los detalles de un posible error.

Ejemplos de uso

Para completar un registro con los datos que el contacto proporcionó en la conversación, usa variables de Blip en los campos de la acción, por ejemplo:

• Nombre: {{contact.name}}

• Teléfono: {{contact.phoneNumber}}

• Correo electrónico: {{contact.email}}

También puedes usar variables creadas en el propio flujo, como {{lead.email}} o {{lead.cidade}}, siempre que ya se hayan completado antes del bloque de integración.

Buenas prácticas

• Prueba primero la integración en un bot o entorno de pruebas.

• Usa la variable de retorno para dar seguimiento al resultado y tratar los errores en el flujo.

• Confirma que se estén enviando los campos obligatorios de Bitrix24.

• Nunca expongas el webhook en mensajes, documentos públicos o capturas de pantalla. Si se filtra, revócalo en Bitrix24 y genera uno nuevo.

Soporte

Si tienes dudas o dificultades con la configuración, contacta al soporte de Wiv por correo electrónico en support@wiv.com.br.

¿Necesitas más ayuda? Explora nuestros contenidos en Blip Academy o Blip Community, mira tutoriales en nuestro canal de YouTube o resuelve tus dudas en nuestro canal de atención 😃