Aircall integration: add cloud calling to your CRM in 2026

This guide is for teams already running Aircall as their phone system who want calls to show up in the same place as everything else they know about a client, instead of living in a separate dashboard nobody checks between calls.

Quick answer: Mavibot's Aircall integration connects your Aircall cloud PBX to the CRM, so employees call clients directly from the contact card instead of dialing from a separate app. Every call is recorded, logged automatically, and tracked in real time through call events (ringing, answered, completed, missed, voicemail), all visible on the same record as the client's chat history.

What the Aircall integration actually does

Aircall is a cloud phone system built for teams, extensions, and call routing, not a single number tied to one person. Mavibot's integration connects that system to the CRM so a call placed from a contact card goes out through your Aircall line, and the bot can call on a client's behalf using an employee's assigned number rather than a separate number nobody recognizes.

Every call gets logged back into the same client record automatically: who called, when, how long it lasted, and a link to the recording. Instead of checking Aircall's own dashboard to see what happened on a call and then cross-referencing it against the CRM separately, both live in the same place.

Why Mavibot added Aircall to the CRM

Mavibot's CRM already unifies WhatsApp, Instagram, Telegram, and website chat into one client record. Teams that had already invested in Aircall as their phone system were stuck working around that gap manually, switching to a separate app to place a call and then coming back to log what happened.

Connecting Aircall closes that gap without asking anyone to change phone systems. The call still goes out through Aircall's infrastructure and your existing Aircall numbers, but the trigger, the record, and the history all live inside Mavibot.

What you get with the Aircall integration

Calling from the contact card

Open a client's record and call them directly, without opening Aircall separately or looking up their number. The call goes out through the Aircall line configured for that conversation.

Call recordings on the client record

Every call gets a recording link saved to the contact's record. Aircall keeps the recording permanently in its own dashboard, but the link Mavibot stores is time-limited, so recordings need to be pulled promptly if you want to archive them somewhere else.

Real-time call event tracking

Mavibot receives callback notifications as a call moves through its stages: created, ringing, answered, hung up, completed, or sent to voicemail. That gives an accurate record of what actually happened instead of guessing from call duration alone.

Call details as CRM variables

Duration, call status, and the reason a call was missed all get stored as variables on the client's record, so they're available for automations, reporting, or a quick glance without opening the recording.

How to set up the Aircall integration with Mavibot

Setup happens in three places: your Aircall account, Mavibot's telephony settings, and each employee's profile.

Step 1: Set up your Aircall account

Register at aircall.io and purchase a phone number in the country you're calling from. Create a user account in Aircall for every employee who needs to make or receive calls through the integration.

Step 2: Generate your API credentials

In the Aircall dashboard, go to Settings → Integrations & API and generate an API ID and API Token. These are what let Mavibot authenticate with your Aircall account, so treat the API Token the same way you'd treat a password. Aircall's own API documentation covers what each credential can access if you want the full picture before connecting a third-party tool.

Step 3: Connect Aircall to Mavibot

In Mavibot's telephony settings, enter your Aircall API ID, API Token, and Number ID, the identifier for the specific Aircall line calls should go out from. All three fields are required before the call button will appear on contact cards.

Step 4: Add each employee's Aircall user ID

In every employee's Mavibot profile, add their Aircall user ID, a numerical identifier from Aircall, not a phone number. This is easy to miss: without it on file, that employee's call button won't work, even if the account-level connection in Step 3 is correct.

Once all four steps are done, calling appears directly on contact cards for every employee with an Aircall user ID on file.

What this doesn't do (and why that's worth knowing upfront)

Recording links expire. Mavibot's stored recording link is only valid for a matter of hours, though the recording itself stays in your Aircall account dashboard indefinitely. If you need a call on file long-term, pull it from Aircall directly rather than relying on the link in Mavibot.

The Aircall user ID isn't the same as a phone number, and using the wrong value in an employee's profile is the most common reason the call button silently doesn't work. Double-check it against the Aircall dashboard, not against a phone number you already have on hand.

Consent and recording laws vary by country, and sometimes by state or region within a country. Some places require every party on a call to agree to being recorded before you start; others only require one party (which could just be you) to know. Mavibot and Aircall provide the recording capability, but making sure you're using it legally in your market is on you.

Frequently asked questions

Do I need to switch phone systems to use this integration?

No. The integration connects your existing Aircall account to Mavibot. Calls still go out through Aircall's infrastructure and your existing Aircall numbers; Mavibot just adds the contact-card calling, logging, and event tracking on top.

What's the difference between an Aircall user ID and a phone number?

The Aircall user ID is a numerical identifier Aircall assigns to each user account, separate from any phone number. Mavibot needs this ID, not a phone number, in each employee's profile for that employee's call button to work.

How long do call recordings stay accessible through Mavibot?

The recording link Mavibot stores is time-limited and expires within hours. The recording itself remains permanently available in your Aircall account dashboard, so pull anything you need to keep from there.

Can I see whether a call was missed and why?

Yes. Call status and the reason a call was missed are both stored as variables on the client's record, available alongside duration and the rest of the call's details.

What if Aircall isn't the right phone system for my team?

If you're evaluating whether Aircall itself is the right fit before connecting it, see our comparison of Aircall alternatives, including options with built-in calling that don't require a separate phone system subscription at all.

Bring your Aircall calls into the same place as everything else

Every channel you already run through Mavibot, WhatsApp, Instagram, Telegram, Messenger, website chat, logs into one contact record. Aircall calls now do the same. Connect your account once, add each employee's Aircall user ID, and your team calls clients straight from the CRM with every call recorded and tracked automatically.

Ready to connect Aircall to your CRM? Start with Mavibot for free and set up the integration today.