Skip to main content
Coldread
All Guides

Setup Guide

How to Connect Ringover Webhooks to Coldread

Configure Ringover webhooks to automatically send call recordings and metadata to Coldread for AI transcription and analysis. Takes about 10 minutes.

Why use Coldread with Ringover?•Aircall setup guide

Before you start

  • A Ringover account with admin access
  • Call recording enabled in your Ringover settings
  • 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 Ringover as your provider. Coldread will generate a unique webhook URL and an optional webhook secret for signature verification.

2

Copy your webhook URL

Your Coldread webhook URL follows this format:

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

Copy this URL from your Coldread integration settings page. You'll paste it into Ringover in the next step.

3

Configure webhooks in Ringover

Log in to your Ringover Dashboard and navigate to:

  1. Go to Settings (gear icon)
  2. Select Integrations or Webhooks
  3. Click "Add a new webhook" or "Configure webhook"
  4. Paste your Coldread webhook URL into the URL field

If Ringover asks for a webhook secret or signing key, enter the secret shown in your Coldread integration settings. This ensures webhook payloads are verified.

4

Enable call events

In the Ringover webhook configuration, enable the following event types:

CALL_ENDED / call.ended

Triggered when a call finishes (required)

CALL_RINGING / call.ringing

Triggered when an incoming call rings (optional)

VOICEMAIL / voicemail

Triggered when a voicemail is left (optional)

Important: At minimum, you must enable the CALL_ENDED event. Coldread processes calls when they end and a recording is available. Without this event, no calls will be captured.

5

Save and test

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

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

You can also verify the webhook endpoint is reachable by visiting your webhook URL in a browser. You should see a JSON response with {"status":"ok"}.

Optional: Webhook relay to external systems

If you need to forward incoming Ringover webhooks to another system (like n8n, Zapier, or custom automation), Coldread can relay the raw webhook payload after processing.

  1. In your Coldread integration settings, find the Relay URL field
  2. Enter the destination URL where you want webhooks forwarded
  3. Save the integration settings

Coldread will automatically relay every incoming webhook to your specified URL using POST requests with:

  • X-Idempotency-Key header (prevents duplicate processing)
  • Original webhook payload in the request body
  • Automatic retries with exponential backoff if delivery fails
  • Dead letter queue for permanently failed deliveries

Webhook signature verification

Coldread verifies incoming Ringover webhooks using the x-ringover-signature or x-signature header. If you configured a webhook secret in both Ringover and Coldread, payloads are verified using HMAC-SHA256 before processing. This prevents unauthorized requests from being accepted.

If you did not set a webhook secret, signature verification is skipped. We strongly recommend enabling it for production use to ensure webhook authenticity.

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 Ringover (check webhook status)
  2. Ensure CALL_ENDED event is enabled
  3. Confirm call recording is enabled in Ringover 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 in Ringover logs

If Ringover reports webhook delivery failures with 401 errors:

  1. Verify the webhook secret in Ringover matches the secret in your Coldread integration settings exactly
  2. Check for extra whitespace before/after the secret when copy-pasting
  3. Try removing the webhook secret from both systems temporarily to test without signature verification
  4. If webhooks work without a secret, regenerate a new secret in Coldread and update Ringover

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 Ringover
  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

Webhook relay not reaching external system

If you configured a relay URL but your external system isn't receiving webhooks:

  1. Check the relay URL is publicly accessible (test with curl or webhook.site)
  2. Verify your external system is listening for POST requests
  3. Check integration settings in Coldread dashboard for relay attempt history and error logs
  4. Ensure your external system accepts the X-Idempotency-Key header
  5. Review the dead letter queue in Coldread for permanently failed relay attempts

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

Related Setup Guides

Aircall Setup

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

Coldread for Ringover

Learn how Coldread enhances your Ringover 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 Ringover? Start a free trial and our team will help you get set up.

Email Support