Go High Level

Descripción #

El Go High Level Trigger permite iniciar automatizaciones de Spoki cuando los workflows de Go High Level (GHL) envían datos a Spoki mediante webhooks.

Úsalo para la dirección GHL → Spoki: te permite activar automatizaciones de WhatsApp a partir de eventos generados en GHL (por ejemplo, envío de formularios, cambios de etapa en el pipeline o acciones de campaña), creando una integración bidireccional junto con el Go High Level Integration Step.

🎯 Visión General #

El Go High Level Trigger permite iniciar automatizaciones de Spoki cuando los workflows de Go High Level (GHL) envían solicitudes webhook.

Con este trigger puedes:

• 🔔 Recibir datos desde GHL – Iniciar automatizaciones de Spoki cuando un workflow de GHL envía un webhook
• 📞 Identificar contactos – Asociar los datos recibidos con contactos en Spoki (por ejemplo, mediante el número de teléfono)
• 🔄 Crear una integración bidireccional – Combinarlo con el Go High Level Integration Step (Spoki → GHL) para flujos en ambos sentidos
• 📊 Sincronizar campos personalizados – Completar los campos de contacto con datos provenientes de GHL
• ⚡ Activar flujos en tiempo real – Iniciar automatizaciones de WhatsApp a partir de eventos en GHL (envío de formulario, cambio de etapa, etiqueta añadida, etc.)

💡 Cuándo usarlo #

Utiliza este trigger cuando necesites:

Caso de uso	Ejemplo
Formulario GHL → WhatsApp	Iniciar una automatización de Spoki cuando un contacto envía un formulario en GHL
Cambio de etapa en pipeline	Enviar un mensaje de WhatsApp cuando una oportunidad pasa a una etapa específica
Evento de campaña o secuencia	Activar Spoki cuando un contacto entra o sale de una campaña en GHL
Workflows basados en etiquetas	Iniciar automatizaciones cuando se añade una etiqueta a un contacto en GHL
Calendario o reserva	Activar un seguimiento cuando se agenda una cita en GHL
Actualizaciones del CRM	Ejecutar flujos en Spoki cuando cambian datos de contacto u oportunidad en GHL

✅ Requisitos Previos #

Antes de usar el Go High Level Trigger, asegúrate de:

1. Tener una cuenta en Go High Level – Con acceso a workflows/automatizaciones
2. Crear una automatización en Spoki – Que será iniciada por el trigger
3. Obtener la URL del webhook – Disponible en la configuración del trigger en Spoki
4. Conocer la estructura del payload – Saber qué datos debe enviar GHL (por ejemplo, el teléfono para identificar el contacto)

⚠️ Nota: La disponibilidad del trigger y los detalles del endpoint pueden depender de la configuración de tu cuenta Spoki. Si no ves el Go High Level Trigger, contacta con tu administrador de Spoki.

⚙️ Configuración #

Paso 1: Añadir el Go High Level Trigger #

En el editor de automatizaciones de Spoki:

1. Crea una nueva automatización (o edita una existente)
2. En la sección Trigger, haz clic en Seleccionar Trigger
3. Elige Go High Level en la lista de integraciones

Paso 2: Copiar la URL del Webhook y el Secret #

La configuración del trigger muestra:

• Webhook URL – URL única que GHL utilizará para iniciar la automatización
• Secret / Token (si aplica) – Para autenticar las solicitudes enviadas desde GHL

Copia estos valores; los necesitarás en tu workflow de GHL.

Paso 3: Configurar el Workflow en GHL #

En Go High Level:

1. Crea o edita el workflow que debe iniciar la automatización en Spoki
2. Añade una acción Webhook (o solicitud HTTP) hacia la URL del webhook de Spoki
3. Configura:
   • Método: POST
   • Content-Type: application/json
4. Construye el body de la solicitud con los campos requeridos (ver sección Payload)

Paso 4: Probar el Trigger #

Antes de activarlo en producción:

1. Ejecuta el workflow de GHL con datos de prueba
2. Verifica que la automatización en Spoki se inicie correctamente
3. Confirma que el contacto se identifica y que los campos personalizados se completan según lo esperado

🔧 Configuración del Webhook #

Flujo: GHL → Spoki #

• El workflow en GHL se activa (por ejemplo, envío de formulario, cambio de etapa o cita programada)
• GHL envía una solicitud HTTP POST a la URL webhook de Spoki con datos del contacto y campos personalizados
• Spoki valida la solicitud e inicia la automatización para el contacto identificado

Requisitos #

• El workflow en GHL debe enviar un JSON válido con al menos el dato necesario para identificar al contacto (por ejemplo, el teléfono)
• La URL webhook debe utilizarse exactamente como se proporciona
• Si se requiere un secret, debe incluirse en la solicitud según lo indicado en la configuración del trigger

📦 Payload de la Solicitud #

Spoki espera un payload en formato JSON enviado desde GHL. Estructura típica:

{
  "phone": "+393491234567",
  "first_name": "Mario",
  "last_name": "Rossi",
  "email": "mario.rossi@example.com",
  "custom_fields": {
    "LEAD_SOURCE": "GHL Form",
    "CAMPAIGN_ID": "abc123"
  }
}

Campos principales #

Campo	Tipo	Descripción
phone	string	Teléfono en formato E.164; utilizado para identificar al contacto
first_name	string	Nombre (opcional)
last_name	string	Apellido (opcional)
email	string	Correo electrónico (opcional)
custom_fields	object	Pares clave-valor para campos personalizados

Los campos requeridos pueden variar según la configuración actual de Spoki.

👤 Identificación del Contacto #

El trigger utiliza el payload recibido para buscar o crear el contacto en Spoki:

• Teléfono – Identificador principal (se recomienda formato E.164)
• Si el contacto no existe, Spoki puede crearlo según la configuración
• Los campos personalizados enviados pueden guardarse y utilizarse dentro de la automatización

📝 Ejemplos #

Ejemplo 1: Envío de Formulario → Mensaje de Bienvenida en WhatsApp #

Escenario: Cuando alguien envía un formulario en GHL, se inicia una automatización en Spoki que envía un mensaje de bienvenida por WhatsApp.

Resultado: El contacto recibe automáticamente un mensaje de WhatsApp.

Ejemplo 2: Cambio de Etapa → Notificación por WhatsApp #

Escenario: Cuando una oportunidad pasa a la etapa “Propuesta Enviada”, se activa una automatización en Spoki.

Resultado: El contacto recibe un mensaje de WhatsApp relacionado con la propuesta.

Ejemplo 3: Integración Bidireccional #

Escenario:

1. Spoki → GHL: Spoki envía el contacto a GHL mediante el Integration Step
2. GHL → Spoki: Un evento en GHL llama al webhook del trigger
3. Spoki inicia un nuevo flujo de WhatsApp

Resultado: Flujo completo y sincronizado entre WhatsApp y GHL.

✅ Buenas Prácticas #

1. Utiliza siempre el formato E.164 para los números de teléfono
2. Mantén privada la URL del webhook y cualquier secret
3. Realiza pruebas con un solo contacto antes de escalar
4. Alinea los nombres de los campos personalizados entre GHL y Spoki
5. Configura manejo de errores o reintentos en GHL si el webhook falla

❓ Preguntas Frecuentes #

¿Cuál es la diferencia entre el Trigger y el Integration Step? #

• Go High Level Trigger: GHL → Spoki (inicia automatizaciones en Spoki)
• Go High Level Integration Step: Spoki → GHL (envía datos a GHL)

¿El Trigger funciona sin el Integration Step? #

Sí. Puede utilizarse de forma independiente.

¿Qué sucede si el contacto no existe? #

Depende de la configuración de Spoki: puede crearse automáticamente o rechazarse la solicitud.

¿Puede un workflow de GHL activar varias automatizaciones de Spoki? #

Cada automatización tiene su propia URL webhook. Para activar varias, debes llamar cada URL por separado.

No veo el Go High Level Trigger en mi cuenta #

La disponibilidad puede depender del plan o la configuración. Contacta con tu administrador de Spoki.