Menú de la documentación

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

  1. En tu CRM o en tu herramienta, crea un webhook de entrada y copia su URL (abajo tienes la guía de cada una).
  2. En DivoChat, abre Integraciones y pega la URL.
  3. En Enviar cuando, deja marcados los avisos que quieras: «Llega un lead nuevo» y «Cambias el estado de un lead».
  4. Activa el interruptor y pulsa Guardar.
  5. 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

HerramientaQué crear
GoHighLevelAutomatizació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.
ZapierUn Zap con Webhooks by Zapier → Catch Hook. Pega la URL que te da.
MakeUn escenario con el módulo Custom webhook. Pega la URL.
n8nUn 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) o checkout («Pagar ya»).
  • status: new, contacted, won o lost. En un cambio de estado, el anterior va en previous_status.
  • Montos: en unidades de la moneda, no en centavos (658700 COP son $658.700). value es null si algún producto no tenía precio, y un formulario llega con items vací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:

CabeceraValor
X-DivoChat-Eventlead.created o lead.status_changed
X-DivoChat-Deliveryigual a event_id
X-DivoChat-Timestampsegundos Unix del envío
X-DivoChat-Signaturesha256= + HMAC-SHA256 del secreto sobre timestamp.cuerpo
x-webhook-secretel 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