Documentation

Vobiz Integration

Configure Vobiz for voice communication in Paladin AI

Overview#

Vobiz is a cloud-based telephony service provider that offers global reach with competitive pricing. Paladin AI's Vobiz integration provides reliable voice connectivity for your conversational AI agents.

Prerequisites#

Before setting up Vobiz integration, you'll need:

  • A Vobiz account
  • Auth ID and Auth Token from your Vobiz dashboard
  • A Vobiz Application (optional — leave the field blank in Paladin and we'll auto-create one for you on save, with the answer_url pre-set)
  • At least one Vobiz phone number
  • Access to your Paladin workspace

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 the Applications section and create (or open) the application you'll use with Paladin, then copy its Application ID. Skip this if you want Paladin to auto-create the application for you on save.
  4. Navigate to Phone Numbers and copy the numbers you plan to use

Step 2: Configure in Paladin AI#

  1. Navigate to /telephony-configurations and click Add configuration
  2. Select Vobiz as your provider
  3. Enter your credentials:
  • Auth ID
  • Auth Token
  • Application ID — optional. Leave blank and Paladin will auto-create a Vobiz Application on save (with the answer_url already configured) and store its Application ID on this configuration.
  1. Click Save Configuration
  2. Open the configuration you just created and add at least one phone number (with country code in E.164 format, e.g. +1234567890). The default caller ID is used for outbound calls.

Step 3: Test Your Configuration#

  1. Create a test workflow
  2. Click "Call" to verify connection
  3. Check call logs for successful connection

Inbound Calling Setup#

Vobiz numbers don't carry an answer_url directly — the URL lives on a Vobiz Application, and each number is linked to one application. When you save an inbound workflow on a phone number, Paladin automatically pushes the webhook URL to your Vobiz Application's answer_url (provided the credentials are correct). If Paladin auto-created the application during configuration save, the answer_url is already set and this push is a no-op.

  1. Log in to your Vobiz Console and open the Applications section
  2. Edit the application whose ID you configured in Paladin
  3. Attach the phone number you want to use for inbound calls
  4. Save

Step 2: Assign an Inbound Workflow to the Phone Number in Paladin#

  1. Go to /telephony-configurations 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 the Answer URL on the Vobiz Application#

  1. Open your Vobiz Console and navigate to Applications
  2. Open the application whose ID you configured in Paladin
  3. Confirm:
  • Answer URL is set to: https://app.paladin.northmanngrp.com/api/v1/telephony/inbound/run
  • Answer Method is POST

Step 4: Verify Setup#

  • Ensure your Paladin AI instance is publicly accessible
  • Verify any firewalls allow Vobiz's webhook requests

Test Inbound Calling#

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

Troubleshooting#

Invalid phone number error

Ensure phone numbers include country code in E.164 format: +1234567890

Authentication failed
  • Verify Auth ID and Auth Token are correct
  • Check for extra spaces in credentials
  • Ensure credentials haven't been regenerated in Vobiz dashboard
Webhook requests failing
  • 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
No audio on calls
  • Verify WebSocket connection is established
  • Check firewall rules for WebSocket traffic
  • Ensure audio pipeline is configured correctly
Inbound calls go to voicemail or aren
  • Verify the phone number is linked to the same Vobiz Application whose

ID you configured in Paladin - Confirm the called number exists in your Paladin telephony configuration and has an Inbound workflow assigned

  • After assigning the inbound workflow, confirm Paladin successfully

updated the application's answer_url (no warning shown on save) - Verify Paladin AI instance is running and responding

Voice agent doesn
  • Confirm the phone number has an Inbound workflow assigned in

/telephony-configurations - Check webhook signature validation is working (Auth Token in Paladin matches 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 Vobiz dashboard for usage and billing
  • Keep your Auth Token secure and rotate it periodically
  • Use a dedicated Vobiz Application for Paladin so the shared answer_url doesn't conflict with other systems