Connect Aircall
Customer-facing call counts and (with consent) call transcripts for quality scoring.
Prerequisites
- Aircall workspace admin role
- A PerfCopilot admin account (the Connect button is only visible to admins)
- For transcript scoring: audio-ingest consent must be enabled on the Aircall card
1. Generate credentials in Aircall
- Sign in to https://dashboard.aircall.io.
- Navigate to Settings → Integrations & API → API Keys.
📖 Official guide: Basic Authentication (API keys) — Aircall's own documentation for creating this credential.
- Click Generate.
- Copy the api_id (left column) and api_token (right column) — both are shown only once.
Copy these values; you'll paste them in the next step:
api_idapi_token
2. Paste into PerfCopilot
-
Open Integrations on your PerfCopilot admin.
-
Find the Aircall card and click Connect (or Manage if already configured).
-
Paste each value into the matching field:
| Field in PerfCopilot | Value from step 1 | |---|---| | api_id |
<your value>| | api_token |<your value>| -
Click Save.

3. Verify
Click Test in the drawer. Expected:
✅ Authenticated as your-workspace.aircall.io
If you see a red error, jump to Common errors.
Common errors
| Message | What it usually means | Fix |
|---|---|---|
| HTTP 401: Unauthorized | api_id and api_token are swapped, or one was mistyped. | Re-generate in Aircall and re-paste both values, double-checking which column is which. |
| HTTP 402: Payment required | The Aircall workspace is suspended. | Resolve billing inside Aircall, then click Test again. |
| HTTP 401: <body excerpt> | Credentials rejected. | Re-check that you copied the full token, no leading/trailing whitespace. |
What signals we pull
phone— call countsphone_quality— transcript-based call scores (only when audio-ingest consent is enabled)
Need a feature you don't see? Tell us →.