Cómo crear una Automatización Personalizada con Webhook para integrar Cliengo con otro CRM

⚠️ Importante: Esta integración requiere conocimientos técnicos sobre APIs y Webhooks. Es necesario conocer la documentación del CRM que deseas conectar, ya que cada plataforma define su propia URL, método, autenticación y estructura de los datos que espera recibir.

Antes de comenzar

Asegúrate de contar con los siguientes datos de tu CRM o plataforma de destino:

• La URL del Webhook o endpoint de la API.
• El método HTTP requerido (generalmente POST).
• Los datos de autenticación necesarios (Bearer Token, API Key, etc.).
• La documentación de la API para conocer: los nombres de los campos que espera recibir, el formato del JSON y los encabezados (Headers) requeridos.

Paso a paso para configurar el Webhook

Paso 1. Crear una Automatización Personalizada

Desde tu panel de Cliengo, ingresa a Automatizaciones → Personalizadas.

Crea una nueva automatización y configura el disparador. Para este ejemplo, utilizaremos el disparador Nueva conversación.

Paso 2. Agregar una espera (Recomendado)

Como el disparador ocurre apenas inicia una conversación, es muy recomendable agregar un paso de Esperar.

• Tiempo sugerido: 1 minuto (puedes configurarlo según tus necesidades).

Esto permite que el visitante tenga tiempo de completar sus datos de contacto (nombre, teléfono, email) en el chat antes de enviarlos al CRM.

Paso 3. Obtener la conversación

Agrega el paso Obtener conversación.

Este paso recupera toda la información disponible de la conversación para que pueda utilizarse posteriormente en el Webhook, incluyendo las variables del visitante y el historial del chat.

Paso 4. Configurar el Webhook

Agrega un nuevo paso de tipo Webhook y completa los siguientes datos:

1. URL del Webhook y Método

Ingresa la URL proporcionada por tu CRM o sistema externo y selecciona el método solicitado por la API (en la mayoría de los casos será POST).

• Ejemplo de URL: [https://api.midominio.com/contacts](https://api.midominio.com/contacts)

2. Headers (Encabezados)

Si la API requiere autenticación, agrega los encabezados correspondientes. Cada CRM puede requerir distintos encabezados, por lo que deberás consultar su documentación.

3. Configurar el Body

En la sección Body deberás indicar qué información enviar al CRM. Cada registro tiene dos columnas:

• Campo: El nombre del atributo que espera recibir el CRM.
• Valor: La variable de Cliengo que contiene la información correspondiente.

Nota sobre el Body: Los nombres de los campos dependen exclusivamente del CRM que estés integrando y deben coincidir exactamente con los definidos en su documentación. A medida que completes los campos y valores, Cliengo generará automáticamente el JSON correspondiente en la vista previa.

Paso 5. Guardar, probar y verificar

Una vez finalizada la configuración:

1. Haz clic en Guardar.
2. Ejecuta una prueba de la automatización.
3. Verifica en tu CRM que la información se haya recibido correctamente.

¿Algún dato no llega correctamente? Revisa lo siguiente:

• La URL del Webhook.
• Los Headers configurados.
• Los nombres de los campos enviados.
• Las variables de Cliengo utilizadas.
• La respuesta de la API del CRM.

Resumen: Ejemplo de flujo recomendado

Para garantizar que la automatización cuente con la información más completa posible, este es el flujo ideal a seguir:

1. Nueva conversación (Disparador)
2. Esperar (1 minuto)
3. Obtener conversación
4. Webhook

📌 Aclaración final: La configuración del Webhook puede variar según el CRM con el que desees integrarte. Cliengo únicamente envía la información configurada; la validación de los campos, la autenticación y el procesamiento dependen exclusivamente del sistema receptor.

¿Tienes dudas o necesitas asistencia con esta configuración? Escríbenos a hola@cliengo.com y con gusto te ayudaremos.