Resumen

La integración de WATI con Bitrix24 permite a las empresas comunicarse sin problemas con los clientes a través de WhatsApp directamente dentro de la plataforma CRM de Bitrix24. Con esta integración, puedes:

Enviar campañas de WhatsApp utilizando plantillas aprobadas por META.
Responder consultas de clientes dentro de Bitrix24.
Asignar mensajes a agentes disponibles.
Crear automáticamente leads o contactos.

Esta guía explica el proceso paso a paso para integrar WATI con Bitrix24.

Instrucciones

Requisitos de Acceso

Debes tener una suscripción activa a WATI Pro o Business Plan.
La integración está disponible exclusivamente para clientes del plan Pro+.

¿Por qué Integrar Bitrix24?

Beneficios Clave

Mensajería de WhatsApp Fluida: Comunícate directamente con los clientes dentro de Bitrix24.
Creación Automática de Leads y Contactos: Crea y actualiza contactos automáticamente según los mensajes entrantes.
Comunicación Centralizada: Todas las interacciones de WhatsApp se almacenan en el CRM de Bitrix24.
Eficiencia Mejorada en el Flujo de Trabajo: Asigna y gestiona conversaciones utilizando los Canales Abiertos de Bitrix24.

Características Clave de la Integración con Bitrix24

Envío de Mensajes de Plantilla de WhatsApp
- Utiliza WATI para enviar mensajes de plantilla aprobados por WhatsApp desde Bitrix24.
- Los mensajes pueden iniciarse desde flujos de trabajo o campañas de marketing.
Mensajería Bidireccional
- Recibe y responde mensajes de servicio directamente desde los Canales Abiertos de Bitrix24.
Integración con CRM
- Los mensajes entrantes se vinculan automáticamente con el lead/contacto relevante en el CRM de Bitrix24.
Integración con Canales Abiertos
- Almacena todas las conversaciones con clientes y asígnalas a múltiples agentes en una cola.
Creación Automática de Contactos
- Los mensajes entrantes activan la creación automática de leads/contactos/negocios.
- Evita entradas duplicadas vinculando mensajes a contactos existentes.

Cómo integrar WATI con Bitrix24

Paso 1: Obtener credenciales API de WATI

Inicie sesión en su cuenta de WATI.
Navegue a Más → Documentación API.
Copie el Token de Acceso y la URL del Endpoint API.

Paso 2: Crear un webhook entrante en Bitrix24

En Bitrix24, vaya a:Menú de Aplicaciones → Recursos para Desarrolladores → Otros → Webhook Entrante → Crear.
Asigne permisos para:
- CRM
- Servicio de Mensajería
- Chat y Notificaciones
Copie la URL del Webhook del campo etiquetado como "Webhook para llamar a la API REST".

Este webhook permitirá la comunicación sin problemas entre WATI y Bitrix24.

Paso 3: Configurar WATI en el Marketplace de Bitrix24

Instalar la aplicación WATI:
- Primero, instale la aplicación WATI desde el Marketplace de Bitrix24. Una vez instalada, acceda a la configuración de la aplicación.
Ingresar detalles de API y Webhook:
- Pegue los siguientes datos en sus campos respectivos:
  - Endpoint API de WATI (copiado en el Paso 1)
  - Token de Acceso (copiado en el Paso 1)
  - URL del Webhook Entrante de Bitrix (copiado en el Paso 2)
- Guarde la configuración una vez completado.

Configuración del Canal Abierto

Para configurar el canal abierto, deberá crear una nueva aplicación en los Recursos para Desarrolladores de Bitrix24. Siga estos pasos:

Iniciar sesión en Bitrix24 como Administrador

Acceda a su aplicación Bitrix24 e inicie sesión como Administrador.
Desde el menú lateral izquierdo, seleccione Recursos para Desarrolladores.

Navegar a Casos de Uso Comunes

En la pestaña Casos de Uso Comunes, desplácese hasta el final de la página.
Haga clic en la opción Otros.

Configurar Aplicación Local

Seleccione la opción Aplicación Local.

En la página de configuración de la aplicación, ingrese los siguientes detalles:
- Ruta del Manejador: https://apps.izaap.in/apps/wat/index2.php
- Ruta de Instalación Inicial: https://apps.izaap.in/apps/wat/install_open_channel.php
- Texto del Elemento del Menú (Inglés - en): Wat Open Channel Application Configuration
Asigne los siguientes permisos:
- Conectores de mensajería externa (imconnector)
- Canales Abiertos (imopenlines)
Haga clic en Guardar al final de la página.

Copiar ID de Cliente y Clave Secreta

Una vez guardada la configuración, copie el ID de Cliente de la Aplicación y la Clave Secreta.
Haga clic en Reinstalar en la misma página para instalar la aplicación. Asegúrese de ver un mensaje de éxito.

Pegar ID de Cliente y Clave Secreta en el Marketplace de WATI

Regrese a la página principal de la aplicación WATI en el Marketplace.
Pegue el ID de Cliente y la Clave Secreta copiados en sus campos respectivos.

Acceder y configurar el Centro de Contacto

Ir a la página del Centro de Contacto
- Navegue a la página del Centro de Contacto: https://<su-dominio>/services/contact_center/.
- Seleccione la conexión de Wati Open Channel.

Conectar y configurar Wati Open Channel
- En el menú desplegable del open channel, seleccione Wati Open Channel y haga clic en Conectar.
- Una vez conectado, puede usar este open channel para:
  - Recibir mensajes de clientes a través de WATI.
  - Responder a los mensajes directamente en el open channel.
Utilizar la opción Configurar en el open channel para ajustar la configuración según sea necesario.
En la página de configuración, seleccione Wati como la fuente de CRM en la lista desplegable de fuentes.

Notas clave

Reemplazar <su-dominio>: Asegúrese de reemplazar <su-dominio> con su dominio real de Bitrix24.
Probar la integración: Después de completar la configuración, pruebe la integración para asegurarse de que los mensajes se transmiten correctamente entre WATI y Bitrix24.

Paso 4: Sincronizar plantillas de WATI con Bitrix24

Abra la aplicación WATI en el Marketplace de Bitrix24.
Haga clic en Sincronizar plantillas para actualizar las plantillas de WATI en Bitrix24.

Paso 5: Enviar mensajes de plantilla mediante Workflow

En el CRM de Bitrix24, vaya a:Workflows → Actividades de aplicación → [Wati API] Enviar mensaje de plantilla.
Ingrese:
- Número de teléfono del cliente
- Nombre de la plantilla de WATI
- Clave y valor del parámetro de la plantilla
Haga clic en Enviar.

Después de enviar el mensaje, la respuesta estará disponible en la sección de resultados adicionales del workflow.

Nota importante sobre las plantillas de WATI:

En las plantillas de WATI, las variables de parámetro se encierran entre llaves {}. Al configurar su workflow:
- Ingrese las variables de parámetro de la plantilla en el campo Clave del parámetro de la plantilla.
- Especifique sus valores correspondientes en el mismo orden en que aparecen en la plantilla de WATI.
Si deja vacíos los campos Clave del parámetro de la plantilla y Valor, el sistema usará automáticamente las claves y valores definidos en la plantilla de WATI.
La respuesta del workflow incluirá detalles como:
- Estado del mensaje
- Número de teléfono del destinatario
- Información de la plantilla de WATI

Paso 6: Enviar campañas de WhatsApp

El envío de campañas masivas por WhatsApp a tus clientes es sencillo con el CRM de Bitrix24. Sigue estos pasos para configurar y lanzar tu campaña:

Acceder al Menú de Marketing

En el CRM de Bitrix24, navega hasta el menú Marketing.
Desde el menú superior, selecciona Campaña.

Seleccionar el Tipo de Campaña

Elige Campaña SMS como tipo de campaña.
Selecciona la plantilla de WhatsApp que deseas utilizar para tu campaña.

Configurar la Campaña

Especifica el tipo de proveedor SMS (elige WATI o tu proveedor preferido).
Crea un segmento objetivo para tu campaña (ej. un grupo específico de clientes).

Ingresar Nombres de Plantillas

En el cuadro de texto del mensaje, ingresa los nombres de las plantillas en este formato: [wati_template, wati_template2]
Puedes copiar los nombres de las plantillas desde la sección Broadcast de tu cuenta WATI y pegarlos aquí.

Programar la Campaña

Guarda los detalles de la campaña.
Selecciona la fecha y hora para enviar tu campaña.

Seguimiento del Estado de Entrega

Después de enviar la campaña, puedes rastrear el estado de entrega en la página Listado de Campañas SMS.

Paso 7: Configurar Webhooks en WATI

Los webhooks son una herramienta poderosa para realizar un seguimiento de los mensajes de clientes entrantes y monitorear el estado de los mensajes enviados en WATI. Al configurar webhooks, puede asegurarse de que su sistema se mantenga actualizado en tiempo real. Revisemos los pasos para configurar webhooks en su cuenta de WATI.

Guía Paso a Paso para Configurar Webhooks

Iniciar sesión en su cuenta de WATI:
Comience iniciando sesión en su cuenta de WATI. Si aún no tiene una cuenta, deberá crear una primero.
Navegar a la configuración de Webhooks:
Una vez que haya iniciado sesión, vaya al menú Más, luego seleccione Webhooks y haga clic en Agregar Webhook.

Ingresar la URL del Webhook:

Necesitará ingresar las siguientes URL de webhook que se proporcionan a continuación. Asegúrese de reemplazar YOUR BITRIX24 DOMAIN con la URL real de su portal de Bitrix24.

URL del Webhook de Mensaje Recibido

https://apps.izaap.in/apps/wati/message_received_webhook_handler.php?DOMAIN=YOUR BITRIX24 DOMAIN

URL del Webhook de Mensaje de Plantilla Enviado/Fallido

https://apps.izaap.in/apps/wati/template_message_delivered_webhook_handler.php?DOMAIN=YOUR BITRIX24 DOMAIN

URL del Webhook de Mensaje de Sesión Enviado

https://apps.izaap.in/apps/wati/message_delivered_webhook_handler.php?DOMAIN=YOUR BITRIX24 DOMAIN

Seleccionar el Tipo de Evento:

Después de ingresar la URL del webhook, elija el tipo de evento apropiado en el menú desplegable. Esto asegura que el webhook se active para las acciones correctas (por ejemplo, mensaje recibido, mensaje enviado, etc.).

Habilitar el Webhook:

Asegúrese de seleccionar la opción Habilitado en el menú desplegable para activar el webhook.

Guardar su configuración:

Una vez que todo esté configurado, haga clic en Guardar para aplicar sus cambios.

Notas Importantes

Reemplazar su Dominio de Bitrix24: No olvide reemplazar YOUR BITRIX24 DOMAIN en las URL de los webhook con la URL real de su portal de Bitrix24. Esto asegura que los webhooks estén correctamente vinculados a su sistema.
Probar sus Webhooks: Después de la configuración, es una buena idea probar los webhooks para asegurarse de que estén funcionando como se espera.

Preguntas Frecuentes (FAQs)

Preguntas Generales

1. ¿Qué es la integración de WATI con Bitrix24?

→ La integración de WATI con Bitrix24 permite a las empresas enviar y recibir mensajes de WhatsApp directamente dentro del CRM de Bitrix24, lo que permite una comunicación fluida con el cliente.

2. ¿Quién puede usar esta integración?

→ Esta integración está disponible para clientes de planes WATI Pro+.

3. ¿Por qué debería integrar WATI con Bitrix24?

→ Ayuda a centralizar la comunicación, automatizar la creación de clientes potenciales/contactos y mejorar la eficiencia del flujo de trabajo mediante la gestión de conversaciones dentro de Bitrix24.

Configuración

4. ¿Cuáles son los requisitos previos para integrar WATI con Bitrix24?

Debe tener una suscripción activa al Plan WATI Pro o Business.
Acceso Bitrix24 con los permisos necesarios.

5. ¿Dónde encuentro mis credenciales de API de WATI?

→ Inicie sesión en su cuenta de WATI, vaya a Más → API Docs y copie el Token de acceso y la URL del punto final de la API.

6. ¿Cómo creo un webhook entrante en Bitrix24?

Navegue a Menú de la aplicación → Recursos para desarrolladores → Otros → Webhook entrante → Crear.
Asigne los permisos necesarios.
Copie la URL del webhook para usarla en WATI.

7. ¿Qué permisos se deben asignar al crear un webhook entrante?

→ Debe otorgar permisos para:

CRM
Servicio de mensajería
Chat y notificaciones

8. ¿Cómo instalo y configuro la aplicación WATI en Bitrix24?

Instale la aplicación WATI desde el Bitrix24 Marketplace.
Ingrese sus detalles de API y webhook en la configuración de la aplicación.
Guarde la configuración.

9. ¿Cómo configuro los Canales Abiertos en Bitrix24 para WATI?

Cree una aplicación local en Recursos para desarrolladores de Bitrix24.
Ingrese el controlador y las rutas de instalación.
Asigne permisos para los conectores de mensajería externa y los Canales Abiertos.
Guarde la configuración y reinstale la aplicación.

10. ¿Dónde ingreso el ID de cliente y la clave secreta?

→ Después de configurar los Canales Abiertos, pegue el ID de cliente y la clave secreta copiados en la configuración de la aplicación WATI Marketplace.

Mensajería de WhatsApp e Integración de CRM

11. ¿Puedo enviar mensajes de WhatsApp desde Bitrix24?

→ Sí, puede enviar mensajes de WhatsApp utilizando plantillas aprobadas por WATI desde flujos de trabajo o campañas de marketing.

12. ¿Cómo se gestionan los mensajes de WhatsApp entrantes en Bitrix24?

→ Los mensajes se vinculan automáticamente al cliente potencial/contacto relevante y se almacenan en los Canales Abiertos de Bitrix24.

13. ¿Los mensajes de WhatsApp nuevos crearán contactos automáticamente?

→ Sí, los mensajes entrantes pueden activar la creación automática de clientes potenciales/contactos, evitando entradas duplicadas.

Mensajes de plantilla y Campañas

14. ¿Cómo sincronizo las plantillas de WATI con Bitrix24?

→ Abra la aplicación WATI en Bitrix24 Marketplace y haga clic en Sincronizar plantillas.

15. ¿Cómo envío mensajes de plantilla a través del flujo de trabajo?

En Bitrix24 CRM, vaya a Flujos de trabajo → Actividades de la aplicación → [Wati API] Enviar mensaje de plantilla.
Ingrese el número de teléfono del cliente y los detalles de la plantilla WATI.
Haga clic en Enviar.

16. ¿Cómo debo formatear los parámetros de la plantilla en los flujos de trabajo?

Use llaves {} para las variables.
Ingrese los parámetros en el mismo orden en que aparecen en la plantilla WATI.
Si se dejan vacíos, se utilizarán las claves y los valores predeterminados de la plantilla.

17. ¿Puedo enviar campañas masivas de WhatsApp desde Bitrix24?

→ Sí, puede enviar campañas a través del Menú de marketing en Bitrix24 CRM.

18. ¿Cómo configuro una campaña de WhatsApp en Bitrix24?

Vaya a Marketing → Campaña.
Seleccione Campaña SMS como el tipo.
Elija WATI como proveedor e ingrese los nombres de las plantillas.
Programe e inicie su campaña.

19. ¿Cómo puedo rastrear la entrega de la campaña de WhatsApp?

→ El estado de entrega está disponible en la página Lista de campañas SMS.

Webhooks y Automatización

20. ¿Qué son los webhooks y por qué debería usarlos?

→ Los webhooks habilitan actualizaciones en tiempo real para los mensajes entrantes y el estado de entrega de los mensajes.

21. ¿Cómo configuro los webhooks en WATI?

Inicie sesión en WATI.
Vaya a Más → Webhooks → Agregar Webhook.
Ingrese las URL de webhook para el mensaje recibido, enviado y el estado de entrega.
Seleccione los tipos de eventos y habilite el webhook.

22. ¿Cómo puedo probar si mis webhooks están funcionando?

→ Después de la configuración, envíe un mensaje de prueba y verifique si los datos se reciben correctamente en Bitrix24.

Integración de Wati con Bitrix24