Skip to main content

​
Overview

Vobiz is a cloud-based telephony provider with global reach and competitive pricing. Voicerix uses Vobiz’s voice API and WebSocket streaming to power your voice agents.

​
Prerequisites

  • A Vobiz account
  • Auth ID and Auth Token from your Vobiz dashboard
  • A Vobiz Application — or leave blank and Voicerix will auto-create one
  • At least one Vobiz phone number

​
Configuration

​
Step 1: Get Vobiz Credentials

  1. Log in to your Vobiz dashboard
  2. Find your Auth ID and generate an Auth Token for API access
  3. (Optional) Navigate to Applications, open the application you’ll use with Voicerix, and copy its Application ID. Skip this if you want Voicerix to auto-create the application.
  4. Note the phone numbers you plan to use

​
Step 2: Add Configuration in Voicerix

  1. In Voicerix, go to Integrations and click Add configuration
  2. Select Vobiz as your provider
  3. Enter your credentials:
    • Auth ID
    • Auth Token
    • Application ID (optional — leave blank to auto-create)
  4. Click Save Configuration
  5. Open the saved configuration and add at least one phone number in E.164 format (e.g. +1234567890)
If Voicerix auto-created the Vobiz Application, you still need to attach your Vobiz numbers to that application in the Vobiz Console under Applications. The auto-created application is named voicerix-<random> — its Application ID is shown on the saved configuration.

​
Step 3: Test

  1. Go to Agents, open a workflow, and click Test Call
  2. Check the call logs to confirm a successful connection

​
Inbound Calling Setup

Vobiz numbers link to an Application — the answer_url lives on the application. When you save an inbound workflow on a phone number in Voicerix, Voicerix automatically pushes the webhook URL to your Vobiz Application’s answer_url. If Voicerix auto-created the application, the URL is already set.
  1. Log in to your Vobiz Console and open Applications
  2. Edit the application whose ID is configured in Voicerix
  3. Attach the phone number you want to use for inbound calls
  4. Save

​
Step 2: Assign an Inbound Workflow in Voicerix

  1. In Voicerix, go to Integrations and open your Vobiz configuration
  2. In the Phone numbers section, edit the number that should receive inbound calls
  3. Set its Inbound workflow to the agent that should answer
  4. Save

​
Step 3: Verify in Vobiz Console

  1. Open your Vobiz Console and navigate to Applications
  2. Open the application whose ID is configured in Voicerix
  3. Confirm:
    • Answer URL is set to: https://client.voicerix.ai/api/v1/telephony/inbound/run
    • Answer Method is POST
Voicerix pushes this URL automatically when you save the inbound workflow. The same URL is shared across every number linked to that application — Voicerix routes each call to the right agent based on the called number’s inbound workflow assignment. If the field is empty or shows a different URL, the auto-push failed — usually because the Auth ID/Token or Application ID is incorrect. Paste the URL manually, set the method to POST, and save.

​
Step 4: Test Inbound

  1. Call your Vobiz number from another phone
  2. Verify your voice agent answers and responds
  3. Check call logs in both Voicerix and your Vobiz dashboard

​
Troubleshooting

Ensure phone numbers include the country code in E.164 format: +1234567890
  • Verify Auth ID and Auth Token are correct
  • Check for extra spaces in credentials
  • Ensure credentials haven’t been regenerated in Vobiz dashboard
  • Confirm your Auth Token matches exactly
  • Verify the webhook URL is accessible from Vobiz servers
  • Check if you’re behind a proxy that modifies requests
  • Verify the WebSocket connection is established
  • Check firewall rules for WebSocket traffic
  • Ensure the audio pipeline is configured correctly
  • Verify the phone number is linked to the same Vobiz Application whose ID is in Voicerix
  • Confirm the called number has an Inbound workflow assigned in Voicerix
  • Confirm Voicerix successfully updated the application’s answer_url (no warning shown on save)
  • Verify Voicerix is running and responding
  • Confirm the phone number has an Inbound workflow assigned in Integrations
  • Check that the Auth Token in Voicerix matches your Vobiz dashboard
  • Verify WebSocket connection establishes successfully
  • Review call logs for error messages

​
Best Practices

  • Test your configuration with a single call before running campaigns
  • Monitor your Vobiz dashboard for usage and billing
  • Keep your Auth Token secure and rotate it periodically
  • Use a dedicated Vobiz Application for Voicerix so the shared answer_url doesn’t conflict with other systems