Webhooks
Webhooks en tiempo real: envía call.start, call.end, transfer y eventos personalizados a tus endpoints con payloads firmados.
Los webhooks te permiten conectar BHOMY a cualquier sistema externo enviando notificaciones HTTP en tiempo real cuando ocurren eventos.
¿Qué son los webhooks?
Un webhook es una solicitud HTTP POST enviada a una URL que tú especificas cada vez que ocurre un evento específico en BHOMY. Esto te permite construir integraciones personalizadas con cualquier software que pueda recibir solicitudes HTTP.
Configurar webhooks
- Ve a Flujos de trabajo → "Webhooks".
- Haz clic en "Añadir webhook".
- Introduce la URL de tu endpoint.
- Selecciona a qué eventos suscribirte.
- Haz clic en "Guardar".
Eventos disponibles
| Evento | Descripción |
|---|---|
call.started | Se activa cuando comienza una llamada entrante o saliente. |
call.ended | Se activa cuando termina una llamada, incluye transcripción y duración. |
call.transferred | Se activa cuando una llamada se transfiere a un agente humano. |
appointment.booked | Se activa cuando el agente reserva una cita durante una llamada. |
campaign.completed | Se activa cuando una campaña saliente finaliza todas las llamadas. |
Formato del payload
Los webhooks envían payloads en JSON. Ejemplo para call.ended:
{
"event": "call.ended",
"timestamp": "2026-03-02T14:30:00Z",
"data": {
"call_id": "call_abc123",
"agent_id": "agent_xyz789",
"direction": "inbound",
"caller": "+34600...",
"duration_seconds": 180,
"status": "completed",
"transcript_url": "https://api.bhomy.ai/v1/calls/call_abc123/transcript"
}
}Autenticación
Cada solicitud de webhook incluye un encabezado X-BHOMY-Signature que contiene una firma HMAC-SHA256. Verifica esta firma usando tu secreto de webhook para asegurar que las solicitudes provienen genuinamente de BHOMY.
Política de reintentos
Si tu endpoint devuelve un código de estado que no es 2xx, BHOMY reintenta hasta 3 veces con retroceso exponencial (1 min, 5 min, 30 min). Después de 3 intentos fallidos, el evento se registra y se omite.
Probar webhooks
Usa el botón "Enviar prueba" para enviar un payload de ejemplo a tu endpoint. Esto te ayuda a verificar tu integración antes de activarla.
Feedback
Was this article helpful?