Connect Aircall (cloud phone)

Aircall is a cloud phone system. Connecting this channel brings calls from your Aircall number into the Omnifox Inbox alongside your messaging channels, so the entire history with a customer lives in one place.

Requirements

• An Aircall account with an active number
• An API ID and API Token generated at dashboard.aircall.io → Integrations → API Keys
• The Number ID of the number that will receive calls, and the User ID of the default agent

Steps to connect

1. In dashboard.aircall.io, go to Integrations → API Keys and generate an API ID + API Token.
2. Find the Number ID of your Aircall number and the User ID of the agent who answers by default.
3. In Omnifox, go to Channels → Connect New Channel, pick Aircall, and fill in those four values.
4. Save the channel: Omnifox shows you the webhook URL (with the channel's ID included).
5. In Aircall, create a webhook subscription pointing to that URL and copy the Webhook Token Aircall gives you into the Webhook Token field in Omnifox.

Configuration

• API ID / API Token: basic auth for outbound calls through Aircall's API (dial).
• Number ID: the Aircall number that receives inbound calls.
• User ID: the Aircall agent called first, before bridging to the destination (the "call-back-then-bridge" pattern).
• Webhook Token: validates the Aircall-Signature header on every inbound event.

Example

A customer calls your Aircall number; Aircall first rings the assigned agent's IP phone and, once they pick up, bridges the call to the customer. Lifecycle events (created, ringing, answered, ended) reach Omnifox and get logged on that customer's conversation in the Inbox.

Tips

• Aircall's model is "ring the agent first, then bridge": a successful dial doesn't connect the call instantly — there's a wait until the agent answers.
• If you have several Aircall numbers, connect each as its own channel with its own Number ID.

Troubleshooting

• Outbound calls never trigger: confirm the User ID belongs to an active agent with a registered IP phone in Aircall.
• No call events arrive: check that the webhook URL in Aircall matches the one Omnifox generated and that the Webhook Token is identical on both sides.