Conectar Aircall (teléfono en la nube)

Aircall es una central telefónica en la nube. Conectando este canal, las llamadas de tu número de Aircall se integran al Inbox de Omnifox junto con tus canales de mensajería, para tener toda la conversación con un cliente en un solo lugar.

Requisitos

• Una cuenta de Aircall con un número activo
• API ID y API Token generados en dashboard.aircall.io → Integraciones → API Keys
• El Number ID del número que va a recibir llamadas y el User ID del agente por defecto

Pasos para conectar

1. En dashboard.aircall.io, andá a Integraciones → API Keys y generá un API ID + API Token.
2. Identificá el Number ID de tu número Aircall y el User ID del agente que va a atender por defecto.
3. En Omnifox, andá a Canales → Conectar nuevo canal, elegí Aircall y completá esos cuatro valores.
4. Guardá el canal: Omnifox te muestra la Webhook URL (con el ID del canal incluido).
5. En Aircall, creá una suscripción de webhook hacia esa URL y copiá el Webhook Token que te da Aircall al Webhook Token del formulario en Omnifox.

Configuración

• API ID / API Token: autenticación básica para las llamadas salientes de la API de Aircall (dial).
• Number ID: el número Aircall que recibe las llamadas entrantes.
• User ID: el agente Aircall que se llama primero antes de bridgearlo con el destino (patrón "call-back-then-bridge").
• Webhook Token: valida la firma Aircall-Signature de cada evento entrante.

Ejemplo

Un cliente llama a tu número de Aircall; Aircall primero llama al teléfono IP del agente asignado y, cuando atiende, bridgea la llamada con el cliente. Los eventos del ciclo de vida (creada, sonando, atendida, finalizada) llegan a Omnifox y quedan registrados en la conversación del cliente en el Inbox.

Consejos

• El modelo de Aircall es "llama al agente primero, después bridgea": un dial exitoso no conecta la llamada al instante, hay una espera hasta que el agente atiende.
• Si tenés varios números Aircall, conectá cada uno como un canal separado con su propio Number ID.

Solución de problemas

• Las llamadas salientes no se disparan: confirmá que el User ID corresponde a un agente activo con un teléfono IP registrado en Aircall.
• No llegan eventos de llamada: revisá que la URL del webhook en Aircall sea la misma que generó Omnifox y que el Webhook Token coincida en ambos lados.