Cómo funciona
Cuando ocurre un evento en tu workspace (un lead capturado, un asistente creado, una conversación finalizada...), Lectico envía un POST firmado a la URL que hayas registrado como webhook. Tu backend verifica la firma, procesa el payload y responde 2xx.
Si tu endpoint tarda más de 10 segundos en responder, o devuelve un 4xx/5xx, Lectico reintenta con backoff exponencial durante 24 horas.
Crear una suscripción
curl -X POST https://api.lectico.com/v1/webhooks \
-H "Authorization: Bearer $LECTICO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://mi-backend.com/webhooks/lectico",
"events": ["lead.captured", "agent.created"]
}'Respuesta:
{
"data": {
"id": "whs_01HZ...",
"url": "https://mi-backend.com/webhooks/lectico",
"events": ["lead.captured", "agent.created"],
"is_active": true,
"secret": "whsec_9f3a...",
"created_at": "2026-04-13T14:12:00Z"
},
"meta": { "request_id": "req_..." }
}El secret se devuelve solo una vez — cuando creas la suscripción. Guárdalo en un gestor de secretos; no hay forma de recuperarlo después. Si lo pierdes, revoca la suscripción y crea una nueva.
Qué hay después
- Eventos disponibles — catálogo completo con payload de cada uno.
- Verificación de firma — cómo validar que el webhook viene de Lectico.
- Entregas y reintentos — política de reintento, inspección desde el panel.