WhatsApp + GoHighLevel Integración: Sincroniza datos bidireccionales con Whapi.Cloud

Cómo funciona la integración de WhatsApp y GoHighLevel

Qué datos puedes sincronizar entre WhatsApp y GoHighLevel

• Contactos: número de teléfono de WhatsApp → GHL encuentra o crea un contacto; nombre, apellido y campos personalizados se sincronizan en una dirección (WhatsApp → GHL) o bidireccional si GHL tiene un webhook saliente.
• Mensajes: mensaje entrante de WhatsApp → conversación de GHL creada o actualizada; flujo de trabajo de GHL llega a una acción "enviar mensaje de WhatsApp" → llamada a API de Whapi envía el mensaje de vuelta al cliente.
• Eventos de grupo: miembro se une a grupo de WhatsApp, miembro se va, promoción de miembro → webhook de Whapi se dispara → webhook entrante de GHL activa un flujo de trabajo (etiquétalo, asigna propietario, envía bienvenida, crea tarea).
• Etiquetas y campos personalizados: GHL puede etiquetar contactos basándose en comportamiento de WhatsApp (ej., etiqueta "miembro-grupo-whatsapp"); esas etiquetas pueden activar flujos de trabajo posteriores (secuencias de nutrición, reglas de asignación, filtros de informes).
• Disparadores de flujo de trabajo: cualquier flujo de trabajo de GHL puede escuchar el tipo de evento de webhook entrante y ejecutar acciones basadas en la carga útil (lógica condicional, llamadas API, secuencias de múltiples pasos).

Arquitectura de sincronización bidireccional

ENTRANTE (WhatsApp → Whapi → GHL):

1. Cliente actúa en WhatsApp
   (envía mensaje, se une a grupo, actualiza estado, etc.)

2. Whapi.Cloud recibe el evento
   y dispara un webhook a tu URL de webhook entrante de GHL
   Carga útil: { event, phone, name, group_id, timestamp, ... }

3. Disparador de Webhook Entrante de GHL
   recibe la carga útil JSON
   La valida (verificación de firma opcional)
   Extrae datos: teléfono, nombre, tipo de evento

4. Flujo de trabajo de GHL se ejecuta
   Encuentra o Crea Contacto (por teléfono)
   Agrega Etiquetas (ej., "miembro-grupo-whatsapp")
   Actualiza Campos Personalizados
   Activa flujos de trabajo anidados (envía email, SMS, WhatsApp, asigna propietario)

SALIENTE (GHL → Whapi → WhatsApp):

5. Acción de Flujo de Trabajo de GHL se dispara
   (ej., "Enviar Mensaje de WhatsApp" webhook personalizado)

6. Webhook Personalizado Llama API de Whapi
   POST https://gate.whapi.cloud/messages/text
   Cuerpo: { to: phone, body: message_text }
   Encabezados: Authorization: Bearer YOUR_WHAPI_TOKEN

7. Whapi envía el mensaje a través de WhatsApp
   al número del cliente

8. Cliente recibe el mensaje en WhatsApp
   (sin notificación de aplicación, solo aparece en chat)

9. (Opcional) Webhook de Whapi se dispara de vuelta a GHL
   marcando el mensaje como entregado/leído
   Conversación de GHL se actualiza con estado de entrega
  

Paso 1: Conecta eventos de WhatsApp a GoHighLevel

1. Ve a Flujos de Trabajo → crea un nuevo flujo de trabajo (o abre uno existente).
2. Agrega un Disparador: busca "Inbound Webhook".
3. GHL genera una URL de webhook única: se ve así: https://api.gohighlevel.com/webhooks/[WORKSPACE_ID]/[TRIGGER_ID]
4. Copia esta URL. La pegarás en la configuración de Whapi.

1. Ve a Configuración → Webhooks.
2. Agrega una nueva URL de webhook. Pega la URL de webhook entrante de GHL que copiaste arriba.
3. Selecciona los tipos de evento que deseas recibir:
   • message.created (mensajes entrantes)
   • group.member.joined (eventos de pertenencia a grupo)
   • contact.status_changed (en línea/sin conexión, escribiendo, etc.)
4. Guarda. Whapi probará el webhook enviando un evento de prueba a GHL.
5. Si GHL lo recibe, verás una marca de verificación verde. Si no, verifica que el disparador de flujo de trabajo de GHL esté activo.

Paso 2: Crea y actualiza contactos en GHL desde WhatsApp

1. Agrega una acción: Encuentra o Crea Contacto.
2. Establece el campo de coincidencia en Teléfono.
3. Asigna el número de teléfono de carga útil de webhook entrante al campo de teléfono de contacto.
   • Ruta de carga útil: ${trigger.body.data.phone} (ajusta según la forma de tu carga útil de webhook de Whapi)
4. Si existe un contacto con ese teléfono, GHL lo encuentra. Si no, GHL crea un nuevo contacto con:
   • Teléfono: ${trigger.body.data.phone}
   • Nombre: ${trigger.body.data.name} (opcional; establece un valor predeterminado como "Contacto de WhatsApp" si no se proporciona)

Paso 3: Sincroniza mensajes de WhatsApp con conversaciones de GHL

1. Webhook Personalizado (o "Enviar Solicitud HTTP").
2. Establece método en POST.
3. URL: https://gate.whapi.cloud/messages/text
4. Encabezados:
   • Authorization: Bearer YOUR_WHAPI_TOKEN
   • Content-Type: application/json
5. Cuerpo (JSON):
   • to: número de teléfono del contacto (ej., ${contact.phone})
   • body: texto del mensaje (ej., "Welcome to our group!")

{
  "to": "+1234567890",
  "body": "¡Bienvenido al grupo, Juan! Nos emociona tenerte. Verifica los mensajes fijados para actualizaciones importantes."
}
  

Ejemplo real: Unirse a un grupo de WhatsApp → Flujo en GHL → Mensaje de bienvenida

{
  "event": "group.member.joined",
  "phone": "+1987654321",
  "name": "Sarah Martinez",
  "group_id": "[email protected]",
  "group_name": "Real Estate Team - North Region",
  "timestamp": 1695283200
}
  

1. Disparador: Webhook Entrante recibe el evento group.member.joined.
2. Encuentra o Crea Contacto: Busca por teléfono +1987654321. Sarah es nueva, así que GHL crea un contacto con nombre "Sarah Martinez".
3. Agrega Etiquetas: Agrega "miembro-grupo-whatsapp" y "inmobiliario-región-norte" al contacto de Sarah.
4. Asigna Propietario: Dirige al gerente de la Región Norte (ej., a través de una regla de flujo de trabajo: si la etiqueta = "inmobiliario-región-norte", asigna al propietario "[email protected]").
5. Crea Tarea: "Bienvenido a Sarah al equipo: envía documentos de incorporación".
6. Webhook Personalizado (Enviar WhatsApp): Llama API de Whapi para enviar un mensaje de bienvenida personalizado al número de Sarah.
   • Mensaje: "¡Bienvenida, ${contact.firstName}! Ahora eres parte del Equipo Inmobiliario. Verifica tu email para documentos de incorporación. ¿Preguntas? Responde aquí."
7. Registra Nota: Agrega una nota al contacto de Sarah: "Se unió al grupo de WhatsApp el [fecha]. Flujo de trabajo ejecutado."

Crea más flujos de trabajo en GoHighLevel con eventos de WhatsApp

• Nuevo mensaje de cliente → creación de ticket: el mensaje entrante de WhatsApp activa la creación de un ticket; si no existe un ticket abierto, dirige a cola de soporte y envía respuesta automática: "Recibimos tu mensaje. El soporte responde en 2 horas."
• Flujo de trabajo de abandono de contacto: contacto no activo en WhatsApp durante 30 días → GHL envía mensaje de re-engagement de WhatsApp, seguimiento con email, crea tarea de ventas.
• Actualizaciones de estado de pedido: cliente etiquetado "tiene-pedido-activo" → GHL envía diario de WhatsApp: "Tu pedido se envía mañana. Seguimiento: [URL]."
• Flujo de calificación de lead: nuevo contacto se une a grupo → GHL hace preguntas de calificación a través de WhatsApp → los etiqueta "lead-caliente" o "lead-frío" basado en respuestas → dirige al flujo de trabajo de ventas apropiado.
• Mensajes basados en permiso: campo de contacto "consentimiento-marketing" = verdadero → GHL envía WhatsApp promocional; si falso, solo mensajes transaccionales. Cumplimiento integrado en flujo de trabajo.

Evita problemas de sincronización y eventos duplicados

Lista de verificación para integración WhatsApp + GoHighLevel

• URL de webhook de Whapi está en vivo en GHL: prueba enviando un mensaje de WhatsApp desde otro número; confirma que GHL recibe el webhook entrante (verifica registros de webhook de GHL).
• La coincidencia de contacto funciona: crea un contacto de prueba en GHL con un teléfono conocido, envía un mensaje de WhatsApp desde ese teléfono, confirma que GHL encuentra el contacto existente (no crea uno duplicado).
• Los mensajes salientes de WhatsApp se envían exitosamente: ejecuta la acción "Enviar WhatsApp" webhook en GHL, confirma que el mensaje llega a WhatsApp. Observa errores 401 o 403 (problema de token de auth) y errores 404 (teléfono no conectado en Whapi).
• Los flujos de trabajo son idempotentes: dispara manualmente la misma carga útil de webhook dos veces; confirma que las tareas, etiquetas y mensajes no se duplican.
• El formato del número de teléfono es consistente: todos los números de teléfono en GHL usan el mismo formato (ej., +1234567890 con prefijo +). Verifica consultando unos pocos contactos y comparando con cargas útiles de webhook de Whapi.
• El manejo de errores está en su lugar: el flujo de trabajo de GHL incluye una condición para "si el webhook falla" (ej., token de Whapi expirado, número de WhatsApp no conectado); agrega una acción de respaldo como "enviar SMS" o "registra error y alerta al admin".
• Se respetan los límites de velocidad: si envía 100+ mensajes/hora, espacíalos (agrega retraso de 1 segundo entre envíos en GHL o usa una cola). Monitorea el panel de Whapi para recuentos de llamadas API y advertencias de límite de velocidad de WhatsApp.
• El registro y monitoreo están habilitados: GHL registra cada webhook entrante y acción de mensaje saliente (verifica registros de ejecución de GHL); el panel de Whapi muestra estado de entrega de webhook y confirmaciones de entrega de mensaje.