Admins install the Microsoft Teams and Aircall integration for the organization, then each user adds the Aircall Workspace app from the Microsoft Teams marketplace. This article explains the full setup process, required permissions, number configuration, availability sync, and best practices.
Admin installation
Before starting, ensure:
You have Global Administrator rights or Root User role in Microsoft Teams and Admin role in Aircall
You use the same email address for both accounts
Steps:
In Microsoft Teams, select Apps in the left-hand menu and search for Aircall.
Select the Aircall application, then click Add.
Accept the requested permissions by selecting Continue. You should only need to accept these permissions the first time you access this page.
On the redirected page, click Get started.
A new window may appear prompting you to log in to your Microsoft account. Click Accept to allow permissions.
NOTE:
If permissions are denied, you can allow them later in Microsoft Teams:
https://admin.teams.microsoft.com → Teams apps → Manage apps → Aircall → Permissions → Review permissions.
If you are not logged in to the Aircall Admin Dashboard, you will be prompted to log in.
Authorize Microsoft Teams to access your Aircall account.
NOTE:
If you do not see the authorization screen and only land on the Dashboard, close the window and click “Get started” again.
Add at least one phone number to complete the integration. For more information on how to add numbers, please visit our article Assigning your Phone Number to your Integration.
IMPORTANT:
After setup, make sure to add all numbers that users will place or receive calls on. This ensures proper status and availability syncing.Configuration in the Aircall Dashboard
Once installation is complete:
Go to to the Aircall Dashboard > Integrations > Apps
Select MS Teams under My apps.
In Connected numbers, add all numbers used by team members who will rely on the integration.
User configuration
Each user must complete two steps:
1. Install Aircall in Microsoft Teams
Search for Aircall in Teams
Click Add
Admins can also preinstall the app for all users through Microsoft Teams.
2. Configure Availability Sync
Users must set their availability sync preferences in the Aircall Teams app:
Open the Aircall app inside Microsoft Teams
Configure Availability Sync settings
IMPORTANT:
Availability sync from the Teams integration overrides internal availability settings in Aircall.
Best practices
Pin Aircall in Microsoft Teams for easy access from the sidebar.
Download the Aircall Workspace desktop app from aircall.io/download to use click to dial from Teams.
For device and headset recommendations, see our article Device & Headset Recommendations.
Set your operating system to open telephone links in Aircall. For guidance, see our article Selecting Your Default Application for Opening Telephone Links.
Known issues and limitations
Status sync does not update for internal transfers
When a call is transferred internally between users, the receiving user's availability status in Microsoft Teams is not updated to reflect the call. Their status will continue to show as available, even while they're on the transferred call.
NOTE: This applies to internal transfers only. Your status in Microsoft Teams updates correctly for all other call types.
This setup ensures smooth calling, accurate status syncing, and seamless access to Aircall directly inside Microsoft Teams.