Skip to main content
Coldread
All Guides

Setup Guide

Connect Aircall to Coldread

Set up Aircall webhooks to automatically send call recordings and metadata to Coldread for AI transcription and analysis. Takes about 5 minutes.

Why use Coldread with Aircall?•Ringover setup guide

Before you start

  • An Aircall account with admin or developer access
  • Call recording enabled in Aircall
  • A Coldread account (free trial is fine)
1

Sign up and create an integration

If you haven't already, create a Coldread account and navigate to Settings → Integrations in your dashboard.

Click "Add Integration" and select Aircall as your provider. Coldread will generate a unique webhook URL and a webhook token for verification.

2

Copy your webhook URL

Your Coldread webhook URL follows this format:

https://coldread.ai/api/webhooks/aircall/YOUR_INTEGRATION_ID

Copy this URL from your Coldread integration settings. You'll need it when creating a webhook in the Aircall dashboard.

3

Create a webhook in Aircall

Log in to the Aircall Dashboard and navigate to:

  1. Go to Integrations & API in the left sidebar
  2. Select API Keys or Webhooks
  3. Click "Create a webhook"
  4. Paste your Coldread webhook URL into the URL field
  5. Enter the webhook token from your Coldread integration settings

Aircall verifies webhooks by including the token in the payload body. Coldread checks this token against your integration's stored secret to ensure authenticity.

4

Enable call events

In the Aircall webhook configuration, subscribe to the following events:

call.ended

Triggered when a call finishes with recording available (required)

call.commented

Triggered when a rep adds notes to a call (optional)

call.tagged

Triggered when a call is tagged (optional)

Important: You must subscribe to call.ended at minimum. Coldread processes calls when they end and a recording URL is present in the payload.

Recording URL expiry: Aircall recording URLs expire after 10 minutes. Coldread automatically downloads recordings immediately upon receiving the webhook, so no action is needed on your part. Just make sure the webhook is configured correctly and the endpoint is reachable.

5

Enable call recording in Aircall

For Coldread to transcribe and analyze calls, recording must be enabled:

  1. In Aircall, go to Settings → General
  2. Find the Call Recording section
  3. Toggle recording On for inbound and outbound calls
  4. Configure disclosure messages as required by your jurisdiction

Calls without recordings will still appear in Coldread (with metadata) but cannot be transcribed or analyzed by AI.

6

Save and test

Save your webhook configuration in Aircall. To verify the connection:

  1. Make a test call using your Aircall phone system
  2. Wait for the call to end and the recording to process
  3. Check your Coldread dashboard — the call should appear within 30 seconds

You can verify the endpoint is reachable by visiting your webhook URL in a browser. A healthy endpoint returns {"status":"ok"}.

Troubleshooting

Calls not appearing in Coldread

If calls aren't showing up in your dashboard within 30 seconds:

  1. Verify the webhook is active in Aircall (check webhook status)
  2. Ensure the call.ended event is enabled
  3. Confirm call recording is enabled in Aircall settings
  4. Check that the webhook URL is correct (no extra spaces or characters)
  5. Visit your webhook URL in a browser — you should see {"status":"ok"}

401 Unauthorized errors

If Aircall reports webhook delivery failures with 401 errors:

  1. Verify the webhook token in Aircall matches the token in your Coldread integration settings exactly
  2. Check for extra whitespace before/after the token when copy-pasting
  3. Try regenerating a new token in Coldread and updating it in Aircall

Calls appear but have no transcription

If calls show in the dashboard but transcription is missing:

  1. Confirm call recording is enabled for both inbound and outbound calls in Aircall
  2. Check that the call duration is at least 3 seconds (very short calls may not have recordings)
  3. Wait up to 2 minutes — transcription is processed asynchronously
  4. Verify your Coldread subscription has available call quota remaining

Recording URL expired

Aircall recording URLs expire after 10 minutes. If transcription fails due to an expired URL:

  1. Coldread downloads recordings immediately upon receiving the webhook — this should not normally happen
  2. If your webhook endpoint was unreachable when the call ended, the recording URL may have expired by the time Aircall retried
  3. Ensure your Coldread integration endpoint is always reachable (check for outages or DNS issues)
  4. The call metadata will still be available, but re-transcription requires a new recording URL from Aircall

Still having issues? Email us at support@coldread.ai with your integration ID and we'll help troubleshoot.

Related Setup Guides

Ringover Setup

Connect Ringover to Coldread for automatic call transcription and AI analysis.

Coldread for Aircall

Learn how Coldread enhances your Aircall phone system with AI insights.

Pricing

View plans and pricing. Start with a 14-day free trial, no credit card required.

Need help?

Having trouble connecting Aircall? Start a free trial and our team will help you get set up.

Email Support