Bitrix24 CRM ve WhatsApp Entegrasyonu Make.com aracılığıyla

Este flujo crea un contacto en Bitrix24 CRM cuando se recibe un nuevo mensaje de WhatsApp y el contacto con ese número no existe en Bitrix24. El flujo se basa en TimelinesAI Webhooks , integración de Bitrix24 CRM con Make.com, y API REST de Bitrix24 CRM.

Crear un nuevo contacto en Bitrix24 CRM cuando se recibe un nuevo mensaje de WhatsApp

1. Crear un nuevo escenario en Make.com
2. Añadir un módulo Webhook personalizado. Los pasos siguientes requieren datos del webhook presentes. Asegúrate de haber ejecutado el módulo Webhook y tengas datos en el payload
3. Añadir un nuevo módulo Buscar Contactos de Bitrix24: El propósito de este paso es verificar si el contacto ya existe en Bitrix24 CRM o no. La búsqueda se realiza usando el campo Número de Teléfono. Para añadir este módulo haz clic en el icono + junto al módulo Webhooks existente > busca y selecciona Bitrix24 > luego selecciona Buscar Contactos

• Filtro: selecciona Teléfono ; operador: igual . Haz clic en el siguiente campo vacío. Aparecerá una nueva caja a la derecha con datos disponibles del módulo Webhook. Encuentra remitente > teléfono . Puedes hacer clic en el valor encontrado O arrastrarlo y soltarlo en el campo vacío:

• Haz clic en OK
• Haz clic derecho en el módulo Buscar Contactos de Bitrix24 recién creado y selecciona Ejecutar solo este módulo > ingresa cualquier número de teléfono > haz clic en OK. Esto busca contactos en tu Bitrix24 CRM por número de teléfono e indica si existe un contacto con ese número. Los pasos siguientes requieren datos de salida. Asegúrate de haber ejecutado el módulo Buscar Contactos de Bitrix24 y tengas datos en el payload:

6. Añadir el primer Filtro: haz clic en el icono llave inglesa entre el Router y el siguiente módulo vacío > luego haz clic en Configurar un filtro

• Nombra tu filtro El contacto no existe
• Condición: haz clic en el campo. Aparecerá una nueva caja a la derecha con datos disponibles del módulo Buscar Contactos de Bitrix24. Encuentra Número total de paquetes >. Puedes hacer clic en el valor encontrado O arrastrarlo en el campo vacío
• Operadores numéricos: selecciona menor que e ingresa 1 en el siguiente campo:

7. Añadir un nuevo módulo Crear Contacto de Bitrix24: El propósito de este paso es crear un contacto si no fue encontrado por el módulo de búsqueda. Para añadir este módulo haz clic en el icono + junto al filtro existente “El contacto no existe” > busca y selecciona Bitrix24 > luego selecciona Crear Contacto

• Teléfono: se puede mapear con mensaje: remitente: teléfono del webhook de TimelinesAI

• Otros campos: se pueden mapear, dejar vacíos o tener datos personalizados según tus necesidades

Resultado final: El Webhook de TimelinesAI monitorea mensajes de WhatsApp entrantes > busca en Bitrix24 CRM por número de teléfono > si el contacto no se encuentra > crea un nuevo contacto:

Sincronizar nuevos mensajes de WhatsApp en comentarios de tareas en Bitrix24 CRM

Este flujo crea una tarea en Bitrix24 CRM cuando se recibe un nuevo mensaje de WhatsApp, vincula la tarea con el contacto de Bitrix24 CRM correspondiente y añade nuevos mensajes de WhatsApp entrantes como comentarios a la tarea. El flujo se basa en TimelinesAI Webhooks , integración de Bitrix24 CRM con Make.com y API REST de Bitrix24 CRM.

1. Completa primero los pasos de la sección Crear un nuevo contacto en Bitrix24 CRM cuando se recibe un nuevo mensaje de WhatsApp de este artículo. Deberías tener los siguientes módulos en tu escenario para proceder:

2. Añadir un nuevo módulo Realizar Llamada API: El propósito de este módulo es crear una tarea en Bitrix24 CRM y vincular la tarea al contacto de Bitrix24 CRM que fue creado anteriormente en este flujo. Para añadir un nuevo módulo: coloca el cursor sobre el módulo existente Crear contacto y haz clic en + para añadir un nuevo módulo. Busca y selecciona Bitrix24 > luego selecciona Realizar Llamada API

2. Configurar el nuevo módulo Realizar Llamada API:
Conexión: Haz clic en el botón Añadir e ingresa tu URL de Bitrix24 > haz clic en Guardar
URL: tasks.task.add
Método: POST
Headers: añadir un nuevo header con clave = Content-Type y valor= application/json
Body: añadir

{ "fields": { "TITLE": "TimelinesAI_WhatsApp_messages", "UF_CRM_TASK": ["C_YOUR_ID_HERE], "ADD_IN_REPORT": "N", "STATUS":"5", "RESPONSIBLE_ID": "1" }}Nota: los detalles de los parámetros de esta solicitud están disponibles en https://training.bitrix24.com/rest_help/tasks/task/tasks/tasks_task_getFields.php
YOUR_ID_HERE debe reemplazarse con los datos de salida de tu propio módulo Crear contacto.

3. Guarda tus cambios. Haz clic derecho en el módulo recién creado y renómbralo a Llamada API: crear una tarea. Es importante renombrar los módulos correctamente para evitar confusiones a medida que añadas más módulos Realizar Llamada API.

4. Haz clic derecho en el módulo y haz clic en Ejecutar solo este módulo > ingresa el ID del contacto de tu Bitrix24 CRM > haz clic en OK. Para encontrar el ID del contacto en Bitrix24 CRM, abre la Lista de Contactos, selecciona cualquier contacto (preferiblemente un contacto de prueba) y mira la URL de la página en la que desembarques. Por ejemplo, si la URL es https://XXXX.bitrix24.com/crm/contact/details/17/, el ID del contacto es 17. Después de ejecutar el módulo, verifica la página del contacto en Bitrix24 CRM para confirmar que se creó la nueva tarea.

5. Añadir un nuevo módulo Realizar Llamada API: El propósito de este paso es añadir mensajes de WhatsApp recibidos como comentarios a la tarea de Bitrix24 CRM que creaste anteriormente en el flujo. Para añadir el módulo: coloca el cursor sobre el último módulo Llamada API: crear una tarea y haz clic en + para añadir un nuevo módulo. Busca y selecciona Bitrix24 > luego selecciona Realizar Llamada API

6. Configurar el nuevo módulo Realizar Llamada API:

• Conexión: Haz clic en el botón Añadir e ingresa tu URL de Bitrix24 > haz clic en Guardar
• URL: task.commentitem.add
• Método: POST
• Headers: añadir un nuevo header con clave = Content-Type y valor= application/json
• Body: añadir

[YOUR_TASKID_HERE, { "POST_MESSAGE": "YOUR_TIME_HERE message received: YOUR_MESSAGE_TEXT" }]

• YOUR_TASKID_HERE debe reemplazarse con los datos de salida de tu propio módulo Llamada API: crear una tarea.
• YOUR_TIME_HERE y YOUR_MESSAGE_TEXT deben reemplazarse con los datos de salida del módulo webhook original. Puedes incluir datos adicionales en el campo POST_MESSAGE desde tu Webhook si es necesario.

7. Guarda tus cambios. Haz clic derecho en el módulo recién creado y renómbralo a Llamada API: añadir mensaje de WA como comentario a la tarea. Es importante renombrar los módulos correctamente para evitar confusiones cuando añadas más módulos Realizar Llamada API

8. Haz clic derecho en el módulo y haz clic en Ejecutar solo este módulo > ingresa números aleatorios en el campo “Timestamp” > ingresa el ID de la tarea de prueba de tu Bitrix24 CRM > haz clic en OK. Para encontrar el ID de la tarea en Bitrix24 CRM, abre cualquier tarea (preferiblemente una de prueba). Puedes encontrar la tarea creada en Bitrix24 CRM cuando ejecutas los módulos anteriores y usarla para pruebas. Mira la URL de la página en la que desembarques. Por ejemplo, si la URL es https://XXX.bitrix24.com/company/personal/user/1/tasks/task/view/35/XXXX , 35 será el ID de la tarea. Ingresa el texto aleatorio. En modo de producción, el mensaje de WhatsApp recibido se convertirá en el texto. Después de ejecutar el módulo, verifica la página de la tarea en Bitrix24 CRM para confirmar que se añadió el comentario a la tarea:

Resultado intermedio: El Webhook monitorea mensajes de WhatsApp entrantes > busca en Bitrix24 CRM por número de teléfono > si el contacto no se encuentra > crea un nuevo contacto > crea una tarea especial y la vincula al contacto > añade mensajes de WhatsApp recibidos como comentarios a la tarea.

Hasta ahora hemos trabajado en una rama donde el contacto NO existía en Bitrix24 CRM y tuvimos que crearlo, luego crear una tarea y añadir mensajes de WhatsApp como comentarios a esa tarea. En esta sección trabajaremos en una nueva rama del flujo donde el contacto ya existe y solo necesitamos añadir una tarea y comentarios.

1. Añadir un nuevo filtro. Haz clic en el icono llave inglesa entre el Router y el siguiente módulo vacío > luego haz clic en Configurar un filtro (https://storage.crisp.chat/users/helpdesk/website/94268256ba492800/screen-shot-2024-01-16-at-1754_o6wobi.png)

• Nombre tu filtro El contacto existe
• Condición: haz clic en el campo. Aparecerá una nueva caja a la derecha con datos disponibles del módulo Buscar Contactos de Bitrix24. Encuentra Número total de paquetes >. Puedes hacer clic en el valor encontrado O arrastrarlo en el campo vacío
• Operadores numéricos: selecciona mayor o igual a e ingresa 1 en el siguiente campo

2. Añadir un nuevo módulo Realizar Llamada API: El propósito de este paso es encontrar si el contacto existente tiene una tarea donde se almacenan los mensajes de WhatsApp o no. Para añadir un módulo haz clic en el signo + después del último filtro creado > busca y selecciona Bitrix24 > luego selecciona Realizar Llamada API

3. Configurar el nuevo módulo Realizar Llamada API:

• Conexión: Haz clic en el botón Añadir e ingresa tu URL de Bitrix24 > haz clic en Guardar
• URL: tasks.task.list.json?order[CREATED_DATE]=desc&filter[UF_CRM_TASK]=C_YOUR_CONTACT_ID_HERE&[TITLE]=TimelinesAI_WhatsApp_Messages
• Método: GET
• Headers: añadir un nuevo header con clave = Content-Type y valor= application/json
• Body: vacío
• YOUR_CONTACT_ID_HERE debe reemplazarse con los datos de salida de tu propio módulo Buscar Contactos.

4. Guarda tus cambios. Haz clic derecho en el módulo recién creado y renómbralo a Llamada API: buscar tareas. Es importante renombrar los módulos correctamente para evitar confusiones cuando añadas más módulos Realizar Llamada API.

5. Haz clic derecho en el módulo y haz clic en Ejecutar solo este módulo > ingresa el ID del contacto de tu Bitrix24 CRM > haz clic en OK. Para encontrar el ID del contacto en Bitrix24 CRM, abre la Lista de Contactos, selecciona cualquier contacto (preferiblemente un contacto de prueba) y mira la URL de la página en la que desembarques. Por ejemplo, si la URL es https://XXXX.bitrix24.com/crm/contact/details/17/, el ID del contacto es 17.

6. Añadir un nuevo módulo Router de Control de Flujo: El propósito de este paso es dividir el flujo en 2 ramas más: 1- si el módulo de búsqueda de tareas encontró la tarea, 2- si el módulo de búsqueda no encontró la tarea. Para añadir el módulo Router haz clic en el icono + junto al módulo existente Llamada API: buscar tareas > busca y selecciona Control de Flujo > luego selecciona Router.

7. Añadir un Filtro: haz clic en el icono llave inglesa entre el Router y el siguiente módulo vacío > luego haz clic en Configurar un filtro!

• Nombre tu filtro Si la tarea existe
• Condición: haz clic en el campo. Aparecerá una nueva caja a la derecha con datos disponibles del módulo Llamada API: buscar tareas. Encuentra Body > Total >. Puedes hacer clic en el valor encontrado O arrastrarlo en el campo vacío
• Operadores numéricos: selecciona igual a e ingresa 1 en el siguiente campo:

8. Añadir un nuevo módulo Realizar Llamada API: El propósito de este paso es añadir mensajes de WhatsApp recibidos como comentarios a la tarea de Bitrix24 CRM encontrada. Para añadir este módulo haz clic en el icono + junto al filtro existente “Si la tarea existe” > busca y selecciona Bitrix24 > luego selecciona Realizar Llamada API

9. Configurar el nuevo módulo Realizar Llamada API:

• Conexión: Haz clic en el botón Añadir e ingresa tu URL de Bitrix24 > haz clic en Guardar
• URL: task.commentitem.add
• Método: POST
• Headers: añadir un nuevo header con clave = Content-Type y valor= application/json
• Body: añadir

[YOUR_TASKID_HERE, {
"POST_MESSAGE": "YOUR_TIME_HERE message received: YOUR_MESSAGE_TEXT"
}
]

• YOUR_TASKID_HERE debe reemplazarse con los datos de salida de tu módulo Llamada API: buscar tareas .
• YOUR_TIME_HERE y YOUR_MESSAGE_TEXT deben reemplazarse con los datos de salida del módulo webhook original. Puedes incluir datos adicionales en el campo POST_MESSAGE desde tu Webhook si es necesario.

10. Haz clic derecho en el módulo recién creado y renómbralo a “Llamada API: añadir mensaje de WA como comentario a la tarea”

11. Guarda tus cambios y añadir un 2º Filtro:

• Nombre tu filtro Si la tarea no existe
• Condición: haz clic en el campo. Aparecerá una nueva caja a la derecha con datos disponibles del módulo Llamada API: buscar tareas. Encuentra Body > Total >. Puedes hacer clic en el valor encontrado O arrastrarlo en el campo vacío
• Operadores numéricos: selecciona menor que e ingresa 1 en el siguiente campo:

11. Añadir un nuevo módulo Realizar Llamada API: El propósito de este módulo es crear una tarea en Bitrix24 CRM y vinclar la tarea al contacto de Bitrix24 CRM existente. Para añadir este módulo haz clic en el icono + junto al filtro existente “Si la tarea no existe” > busca y selecciona Bitrix24 > luego selecciona Realizar Llamada API

12. Configurar el nuevo módulo Realizar Llamada API:

• Conexión: Haz clic en el botón Añadir e ingresa tu URL de Bitrix24 > haz clic en Guardar
• URL: tasks.task.add
• Método: POST
• Headers: añadir un nuevo header con clave = Content-Type y valor= application/json
• Body: añadir

{ "fields": {
"TITLE": "TimelinesAI_WhatsApp_messages",
"UF_CRM_TASK": ["C_YOUR_ID_HERE],
"ADD_IN_REPORT": "N",
"STATUS":"5",
"RESPONSIBLE_ID": "1"