Skip to main content

Aircall

The Aircall integration imports call recordings from Aircall and posts the Speechlytics summary back to the call in Aircall as a comment.

Setting it up​

  1. In Aircall, create an API ID and API token (Integrations & API → API Keys).
  2. Provide them to your Speechlytics representative, together with a webhook signing secret you choose.
  3. Once the integration is saved, copy its Webhook Url and add it in Aircall as a webhook for the call.ended event, using the same signing secret.
  4. Switch the integration on.

What is imported​

  • Calls with a recording, when they end. Speechlytics also accepts call.update and call.recording_available events, because Aircall often attaches the recording a moment after the call ends.
  • The Aircall user is the agent; the Aircall contact's name is the customer.
  • The Aircall call id is the call's External Id.

An hourly synchronization also lists recent Aircall calls as a backstop. It reads the most recent 50 calls in each window, so the webhook is the primary path for busy accounts. Make sure it is registered.

Write-back​

When an Aircall-sourced call has a summary, Speechlytics adds the summary to the Aircall call as a comment, visible to agents in Aircall. Write-back is best-effort: if the comment cannot be posted it is not retried, and the call is still processed normally. In rare cases, such as a retried delivery, the same summary can be posted twice.

Each imported call and each hourly synchronization is recorded in the account's audit log.

Troubleshooting​

SymptomWhat to check
Calls arrive only hourly, or are missed on busy daysThe webhook is not registered, or its signing secret does not match.
A call is missingThe call had no recording in Aircall.
No comment appears in AircallThe call has no summary (summaries are not enabled), or the Aircall call was deleted.