Webhook API — Integración con Zapier, Make y n8n

Webhook API — Chat IA V4

El Webhook API permite enviar eventos del Chat IA a una URL externa cada vez que ocurre algo importante: un lead capturado, un handoff a humano, o un sentimiento negativo detectado.

Es compatible con Zapier, Make (Integromat), n8n, o cualquier servicio que acepte POST HTTP con JSON.

¿Cómo configurarlo?

1. Ve a tu sitio → pestaña Chat IA → sección Webhook API
2. Ingresa la URL del webhook (ejemplo: https://hooks.zapier.com/hooks/catch/123456/abcdef/)
3. Selecciona los eventos que deseas enviar:
   • ι Lead capturado — cuando se detecta un email o teléfono en la conversación
   • ι Handoff humano — cuando el visitante solicita hablar con una persona
4. Haz clic en Guardar

Formato del payload JSON

Cada evento envía un POST con el siguiente formato:

{
  "event": "lead_captured",
  "site_url": "https://tusitio.com",
  "site_name": "Mi Tienda Online",
  "timestamp": "2026-03-26T17:00:00Z",
  "data": {
    "visitor_message": "Mi email es juan@email.com",
    "bot_response": "Perfecto Juan, te contactaremos pronto",
    "visitor_url": "https://tusitio.com/contacto",
    "session_id": "a1b2c3d4",
    "sentiment": "positive",
    "intent": "contact",
    "lead_email": "juan@email.com",
    "lead_phone": null,
    "lead_name": "Juan"
  }
}

Eventos disponibles

Configurar en Zapier

1. En Zapier, crea un nuevo Zap con trigger "Webhooks by Zapier" → "Catch Hook"
2. Copia la URL generada (empieza con https://hooks.zapier.com/...)
3. Pégala en el campo "URL del Webhook" en WPGenial
4. Envía un mensaje de prueba en tu Chat IA para que Zapier detecte el formato
5. Configura la acción: crear contacto en Google Sheets, HubSpot, Mailchimp, etc.

Configurar en Make (Integromat)

1. Crea un nuevo escenario con módulo "Webhooks" → "Custom webhook"
2. Copia la URL generada
3. Pégala en WPGenial
4. Haz clic en "Run once" en Make, luego envía un mensaje de prueba en el Chat IA
5. Make detectará automáticamente la estructura del JSON

Detalles técnicos

• Método: POST
• Content-Type: application/json
• Timeout: 5 segundos (si tu servidor no responde, se reintenta 1 vez)
• Reintentos: 1 reintento en caso de fallo (total 2 intentos)
• Ejecución: Asíncrona — no afecta el tiempo de respuesta del chat
• Seguridad: Solo se envían los eventos que hayas habilitado en la configuración

Probar tu webhook

Para verificar que todo funciona:

1. Usa webhook.site como URL temporal de prueba
2. Configúrala en WPGenial con todos los eventos activados
3. Abre tu sitio en modo incógnito y chatea con el bot
4. Envía un mensaje con un email (ej: "mi correo es test@email.com")
5. Verifica en webhook.site que llegó el evento lead_captured