Onoff Business – Call Webhook Integration Guide

The Onoff Business Call Webhook allows your system to receive Call Detail Records (CDRs) and, optionally, call recordings directly in real time.

This feature is ideal for businesses that:

• Do not use a CRM integration
• Want to build custom analytics tools
• Need to centralize call data internally
• Require full control over call processing, storage, or visualization

Webhook data can be incorporated into dashboards, business workflows, or custom applications for real-time monitoring and reporting.

Call webhook is available on Onoff Business Advanced and Max plans.

Installing and Configuring the Call Webhook

Check Your Plan and Access

1. Ensure your account has access to the Integrations panel.
2. If Integrations is not visible, upgrade your plan to Advanced or Max.

Open the Webhook Configuration

1. Open Integrations & API on the main page
2. Click Onoff Call Webhook to open the configuration page
3. Configure the following fields:
4. URL (required): The endpoint on your server that will receive POST requests from Onoff.
5. API Key (optional, recommended): Use this to secure your endpoint and verify incoming requests are from Onoff.

You can find more details in the Documentation of the webhook (go to Authorization section).

Activate the Webhook

1. Click Integrate after filling in the fields
2. Onoff will send a test payload to your URL
3. Integration status will update to:

• Integrated if your endpoint responds successfully
• If the endpoint cannot be reached or responds incorrectly, the integration will not activate and you must correct the URL

Data Sent by the Call Webhook

After a call ends, the webhook sends a payload including:

• User information: name, email, number
• Contact information: name, email, number (if available)
• Call timestamps: start and end
• Call duration
• Call direction
• Call status
• Call notes
• Call tags
• Voicemail URL (if applicable)
• Call recording URL (if recording is enabled and available)
  

Example: Full payload details can be found in the official documentation:
➡️Onoff Webhook Docs

Webhook Behavior for Call Events

1. Webhook triggers after the call ends, when complete CDRs and recording links are available.
2. If a call is recorded, the recording link is included.
3. If a call is not recorded, all other metadata is still sent.

Call Recording Details

If Send Call Recording is turned on, the call webhook will include a link to the audio file.

Here’s what to know about how recordings behave:

Recording Delivery Delay

1. Recordings are processed and delivered in the webhook a few minutes after the call (typically 5–8 minutes).
2. This delay ensures the audio file is fully processed and accessible.
   

Recording Retention

1. Links expire after the retention period
2. After expiration, recordings are no longer accessible
3. If you need longer retention, download and store recordings on your own system
   

Very Short Recordings

1. Calls lasting only a few seconds may be excluded
2. Only answered calls with actual recordings are sent
3. Calls not recorded or from users without call recording enabled will not appear in the webhook
   

Post-Call Updates

The Include post-call updates toggle controls whether the webhook is sent immediately or after a short delay to include additional details:

1. OFF: Webhook sent right after the call ends; only notes/tags added during the call are included.
2. ON: Webhook sent 5 minutes after the call ends; includes:
3. Notes added during the call
4. Notes added within 5 minutes after the call
5. Tags added/updated during the call
6. Tags added/updated within 5 minutes after the call
   

This ensures your webhook contains a complete view of the call context.

Removing the Call Webhook

1. Go to Integrations and API → Call Webhook → Settings
2. Scroll to Remove this integration → Click Remove (red button)
3. Confirm in the modal → Click Continue
   

Best Practices

• Use a secure endpoint and validate the optional API Key for security
• Plan for a 5–8 minute delay for recording availability
• Configure post-call updates to capture final notes and tags
• Store recordings if longer retention is required
• Be aware that very short or unrecorded calls will not trigger webhook events

Your Call Webhook is now ready. All answered and recorded calls will automatically flow into your system in real time, giving you full control over your call data.