Añade una dirección https en Integraciones → Webhooks y notificaciones para recibir eventos de llamada:
| Evento | Cuándo |
|---|---|
call.started | El agente contestó |
call.ended | La llamada terminó, con su duración y créditos |
call.analyzed | El resumen, el resultado, los campos extraídos y la transcripción están listos |
call.transcript | Durante la llamada, las líneas nuevas de la transcripción cada pocos segundos |
call.tool_called | El agente llamó a una de tus funciones: name, arguments, status, durationMs |
call.handed_off | La llamada se pasó a otro agente: fromAgentId, toAgentId |
call.transferred | La llamada se transfirió a una persona: destination |
call.recording_ready | La grabación de dos canales está almacenada: recordingUrl (válido 24 horas), durationMs |
call.message_sent | El agente mostró tarjetas en la pantalla de quien llama por web o app: items, quickReplies |
call.message_status | Lo que el operador informó al final sobre un SMS que envió el agente: status (delivered, failed o unconfirmed), reason |
alert.triggered | Una de tus alertas (Webhooks y notificaciones → Alertas) superó su umbral |
alert.resolved | Esa alerta ha vuelto a la normalidad |
conversation.created | Empezó una conversación en la bandeja de entrada: conversation |
conversation.message | Se añadieron mensajes a una conversación: conversation, messages (role, content, via) |
conversation.updated | Una conversación cambió de responsable o de estado (también resuelta): conversation, changes |
conversation.needs_human | Una conversación espera a un miembro del equipo: conversation, reason |
conversation.closed | Se resolvió una conversación: conversation |
conversation.unanswered_timeout | Una conversación esperó a tu equipo tanto como permite un flujo «El equipo no ha respondido»: conversation, minutes |
contact.created | Se añadió un cliente nuevo: contact_id |
contact.updated | Cambiaron los datos de un cliente: contact_id, fields |
contact.consent_changed | Cambió el consentimiento de un cliente: contact_id, kind, status, source |
contact.merged | Se unieron dos clientes: contact_id (el que se conserva), from_id |
appointment.created | Se hizo una reserva en el calendario, por el agente, tu equipo, la API o un formulario de reservas (status booked o waitlisted): appointment |
appointment.updated | Cambió el estado, las notas o el servicio de una cita: appointment, previous_status |
workflow.webhook | Un flujo de trabajo llegó a un paso Enviar al webhook: name, workflow, conversation, contact, answers |
Los eventos enviados durante una llamada llevan data.call (id, agentId, channel, direction, números). Cada solicitud va firmada:
EvaSay-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<raw body>">
EvaSay-Delivery: <delivery id>
Verifica la firma con el secreto del webhook que se mostró al crearlo, y responde con un estado 2xx. Las entregas fallidas se reintentan tras 1 minuto, 5 minutos, 30 minutos, 2 horas y 12 horas con el mismo cuerpo y el mismo id EvaSay-Delivery, así que puedes ignorar las repeticiones. Las últimas entregas de un webhook, con el cuerpo exacto enviado y el estado que respondió tu endpoint, las lista GET /webhooks/{id}/deliveries y el panel; POST /webhooks/{id}/deliveries/{delivery_id} reenvía una.
Además del correo electrónico y de los webhooks alert.triggered / alert.resolved, las alertas pueden ir a un canal de Slack (incoming webhook), a un robot de grupo de WeCom o a Telegram en Webhooks y notificaciones → Alertas → Enviar también a.
Crea un webhook mediante POST /webhooks con { "url": "https://crm.example.com/evasay-events", "events": ["call.analyzed"] }. La respuesta contiene la suscripción y un secreto de firma generado, devuelto solo al crearla. Verifica EvaSay-Signature, deduplica EvaSay-Delivery y actualiza tu CRM. Los webhooks de eventos son notificaciones asíncronas; las herramientas durante la llamada devuelven los resultados directamente al agente.