Who can use this feature?
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.
- In Chili Piper, go to Admin Center and click Integrations in the left menu.
-
On the Built-In Integrations tab, scroll to the Phone section and click Connect on Aircall
- You’ll be redirected to Aircall to authorize the connection. Sign in with your Aircall admin credentials and click Authorize.
- You’ll be redirected back to Chili Piper. Confirm the Aircall integration shows a Connected status.
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
- 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).
*
- 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.
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 Admin 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 Admin 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?
Comments
0 comments
Please sign in to leave a comment.