Skip to main content
How to integrate with Aircall

Learn how to start forecasting and tracking agent performance via Aircall

Updated over 2 weeks ago

What does the integration do?

Once connected, Dialpad WFM will pull historical data from Aircall to:

  • Show your actual ticket count from Aircall within Dialpad WFM

  • Generate forecasts and staffing requirements

  • Track agent performance and attendance within Aircall

For Aircall, forecasting and performance reporting require two different connections due to differing data sources.


How to set-up forecasting via Aircall

Step 1: Connect Dialpad WFM to Aircall

The forecasting connection is made via API:

  1. Go to Connections in settings.

  2. Select 'Connect to Aircall'

  3. You’ll be taken to another screen to authorise your connection.

  4. Set-up is complete!

What's next?

The system will now download 12 months of historical ticket data from your Aircall account. This process will take 24-48hrs to complete, depending on the volume of tickets in your account.

Step 2: Set-up your forecast with queues

Once this is complete, you next need to map your Aircall tickets to queues.

A queue should represent the channels or queues agents work on in Aircall.

  1. Navigate to Forecasts > Queues.

  2. Click the button labelled 'New queue'.

  3. Name the queue. We recommend you use the same name you use in Aircall.

  4. The 'real-time' and 'non real-time' setting does not apply to Aircall.

  5. Select 'Aircall' from the connections dropdown.

  6. You can now filter the tickets you want to include in this queue in the 'define queue' section. You can choose to filter tickets by:

    1. cost

    2. direction

    3. duration

    4. missed_call_reason

    5. number_digits

    6. number_id

    7. status

    8. tags

  7. On the right hand side of the page, you will see a preview of the number of tickets you received in the last 7 days that match your filters. You can use this to check against data in your Aircall account to ensure you've set up the filters correctly.

  8. Next, you need to enter the staffing parameters for this queue.
    These inputs turn ticket volumes into a staffing requirement.

    1. Average conversation/interaction time: enter the average handle time for the entire conversation.

    2. Concurrency: for phones, this should always be 1 as agents can only handle 1 call at a time.

    3. Shrinkage: the is the % of scheduled time that's lost while agent's work on this queue. If you're not sure what you're shrinkage is, 30% is quite average across the industry.

  9. Finally, you need to enter the service level or SLA that you're trying to achieve.
    This a target % of all tickets that should meet your first response time target.

  10. Your queue will now be set up and ready to use to forecast, track coverage and agent performance.


How to set-up agent tracking via Aircall

Step 1: Create the Webhook in Aircall

  1. Log in to your Aircall dashboard (https://dashboard.aircall.io)

  2. In the left sidebar, click Integrations & API

    1. Note: if you do not see this option you likely do not have the correct permissions. Contact your admin to request them or have them peform the steps for you.

  3. On the Integrations & API page, click the Discover integrations tab

  4. Scroll down and select the Webhook option

  5. Click Install integration

  6. Give your integration a name e.g. Dialpad WFM

  7. Paste in the URL our team will have shared with you

  8. Leave all events toggled on

  9. Click Add webhook in the bottom right corner

  10. Click Finish.

Step 2: Share your webhook details with Dialpad WFM

You’ll now be taken back to the webhook settings for the webhook you just created, please copy & paste and share the following pieces of information with your Customer Success Manager:

  1. The token shown in the General settings box

Our team will then finalise the connection and you'll be ready to start tracking performance!

Step 3: Link activities with queues

In order to correctly mark agent activity as 'on-task' or 'off-task', you need to define which activities are 'queue activities', i.e. agents should be working in Aircall at this time.

  1. Navigate to the day view of the schedule

  2. Open the activities sidebar by clicking “Add activities

  3. Select the activity you want to link to a forecast and click the edit icon ✏️

  4. Toggle 'link to a forecast' on and select the relevant queue(s) from the dropdown

  5. Set-up is complete!

You can now monitor agent's Aircall presence and activity in the real-time page and performance page.

Did this answer your question?