---
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-04-23T12:27:44Z
---

## 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
  * Connect Aircall to Chili Piper (Admin)
  * Schedule a Meeting During a Call (Rep)
  * What Reps See: Insight Card States
  * Troubleshooting
  * 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.

  1. In Chili Piper, go to **Command Center** and click **Integrations** in the left menu.![](https://help.chilipiper.com/hc/article_attachments/50878646786835)
  2. 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)
  3. 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)
  4. 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:

  1. **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)

  1. 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)*
  2. 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.

  1. Ask the caller for their email address during the call.
  2. Enter it in the **Email** field on the Chili Piper card.
  3. 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?
