Integraciones: tus leads a tu CRM
Envía cada lead a GoHighLevel, Zapier, Make, n8n o cualquier herramienta que reciba webhooks, con su origen completo.
En la app, Integraciones envía cada lead a tu CRM o a tu herramienta de automatización en cuanto llega, con sus datos, sus productos, el valor y la campaña que lo trajo. Está en el menú, debajo de «Leads y cotizaciones».
Conectar tu CRM
- En tu CRM o en tu herramienta, crea un webhook de entrada y copia su URL (abajo tienes la guía de cada una).
- En DivoChat, abre Integraciones y pega la URL.
- En Enviar cuando, deja marcados los avisos que quieras: «Llega un lead nuevo» y «Cambias el estado de un lead».
- Activa el interruptor y pulsa Guardar.
- Pulsa «Enviar lead de prueba»: llega un lead inventado a tu herramienta y la pantalla te dice si se recibió.
La URL debe empezar por https:// y ser un dominio público. Si no lo es, la pantalla te dice exactamente qué está mal.
Guía por herramienta
| Herramienta | Qué crear |
|---|---|
| GoHighLevel | Automatización → Workflows → disparador Inbound Webhook. Copia su URL, envía el lead de prueba y mapea los campos (first_name, phone, email, utm_source…). En algunos planes es un disparador de pago: revisa el tuyo. |
| Zapier | Un Zap con Webhooks by Zapier → Catch Hook. Pega la URL que te da. |
| Make | Un escenario con el módulo Custom webhook. Pega la URL. |
| n8n | Un nodo Webhook con método POST. Usa la URL de producción, no la de prueba. |
HubSpot, Kommo, Pipedrive, Clientify o Google Sheets se conectan a través de Zapier, Make o n8n.
Cuándo avisa
- Lead nuevo (
lead.created): cuando el cliente llena el formulario, envía una cotización o inicia un pago con «Pagar ya». - Cambio de estado (
lead.status_changed): cuando mueves un lead en «Leads y cotizaciones». Llega el estado nuevo y el anterior.
El envío sale del servidor de la app en el momento: no frena al cliente en tu tienda. Los leads que ya tenías antes de activarla no se envían; los puedes exportar a CSV.
Qué recibe tu CRM
Un POST con un JSON plano: todo va al primer nivel salvo la lista de productos (items). Los campos vacíos llegan como null, nunca se omiten. Un ejemplo, con datos inventados:
{
"event": "lead.created",
"event_id": "dlv_3f9c…",
"test": false,
"lead_type": "quote",
"status": "new",
"previous_status": null,
"name": "Laura Gómez", "first_name": "Laura", "last_name": "Gómez",
"phone": "+573001234567", "email": "laura@ejemplo.com",
"company": "Seguridad SAS", "city": "Barranquilla", "note": null,
"page_url": "https://tienda.com/products/radio-r7",
"value": 658700, "currency": "COP",
"items": [
{ "title": "Radio R7", "variant": "UHF", "quantity": 3, "unit_price": 189900, "subtotal": 569700 }
],
"items_text": "• 3 × Radio R7 (UHF)\n• 1 × Bodycam",
"utm_source": "meta", "utm_medium": "cpc", "utm_campaign": "b2b",
"first_utm_source": "google", "first_utm_medium": "cpc", "first_utm_campaign": "busqueda",
"gclid": null, "fbclid": "IwAR…",
"landing_page": "https://tienda.com/?utm_source=meta&utm_medium=cpc",
"referrer": "https://l.facebook.com/",
"device": "mobile"
}
lead_type:form(formulario),quote(cotización) ocheckout(«Pagar ya»).status:new,contacted,wonolost. En un cambio de estado, el anterior va enprevious_status.- Montos: en unidades de la moneda, no en centavos (658700 COP son $658.700).
valueesnullsi algún producto no tenía precio, y un formulario llega conitemsvacío. phone: en formato internacional (+y dígitos), como lo piden GoHighLevel y HubSpot.items_text: la lista de productos ya escrita, para pegarla en una nota.- Origen: el último contacto (
utm_*), el primero (first_utm_*), los IDs de clic (gclid,gbraid,wbraid,fbclid,ttclid,msclkid), la página de entrada, el sitio del que llegó y el dispositivo. event_id: único por envío. Úsalo para descartar duplicados: el orden de llegada no está garantizado.
Últimos envíos y reintentos
La pantalla muestra los 50 envíos más recientes con su fecha, el evento, el estado (Enviado, Reintentando o Fallido), el código de respuesta y los intentos.
- Tu herramienta debe responder con un código 2xx en 8 segundos o menos. Las redirecciones (3xx) cuentan como fallo.
- Si falla, DivoChat reintenta solo al minuto, a los 10 minutos y a la hora. Después de 4 intentos queda Fallido.
- «Reintentar» lo vuelve a enviar desde cero.
- Los envíos se borran del registro a los 30 días.
Comprobar que viene de DivoChat
Al guardar la URL se crea un secreto, que se guarda cifrado y puedes copiar o regenerar (el anterior deja de servir). Cada envío lleva estas cabeceras:
| Cabecera | Valor |
|---|---|
X-DivoChat-Event | lead.created o lead.status_changed |
X-DivoChat-Delivery | igual a event_id |
X-DivoChat-Timestamp | segundos Unix del envío |
X-DivoChat-Signature | sha256= + HMAC-SHA256 del secreto sobre timestamp.cuerpo |
x-webhook-secret | el secreto, para las herramientas que no pueden verificar firmas |
Si programas tu propio receptor, verifica la firma así (Node) y rechaza los timestamps de más de 5 minutos:
const crypto = require('crypto');
function verificar(secreto, req, cuerpoCrudo) {
const ts = req.headers['x-divochat-timestamp'];
const esperada = 'sha256=' + crypto.createHmac('sha256', secreto).update(ts + '.' + cuerpoCrudo).digest('hex');
return crypto.timingSafeEqual(Buffer.from(esperada), Buffer.from(req.headers['x-divochat-signature'] || ''));
}
Privacidad
El webhook envía datos personales del lead a la URL que tú eliges: usa solo herramientas de confianza. Si un cliente pide a Shopify que borre sus datos, DivoChat borra sus leads y sus envíos; si desinstalas la app, se borran todos los envíos.
¿Algo no funciona como dice esta guía? Escríbenos a soporte@divochat.com