--- title: "Schedule meetings from the Aircall desktop app" source_url: https://help.chilipiper.com/hc/en-us/articles/50579426909331-Schedule-meetings-from-the-Aircall-desktop-app article_id: 50579426909331 updated_at: 2026-07-24T18:55:56Z content_hash: a41dc767 --- ## Who can use this feature? Available on **Chili Cal, Handoff** Available to **Admins** (Setup) and **All users** (Scheduling) [Billing Center](https://fire.chilipiper.com/fire/admin/billing/overview) [Get a Demo](https://www.chilipiper.com/request-demo?utm_source=zendesk&utm_medium=help-center&utm_campaign=chili-hub) Chili Piper integrates with the Aircall desktop app so you can schedule meetings while you’re on a call—without leaving the Aircall interface. When a call starts, a Chili Piper Insight Card appears with the caller’s context and a one-click button to open the scheduler. ## Table of Contents - [Requirements](#requirements) - [Connect Aircall to Chili Piper (Admin)](#connect-aircall-to-chili-piper-admin) - [Schedule a Meeting During a Call (Rep)](#schedule-a-meeting-during-a-call-rep) - [What Reps See: Insight Card States](#what-reps-see-insight-card-states) - [Troubleshooting](#troubleshooting) - [Limitations](#limitations) ## Requirements Before setting up the integration, confirm the following: - Your organization has an active **Handoff** subscription. - You are using the **Aircall desktop app** (macOS or Windows). - Your Chili Piper account has at least one **Handoff router** configured. - A **Chili Piper Admin** completes the one-time connection (see below). **Note:** Reps do not need to authenticate individually. Once an admin connects Aircall at the organization level, each rep is matched automatically by their Aircall email address. ## Connect Aircall to Chili Piper (Admin) A Chili Piper admin must complete this one-time setup to enable the integration for your entire organization. - In Chili Piper, go to **Command Center** and click **Integrations** in the left menu.![](https://help.chilipiper.com/hc/article_attachments/50878646786835) - On the **Built-In Integrations** tab, scroll to the **Phone** section and click **Connect** on **Aircall** ![](https://help.chilipiper.com/hc/article_attachments/50879079046163)![](https://help.chilipiper.com/hc/article_attachments/50879101572243) - You’ll be redirected to Aircall to authorize the connection. Sign in with your Aircall admin credentials and click **Authorize**.![](https://help.chilipiper.com/hc/article_attachments/50878036180499) - You’ll be redirected back to Chili Piper. Confirm the Aircall integration shows a **Connected** status.![](https://help.chilipiper.com/hc/article_attachments/50878009453587) **Warning:** The admin who authorizes the connection must have admin permissions in both Chili Piper and Aircall. If the connection fails, confirm your Aircall account has admin-level access. ### How rep matching works Once the admin connection is established, Chili Piper matches each rep automatically: - When a call starts, Aircall sends a _call.started_ event that includes the logged-in rep’s email address. - Chili Piper matches that email against your Chili Piper user directory. - If a match is found, the rep sees the full Chili Piper Insight Card with scheduling capabilities. - If no match is found, the rep sees a prompt to log in to their Chili Piper account. No per-rep authentication is required in Aircall. The rep’s email in Aircall must match their email in Chili Piper exactly. ## Schedule a Meeting During a Call (Rep) Once the integration is connected, scheduling a meeting takes three steps: - **Start or receive a call** in the Aircall desktop app. The Chili Piper Insight Card appears automatically in the **Caller Insight Cards** panel on the right side of the call view ![](https://help.chilipiper.com/hc/article_attachments/50878384075411) - Click **Schedule a Meeting** on the Chili Piper card. This opens the Chili Piper scheduler in a new browser tab, pre-populated with the caller’s information (when available).![](https://help.chilipiper.com/hc/article_attachments/50878009456915)* - Select an available time and confirm the booking. The meeting is created on the assigned rep’s calendar, and the caller receives a calendar invitation at their email address. **Note:** The scheduler opens in your default browser (not inside the Aircall app). Keep the Aircall call active while you complete the booking in the browser tab. ### If the caller has no email on file If the caller’s phone number does not match a contact with an email address in your CRM, the Insight Card displays an email input field instead of the scheduling button. - Ask the caller for their email address during the call. - Enter it in the **Email** field on the Chili Piper card. - Click **Schedule** to open the scheduler with that email. ![](https://help.chilipiper.com/hc/article_attachments/50878009457555)Alternatively, click **Copy my booking link** to copy your personal booking link and share it with the caller verbally or via a follow-up message. ## What Reps See: Insight Card States Depending on what information is available and whether your Aircall user is matched to a Chili Piper user, the Insight Card may appear in different states: - **Matched rep + caller email available:** You see a **Schedule a Meeting** button. - **Matched rep + caller email missing:** You see an **Email** input field and a **Schedule** action after entering an email. - **Rep not matched:** You may see a prompt to **Connect/Log in to Chili Piper** instead of the scheduling button. ## Troubleshooting ### The Chili Piper Insight Card does not appear - Confirm an admin has connected Aircall in **Command Center > Integrations**. - Confirm you are using the **Aircall desktop app** (this integration does not work in the Aircall web app or mobile app). - Confirm your email address in Aircall matches your email address in Chili Piper exactly. ### A “Connect Chili Piper” prompt appears instead of the schedule button Your Aircall email does not match a Chili Piper user. Ask your Chili Piper admin to verify your email address in both systems. ### The scheduler does not open after clicking “Schedule a Meeting.” - Check whether your default browser is blocking pop-ups or redirects from **app.chilipiper.com**. - Try clicking the button again. If the issue persists, refresh the Aircall desktop app and retry. ### The caller’s information is not pre-populated in the scheduler - The caller’s email address may be missing or may not match a contact in your CRM. - Confirm your CRM integration (Salesforce or HubSpot) is connected in **Command Center > Integrations**. ## Limitations - The integration is available in the **Aircall desktop app** only. - The scheduler opens in your default **browser tab**, not inside the Aircall app. - Routing rules are applied based on the caller’s **email address**. If no email is available, you must enter one manually or share a booking link. ## Related articles - How do I configure a Handoff router? - How do I connect my CRM to Chili Piper? - How do I use the Chrome extension to schedule meetings? - How do I share my personal booking link?