la forma más rápida es usar make o n8n como receptor. si eres developer, un endpoint propio te da máximo control.
-
01
configura un webhook outbound desde ghl workflows
en ghl: Automation → Workflows → crea o edita workflow → agrega action "Webhook" → ingresa la URL del endpoint destino. configura: método HTTP (POST), headers (Content-Type: application/json), body (puedes mapear campos de ghl como variables). el workflow envía el webhook cada vez que el trigger se cumple.
tip: usa webhook.site o requestbin.com para hacer pruebas — crea un endpoint temporal que muestra todos los webhooks que recibe. así puedes ver exactamente qué payload envía ghl antes de conectar tu sistema real.
-
02
configura un webhook inbound en ghl
en ghl: Settings → Integrations → Webhooks → crea nuevo webhook inbound. ghl te da una URL única por sub-cuenta. cualquier sistema externo puede hacer POST a esa URL con datos en JSON y ghl los procesa — crea o actualiza el contacto, dispara un workflow. útil para conectar sistemas que no tienen integración nativa con ghl.
tip: el webhook inbound de ghl acepta campos estándar: firstName, lastName, email, phone, tags, source, customFields. mapea los campos de tu sistema externo a esta estructura en el payload que envías.
-
03
conecta make o n8n como intermediario
para procesar webhooks de ghl con lógica antes de enviar a otro sistema: ghl → webhook outbound → make/n8n (procesa, filtra, transforma) → sistema destino. en make: crea escenario con trigger "Webhooks > Custom Webhook" → copia la url de make → ponla en ghl. en n8n: crea workflow con nodo "Webhook" → copia la url → configura en ghl.
tip: usa make o n8n como intermediario cuando necesitas lógica entre ghl y el sistema destino: filtrar ciertos tipos de contacto, transformar el formato de los datos, llamar a varias apis con un solo evento de ghl.
-
04
implementa un endpoint propio (para developers)
si tienes desarrollador, puedes crear tu propio endpoint: servidor node.js/python/php que recibe el POST de ghl, valida la firma HMAC en el header X-GHL-Signature, y ejecuta la lógica que necesites. esta es la opción más flexible — sin dependencias de terceros, sin costo de plataforma, máximo control sobre el payload.
tip: para endpoints de producción, implementa: 1) validación HMAC de la firma, 2) idempotencia (si ghl reenvía el mismo webhook dos veces, no procesar dos veces), 3) respuesta HTTP 200 inmediata + procesamiento asíncrono (evita timeout de ghl si el procesamiento es lento).
-
05
monitorea errores y reintentos
ghl reintenta el webhook si tu endpoint no responde con HTTP 200 en tiempo. configura alertas en tu endpoint para detectar errores. en make o n8n: el historial de ejecuciones muestra cada webhook recibido y si el flujo corrió correctamente. para endpoints propios, loguea cada webhook recibido con timestamp y resultado del procesamiento.
tip: ghl tiene un máximo de reintentos para webhooks fallidos. si tu endpoint estuvo caído por más de ese tiempo, los webhooks se pierden — no recuperas el evento retroactivamente. para datos críticos, considera también hacer polling periódico de la api de ghl como backup.