Skip to main content
Table of contents

Step 1: Add phone numbers in Aircall

We fetch your data from Aircall both through automatic imports and with webhooks. Automatic imports run once every 1 hour, whereas webhooks update your data sources instantly.

To ensure that everything updates in real time in Plecto, it's important that you add in Aircall all the phone numbers you want to track. If you don't add the numbers in Aircall, your data sources in Plecto will update only once an hour (and the data you stream directly from Aircall is not going to be accurate).

How to add phone numbers in Aircall:

  1. Log in to Aircall as an admin.

  2. Navigate to Integrations & API > My Integrations and open Plecto.

  3. Click + Add numbers in the section Connected numbers. Add all the phone numbers you want to keep track of in Plecto.

  4. Once you've added all numbers, click Confirm to finish. Read more in Aircall's guide.

  5. You can now move on to Step 2.

Step 2: Connect Aircall with Plecto

  1. In Plecto, go to Data management > Data sources+ New data source > Aircall.

  2. Click Next and log in to your Aircall account.

  3. Click Authorize to give Plecto read access to your Aircall data. You will be redirected back to Plecto.

  4. Decide what data you want to import.
    (It's not possible to import Known/Custom and Streaming data types all at once. Choose either the one or the other, then repeat these steps to add the other data)

  5. Configure your data source settings. Here, you can change the title, choose the default date, select which fields to import, and more.

  6. Click Next to choose how much data to import and how long you want to keep it in the data source.

  7. Click Import to finish.

Available data

Here's what you can currently import from Aircall:

  • Agents – All calls are linked to call agents that have previously been in contact with the same phone number. With this data, you'll know who the incoming call should (or could) be redirected to.

  • Calls – Get real-time data for your incoming, outgoing, and missed calls.

  • User events – User events based entirely on webhooks. Automatic imports don't apply. Whenever you create this data source, it will initially be empty and will start getting registrations whenever webhooks in Aircall update.

Note on Aircall Calls
  1. Aircall warns that the largest scope of historical data they provide for the Calls data type is six months. If needed, you can request a one-time export from Aircall and then upload the sheet to Plecto using Excel or our Google Sheets integration. Read more in Aircall's developer docs.

  2. As of November 2022, Calls has a new field – Talking time. It means that the data source now contains both a Duration field and a Talking time field. Here's how they're different: Duration shows the total call duration from Started at to Ended at. Talking time shows the conversation duration from Answered at to Ended at.

Streaming data

Instead of adding data sources, storing data, and building formulas to see your metrics, you can stream KPIs directly from Aircall on your Plecto dashboards. The streaming data allow you to see the following metrics:

  • Calls in queue

  • Longest waiting time in queue

  • Employee status

Webhooks

Plecto subscribes to the following events in Aircall webhooks:

  • call.created

  • call.answered

  • call.hungup

  • call.ended

  • call.assigned

  • call.tagged

  • call.untagged

  • user.created

  • user.opened

  • user.connected

  • user.closed

  • user.disconnected

  • user.deleted

  • user.wut_start

  • user.wut_end