Eventos en tiempo real para tu stack
Cada vez que pasa algo relevante en la centralita —una llamada que entra, contesta, finaliza, un mensaje de voz o una grabación lista— Infinity lo notifica por HTTPS a la URL que tú elijas. Sin polling, sin retrasos: tu CRM, ERP, data warehouse o motor de IA reaccionan al instante.
Suscríbete solo a lo que importa
Cada evento se envía como POST JSON firmado. Tu endpoint solo recibe los eventos que hayas activado en el panel — sin ruido, sin sobrecarga.
Llamada iniciada
Se dispara al crear el tramo de llamada. Útil para abrir la ficha del contacto en el CRM antes incluso de descolgar.
Llamada contestada
Disparado al contestar. Marca el inicio real de conversación: arrancar timer, actualizar dashboard, pasar a agente.
Llamada finalizada
Incluye duración, estado de grabación y si la atendió otra extensión. Base del registro en CRM y del pipeline a IA.
Llamada actualizada
Cambios durante la llamada: transferencia, conferencia o cambio de número conectado. Mantiene el estado sincronizado.
Interacción de cliente
Resumen consolidado al final de la llamada. Ideal para registrar la interacción completa en el CRM con un único POST.
Buzón de voz recibido
Hay un mensaje de voz nuevo. Crea ticket, avisa por WhatsApp/email o lanza el flujo de seguimiento.
Tarificación de llamada
Coste y duración tarificada por llamada. Para analítica de rentabilidad, control de consumo y refacturación a cliente.
Cola y agentes
Tiempo de espera, posición, motivo de salida y agente que atendió. Para reporting de SLA, abandono y supervisor.
Marcador / campaña
Lead marcado, número de intentos, disposición y campaña asociada. Para feedback en tiempo real al CRM de ventas.
De evento telefónico a acción automática
Un webhook bien diseñado convierte la centralita en parte activa del flujo digital de la empresa. Estos son los patrones que vemos a diario en producción.
Aviso a Slack en llamadas críticas
Si una cola supera SLA o entra un número marcado como VIP, el equipo recibe un mensaje en Slack o Teams con el número, agente y tiempo de espera.
Registro en CRM al cuelgue
Al finalizar la llamada, el evento customer_interaction crea o actualiza la ficha en Zoho, HubSpot o Salesforce con duración, agente y dirección.
Ingesta a data warehouse
Cada evento se persiste en BigQuery, Snowflake o Postgres para reporting interno: volumen por agente, conversión, picos horarios y compliance.
WhatsApp tras llamada perdida
Si is_answered=false, el sistema lanza un WhatsApp al cliente con plantilla aprobada y abre tarea de devolución al comercial.
IA: transcripción + resumen
Al disparar event_call_finished con grabación disponible, el audio entra al pipeline de transcripción, resumen y extracción de tareas.
Ticket automático en soporte
Una entrada por DID de soporte genera ticket en Zendesk/Jira con número, cola, tiempo de espera y agente asignado. Trazabilidad completa.
Payload claro, correlación por linked_id
Cada POST trae los campos que necesitas para identificar la llamada, el tramo y la entidad que llama. El linked_id conecta todos los eventos de una misma llamada — incluyendo tarificación y grabación posterior.
uid
linked_id
tenant_code
number
did
trunk
state
direction
duration
record_status
queue_agent_info
event_time_info
// Headers Content-Type: application/json X-Conexia-Signature: t=1715594400,v1=9a3f… X-Conexia-Event: event_call_finished { "event": "event_call_finished", "tenant_code": "acme", "uid": "1715594400.482", "linked_id": "1715594398.481", "number": "201", "connected_num": "+34600123456", "did": "+34900730650", "direction": "INBOUND_CALL", "is_pbx_user": true, "state": "None", "duration": 187, "record_status": "RecordingActive", "queue_caller_info": { "queue": "ventas", "wait_time": 14, "talk_time": 173, "reason": "agent" }, "event_time_info": { "timestamp": 1715594587, "date": "2026-05-13", "time": "10:23:07" } }
Configuración en minutos, sin desarrollo en tu PBX
Activas el módulo desde el panel de Conexia Infinity, defines tu endpoint HTTPS y eliges qué eventos quieres recibir. A partir de ese momento, cada evento se entrega como POST JSON firmado con HMAC-SHA256 y queda registrado en el panel de entregas.
El equipo técnico de Conexia te acompaña en el diseño del flujo, prueba en sandbox y despliegue en producción.
-
Endpoint HTTPS bajo tu dominio Tú expones la URL. Conexia firma cada petición con tu secreto compartido — sin abrir puertos en tu red.
-
Suscripción granular por evento Activas solo los eventos que necesitas. Cambias la selección en cualquier momento sin desplegar nada.
-
Firma HMAC-SHA256 en cada POST Cabecera
X-Conexia-Signaturecon timestamp + hash. Validas que el evento viene de Conexia antes de procesarlo. -
Reintentos con backoff hasta 24 h Si tu endpoint cae, no se pierde el evento: reintentos exponenciales durante un día y cola de morgue accesible desde panel.
-
Panel de entregas en Infinity Histórico por evento, latencia, código HTTP de respuesta y reintento manual. Auditoría completa para soporte y compliance.
Una capa de producto, no un script
Webhooks pensados para entornos donde una llamada perdida o un evento duplicado no es opción. Las garantías que pides a una pasarela de pagos, ahora para tu telefonía.
HTTPS + HMAC-SHA256
Transporte cifrado y firma criptográfica por POST. Tu servicio verifica origen e integridad antes de procesar.
Reintentos con backoff
Reentrega automática hasta 24 h ante 5xx, timeouts o caídas. Sin pérdida silenciosa de eventos.
Idempotencia con uid
Cada evento trae uid único. Si llega dos veces, tu sistema lo descarta sin generar tareas duplicadas.
Observabilidad nativa
Latencia, tasa de éxito, código de respuesta y payload completo por entrega — consultable desde panel y exportable.
Push para reaccionar, pull para consultar
No es uno u otro: la mayoría de integraciones serias combinan webhooks (push) para reaccionar a eventos en tiempo real con API REST (pull) para consultas puntuales y operaciones administrativas.
Webhooks (push)
La centralita te avisa cuando algo ocurre
- Latencia de segundos: tu CRM reacciona antes de que el agente cuelgue.
- Sin polling: cero carga inútil sobre tu infra y la nuestra.
- Modelo event-driven: cuadra con automatizaciones, IA y mensajería.
- Necesitas exponer un endpoint HTTPS validando firma HMAC.
API REST (pull)
Tú preguntas a la centralita cuando lo necesitas
- Lecturas históricas: listar llamadas, agentes, colas, extensiones.
- Operaciones administrativas: crear extensión, asignar DDI, mover usuarios.
- No expones nada hacia internet: tú haces las peticiones.
- Para tiempo real: polling = latencia + carga. Aquí ganan los webhooks.
Lo que preguntan los equipos técnicos antes de integrar
¿Cómo valido la firma HMAC-SHA256?
Cada POST trae la cabecera X-Conexia-Signature con formato t=<timestamp>,v1=<hash>. Calculas HMAC_SHA256(secret, timestamp + "." + raw_body) y comparas con timing-safe contra v1. Si difieren o el timestamp tiene más de 5 minutos, rechazas el evento. Te entregamos snippet de ejemplo en Node, Python y PHP.
¿Qué pasa si mi endpoint está caído cuando llega un evento?
Si responde 5xx, timeout o se desconecta, Conexia reintenta con backoff exponencial durante hasta 24 horas. Cada intento queda registrado en el panel con código HTTP y latencia. Pasadas las 24 h sin éxito, el evento entra en una cola de "morgue" desde la que puedes reentregar manualmente.
Para que un evento se considere entregado correctamente tu endpoint debe responder un 2xx en menos de 10 segundos.
¿Cómo evito procesar el mismo evento dos veces?
Cada evento incluye uid único e inmutable. La forma estándar es persistirlo en una tabla con índice único: si la inserción falla por duplicado, descartas el procesamiento. Es el patrón que usan Stripe, Shopify y la mayoría de pasarelas de eventos.
Combinado con linked_id, puedes además correlacionar todos los eventos de una misma llamada (tramos, tarificación, grabación).
¿En qué orden llegan los eventos de una misma llamada?
El orden lógico es event_call_started → event_call_connected (si contesta) → event_call_updated (en caso de transferencia o cambio) → event_call_finished. Posteriormente puede llegar customer_interaction (resumen) y call_rating (tarificación, suele venir minutos después).
La red no garantiza orden estricto entre POSTs independientes: usa siempre los timestamps del payload (event_time_info) y el uid para reconstruir la secuencia.
¿Hay sandbox para probar antes de producción?
Sí. Te damos un tenant de prueba con eventos simulados y un endpoint público tipo webhook.site para que puedas inspeccionar payloads reales sin tocar tu infra. Cuando tu integración esté validada, movemos la configuración a tu tenant de producción.
¿Puedo filtrar eventos por extensión, cola o DID?
Sí. En el panel defines reglas de enrutado: por familia de evento, por DID, por cola o por extensión. Puedes apuntar diferentes eventos a diferentes endpoints — por ejemplo, llamadas comerciales a tu CRM y voicemails al sistema de ticketing.
¿Qué eventos llegan en una llamada de cola con varias extensiones?
Los Call Leg Events solo se disparan para extensiones registradas en la PBX. Si una llamada hace sonar 10 extensiones pero solo 2 están registradas, recibirás eventos para esas 2 — más el customer_interaction final con el resumen consolidado y el campo extension apuntando a la que efectivamente atendió.
¿Es compatible con Make, n8n o Zapier?
Sí. Cualquier plataforma que pueda recibir un POST JSON en una URL pública sirve como receptor. Tenemos plantillas listas para Make y n8n con la validación de firma HMAC ya implementada. Si usas Zapier, recomendamos un pequeño paso intermedio (Cloudflare Worker o función serverless) para validar la firma antes de entrar al zap.
Activa webhooks en tu centralita
Conexia te ayuda a diseñar el flujo, validar firma en sandbox y desplegar en producción. Si necesitas que coordinemos directamente con tu equipo de desarrollo o integrador, también lo hacemos.
900 730 650 · info@conexiatec.com