---
title: Connecting Aircall
description: Connect Aircall to Teamlead to get a forecast from your call history and to see live whether employees are working according to the schedule.
---

[Skip to content](https://kennisbank.teamlead.io/en/connecting-aircall#main-content)

- [English](https://kennisbank.teamlead.io/en/connecting-aircall)
- [Nederlands](https://kennisbank.teamlead.io/nl/aircall-koppelen)

English

Show submenu for translations

![Teamlead](https://kennisbank.teamlead.io/hs-fs/hubfs/main-logo-horizontal-png-dark.png?width=176&height=32&name=main-logo-horizontal-png-dark.png)

Open main navigation

Close main navigation

- - [English](https://kennisbank.teamlead.io/en/connecting-aircall)
    - [Nederlands](https://kennisbank.teamlead.io/nl/aircall-koppelen)

  English
  
  Show submenu for translations
- [Tickets](https://servicedesk.teamlead.nl/tickets)

[Tickets](https://servicedesk.teamlead.nl/tickets?hsLang=en)

 Hi. How can we help you?

- There are no suggestions because the search field is empty.

1. [Teamlead Knowledge Base](https://kennisbank.teamlead.io/en?hsLang=en)
2. [Connections](https://kennisbank.teamlead.io/en/connections?hsLang=en)

# Connecting Aircall

## Connect Aircall to Teamlead to get a forecast from your call history and to see live whether employees are working according to the schedule.

With the Aircall connection, Teamlead fetches your call history and tracks the live status of your employees. You switch on the connection yourself and do not need an API key. Teamlead helps you with this.

### What do you do in Aircall?

You do not need to set anything up beforehand. While connecting, you log in to Aircall and give permission. Use an Aircall account that is allowed to approve the connection, usually that of your Aircall administrator.

### How to connect Aircall

1. Go to **Settings** \> **Connections** and click **Aircall**.
2. Click **Connect with Aircall**. You are taken to Aircall.
3. Log in to Aircall and give permission for the connection.
4. You return to Teamlead. Switch on **Forecasting** and/or **Adherence** and click **Save**.
5. Teamlead now fetches employees and queues (**Syncing with Aircall**). You can keep working as normal. While syncing, you cannot change the toggles.
6. Then check the **IVR options**, **Aircall agents** and **Status mappings** tables.
7. Link the IVR options to skills in a staffing template.

![The Aircall connection page with the Connect with Aircall button](https://kennisbank.teamlead.io/hubfs/kennisbank/aircall-en.png?v=20261020f)

### What comes in?

- **IVR options** are your queues. If you work with IVR choices, each choice becomes a queue, for example "Standard IVR - Key 1". If you work with one number per queue, each number becomes a queue.
- Call volumes per hour per queue, up to 180 days back. Aircall does not keep data for longer than that.
- The live status of employees. Teamlead sets up the connection for this with Aircall itself.
- Aircall users, linked by email address. You can only change the **Profile**.

### Default status mappings

| Situation in Aircall | Status in Teamlead |
| --- | --- |
| Call answered or on hold | On a call |
| After-call work started | After-call work |
| After-call work finished | Available or Unavailable |
| Connected, status "always opened" | Available |
| Call declined, or status "lunch", "back office", "training", "other" or "always closed" | Unavailable |
| Disconnected | Logged off |

### Good to know

- Are you installing Teamlead from the Aircall Marketplace? Then choose **Log in** (or **Set up a new environment**). If you have more than one location, choose the location under **Choose a location**. You then go straight to the permission step in Aircall.
- The call history fills up gradually. Aircall only allows a limited number of requests per minute, and Teamlead deliberately uses only part of that.
- New Aircall users are added to the **Aircall agents** table automatically.
- Older connections sometimes work with an API key. You then see **API ID** and **API token** under **Technical settings**.
- In your staffing template, select all IVR options that belong to one queue.

### Not working?

- **Aircall did not accept the credentials. Connect again.** Click **Connect with Aircall** again.
- **Aircall accepted the credentials but did not allow the request. Ask your Aircall administrator to grant access.** Have an Aircall administrator give permission.
- **There are no queues to fetch yet.** There have been no calls yet in the period fetched. Try again later.
- **Aircall could not be reached. Try again later.**
- Did you cancel the permission step in Aircall? Then you see **Connect with Aircall** again. Start again.

### See also

- [Overview: which connections are available?](https://kennisbank.teamlead.io/en/overview-which-connections-are-available?hsLang=en)
- [Setting up staffing templates](https://kennisbank.teamlead.io/en/setting-up-staffing-templates?hsLang=en)
- [Forecast: required staffing from telephony data](https://kennisbank.teamlead.io/en/forecast-required-staffing-from-telephony-data?hsLang=en)
- [Tracking adherence](https://kennisbank.teamlead.io/en/tracking-adherence?hsLang=en)

- [Get started](https://kennisbank.teamlead.io/en/get-started?hsLang=en)
- [For employees](https://kennisbank.teamlead.io/en/for-employees?hsLang=en)
- [For planners and team leads](https://kennisbank.teamlead.io/en/for-planners-and-team-leads?hsLang=en#main-content)

    - [Schedule](https://kennisbank.teamlead.io/en/for-planners-and-team-leads?hsLang=en#schedule)
    - [Shift templates and automatic scheduling](https://kennisbank.teamlead.io/en/for-planners-and-team-leads?hsLang=en#shift-templates-and-automatic-scheduling)
    - [Leave](https://kennisbank.teamlead.io/en/for-planners-and-team-leads?hsLang=en#leave)
    - [Staffing and forecast](https://kennisbank.teamlead.io/en/for-planners-and-team-leads?hsLang=en#staffing-and-forecast)
    - [Adherence and statistics](https://kennisbank.teamlead.io/en/for-planners-and-team-leads?hsLang=en#adherence-and-statistics)
- [For administrators](https://kennisbank.teamlead.io/en/for-administrators?hsLang=en)
- [Connections](https://kennisbank.teamlead.io/en/connections?hsLang=en)
- [Frequently asked questions](https://kennisbank.teamlead.io/en/frequently-asked-questions?hsLang=en)

[![](https://kennisbank.teamlead.io/hs-fs/hubfs/Teamlead-logo.png?width=500&height=105&name=Teamlead-logo.png)](http://teamlead.io)

[Website](https://teamlead.io)[Create a ticket](https://servicedesk.teamlead.nl/tickets?hsLang=en)© 2026 Teamlead