Lanzamos webhooks en Lia: una forma de recibir notificaciones en tiempo real cuando ocurren eventos importantes en tu chatbot. Conecta Lia con tu CRM, tu herramienta de tickets, Slack, Zapier, o cualquier sistema que uses.

¿Qué son los webhooks?

Los webhooks son notificaciones automáticas que Lia envía a una URL que tú especificas cuando ocurre un evento. En lugar de estar preguntando constantemente "¿ha pasado algo?", Lia te avisa en el momento.

Ejemplo:

Un cliente inicia una conversación en tu chat
Lia envía una notificación a tu CRM
Tu CRM crea automáticamente un registro del cliente
Todo en tiempo real, sin intervención manual

Eventos disponibles

Puedes configurar webhooks para estos eventos:

Eventos de conversación

Evento	Descripción
`conversation.started`	Se inicia una nueva conversación
`conversation.escalated`	La conversación se escala a humano
`conversation.resolved`	La conversación se marca como resuelta
`conversation.abandoned`	El cliente abandona sin resolver

Eventos de mensaje

Evento	Descripción
`message.received`	El cliente envía un mensaje
`message.sent`	Lia envía una respuesta
`message.human`	Un agente humano envía un mensaje

Eventos de sentimiento

Evento	Descripción
`sentiment.negative`	Se detecta sentimiento negativo
`sentiment.positive`	Se detecta sentimiento positivo

Eventos de cliente

Evento	Descripción
`customer.identified`	Se identifica al cliente (email, etc.)
`customer.vip`	Se detecta un cliente VIP

Formato de los webhooks

Cuando ocurre un evento, Lia envía una petición POST a tu URL con un payload JSON:

{
  "event": "conversation.escalated",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "conversation_id": "conv_123abc",
    "customer": {
      "email": "cliente@email.com",
      "name": "María García"
    },
    "reason": "frustration_detected",
    "sentiment": "negative",
    "message_count": 5,
    "last_message": "Necesito hablar con alguien",
    "summary": "Cliente preguntando sobre devolución, frustrado por proceso"
  },
  "metadata": {
    "channel": "web",
    "tenant_id": "tenant_xyz"
  }
}

Casos de uso

1. Sincronizar con CRM (Salesforce, HubSpot, etc.)

Evento: conversation.started + customer.identified

Acción: Crear o actualizar contacto en CRM con datos de la conversación.

Lia detecta email del cliente → Webhook a HubSpot →
HubSpot crea/actualiza contacto con historial de chat

2. Crear tickets automáticamente (Zendesk, Freshdesk, etc.)

Evento: conversation.escalated

Acción: Crear ticket con contexto de la conversación.

Conversación se escala → Webhook a Zendesk →
Zendesk crea ticket con resumen y transcripción

3. Alertas en Slack

Evento: sentiment.negative o conversation.escalated

Acción: Mensaje en canal de Slack.

Cliente frustrado detectado → Webhook →
Mensaje en #soporte-urgente de Slack

4. Automatizaciones con Zapier/Make

Evento: Cualquiera

Acción: Lo que configures en Zapier.

Nuevo cliente identificado → Zapier →
Añadir a lista de email + crear registro en Notion + avisar por SMS

5. Análisis en herramientas de BI

Evento: conversation.resolved

Acción: Enviar datos a BigQuery, Mixpanel, etc.

Conversación resuelta → Webhook →
Datos a BigQuery para análisis avanzado

6. Trigger de campañas de email

Evento: conversation.abandoned + customer.identified

Acción: Iniciar secuencia de recuperación.

Cliente abandona sin resolver → Webhook →
Mailchimp envía email de seguimiento

Cómo configurar webhooks

Paso 1: Accede a la configuración

Ve a Configuración > Integraciones > Webhooks
Haz clic en "Añadir webhook"

Paso 2: Configura el endpoint

URL: La URL donde Lia enviará las notificaciones
Eventos: Selecciona qué eventos quieres recibir
Secreto: Clave para verificar que los webhooks vienen de Lia

Paso 3: Verifica la conexión

Haz clic en "Enviar test"
Verifica que tu endpoint recibe el webhook de prueba
Guarda la configuración

Paso 4: Verifica en producción

Los primeros días, monitoriza que todo funciona:

Revisa los logs de webhooks en Lia
Comprueba que tu sistema recibe los eventos
Verifica que las acciones se ejecutan

Buenas prácticas

1. Verifica la firma

Cada webhook incluye una firma HMAC que debes verificar para asegurar que viene de Lia:

const crypto = require('crypto');

function verifySignature(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(JSON.stringify(payload))
    .digest('hex');
  return signature === `sha256=${expected}`;
}

2. Responde rápido

Tu endpoint debe responder en menos de 5 segundos. Si necesitas hacer procesamiento largo, recibe el webhook, responde 200 OK, y procesa en background.

3. Implementa reintentos

Si tu endpoint falla, Lia reintenta:

1º reintento: 1 minuto después
2º reintento: 5 minutos después
3º reintento: 30 minutos después

Después de 3 fallos, el webhook se marca como fallido y puedes ver el error en los logs.

4. Usa cola de mensajes

Para alto volumen, considera usar una cola (SQS, RabbitMQ) como intermediario para evitar pérdida de eventos.

5. Loguea todo

Guarda logs de los webhooks recibidos para debug y auditoría.

Logs y debugging

En Configuración > Webhooks > Logs puedes ver:

Últimos 100 webhooks enviados
Estado (éxito/fallo)
Payload enviado
Respuesta recibida
Tiempo de respuesta

Usa los logs para debuggear problemas de integración.

Ejemplo con Zapier

Conectar Lia con Zapier es muy sencillo:

En Zapier, crea un nuevo Zap
Trigger: "Webhooks by Zapier" > "Catch Hook"
Copia la URL que te da Zapier
En Lia, añade un webhook con esa URL
Envía un test y verifica que Zapier lo recibe
Configura la acción que quieras en Zapier

Ideas de Zaps:

Conversación escalada → Crear tarea en Asana
Cliente VIP detectado → Notificación SMS
Sentimiento negativo → Crear incidencia en Jira
Nueva conversación → Registro en Google Sheets

Preguntas frecuentes

¿Cuántos webhooks puedo tener? Sin límite. Puedes tener diferentes endpoints para diferentes eventos.

¿Puedo recibir el mismo evento en varios endpoints? Sí, un evento puede disparar múltiples webhooks.

¿Qué pasa si mi endpoint está caído? Lia reintenta 3 veces. Puedes ver los webhooks fallidos en los logs y re-enviarlos manualmente.

¿Los webhooks tienen coste adicional? No, están incluidos en todos los planes.

¿Puedo filtrar qué webhooks recibir? Sí, puedes filtrar por canal (web/WhatsApp), por tema de conversación, etc.

Conclusión

Los webhooks abren un mundo de posibilidades de integración. Conecta Lia con tu stack tecnológico y automatiza flujos que antes requerían trabajo manual.

Empieza con un caso de uso sencillo (alertas en Slack, por ejemplo) y ve añadiendo más integraciones según las necesites.

Configura tu primer webhook: app.hellolia.es > Configuración > Webhooks

Webhooks: conecta Lia con cualquier herramienta