Skip to main content

Connecting Your Vodia PBX

Vodia Analytics receives data from Vodia PBX via the built-in CDR webhook mechanism. The PBX sends call detail records and recordings automatically to your Vodia Analytics instance.

Prerequisites​

  • Vodia PBX version 69 or later
  • Vodia Analytics installed and accessible at your domain
  • Your PBX server's IP added to the Vodia Analytics IP whitelist (configured during installation or in Admin → IP Whitelist)

Step 1: Whitelist Your PBX IP​

Vodia Analytics uses IP whitelisting to authenticate incoming data from your PBX.

During installation, you're prompted for PBX IPs. If you need to add IPs later, go to Admin → IP Whitelist in Vodia Analytics and add your PBX server's public IP address. Please allow upto 60 seconds for an IP to be whitelisted.

Step 2: Configure the CDR Webhook​

The CDR URL can be configured at the system level (applies to all tenants) or per tenant (per domain) in the Vodia PBX admin interface.

System-wide: Admin → System → Recording/CDR -> CDR URL

Per tenant: Tenant → General Settings → CDR URL

Set the CDR URL to:

webcdrs://your-cdr-domain.com/cdr

For example:

webcdrs://cdr.example.com/cdr

OR you could add to the existing CDR URL using space as delimiter

For example:

file:disk jsons://jsoncdr.com webcdrs://cdr.example.com/cdr
webcdrs:// protocol

The webcdrs:// prefix tells Vodia PBX to send CDR data over HTTPS using its webhook format. Use webcdrs:// (with the s) for HTTPS — use webcdr:// only for unencrypted HTTP (not recommended).

Step 3: Configure Recording Settings​

In the Vodia PBX admin, go to Admin → System → Recording/CDR and set the Compress recordings to Linear Stereo.

Why Linear Stereo?

Linear Stereo (PCM format 1, dual channel) gives the best transcription results. Vodia Analytics splits the stereo channels to produce separate caller and agent transcripts, which dramatically improves accuracy and enables per-party sentiment analysis.

The recording upload URL is derived from the same CDR endpoint — Vodia PBX sends recordings to the Vodia Analytics instance automatically once the CDR URL is configured.

Step 4: Verify​

Make a test call through the PBX, then check Vodia Analytics:

  • The call should appear on the Calls page within seconds
  • If recordings are configured, a play button will appear on the call detail
  • If the OpenAI key is configured and auto-summarize is enabled, AI analysis will begin automatically

Multiple PBX Systems​

Vodia Analytics is multi-tenant. Each Vodia PBX Tenant is automatically treated as a separate tenant based on the domain field in the CDR payload. You can connect multiple PBX systems to the same Vodia Analytics instance — each will have its own isolated data. Configure the CDR URL on each PBX system pointing to the same Vodia Analytics domain.

IP Whitelisting​

Vodia Analytics authenticates all incoming CDR and recording data by IP address. Only PBX servers whose IPs are in the whitelist can push data. Manage the whitelist during installation or anytime in Admin → IP Whitelist.