Connect Aircall (cloud phone)
Connect your Aircall number to Omnifox to make and receive calls right from the Inbox.
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
- In dashboard.aircall.io, go to Integrations → API Keys and generate an API ID + API Token.
- Find the Number ID of your Aircall number and the User ID of the agent who answers by default.
- In Omnifox, go to Channels → Connect New Channel, pick Aircall, and fill in those four values.
- Save the channel: Omnifox shows you the webhook URL (with the channel's ID included).
- 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-Signatureheader 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.
Related articles
-
WhatsApp (Meta) error codes: what they mean and what to do
A table of the most common Meta error codes when sending on WhatsApp (131026, 131047, 131049, 130497, 141006, 131031, 131056, 132000, 190, 368…) and how to fix each one.
-
How to connect Telegram
Connect a Telegram bot to your Omnifox inbox in minutes using BotFather.
-
Instagram and Facebook comments: reply and moderate from Omnifox
See and answer comments on your Facebook and Instagram posts and ads, publicly or privately, and set up automatic replies.
-
Sending and receiving videos on each channel: formats and size limits
Which videos you can send and receive on WhatsApp, Instagram, Messenger, Telegram, web chat and email, the real size limits, and what to do with a large video.
-
Move from WhatsApp QR to Coexistence or Cloud API
Once you're done testing with the QR code, move your number to the official connection: no caps, with templates and broadcasts, and no volume-based ban risk.