Skip to main content

​
Overview

Vobiz is a cloud-based telephony service provider that offers global reach with competitive pricing. Dograh 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 from your Vobiz dashboard
  • Auth Token generated for your account
  • At least one configured phone number in your Vobiz account
  • Dograh AI instance running and accessible

​
Configuration

​
Step 1: Get Vobiz Credentials

  1. Sign up for a Vobiz account
  2. Log in to your Vobiz dashboard
  3. Navigate to your account settings to find your Auth ID
  4. Generate an Auth Token for API access
  5. Configure phone numbers in your Vobiz account for outbound calling

​
Step 2: Configure in Dograh AI

  1. Navigate to Workflow → Phone Call → Configure Telephony
  2. Select Vobiz as your provider
  3. Enter your credentials:
    • Auth ID
    • Auth Token
    • From Phone Number (with country code, e.g., +1234567890)
  4. Click Save Configuration
Vobiz provides cloud-based telephony services with global reach and competitive pricing.

​
Step 3: Test Your Configuration

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

​
Inbound Calling Setup

To enable inbound calling with Vobiz:
  1. Complete Telephony Configuration: Use the same Configuration steps above
  2. Get Your Workflow Webhook URL: Find your workflow ID and construct the webhook URL as: https://api.dograh.com/api/v1/telephony/inbound/{workflow_id}

​
Configure Application in Vobiz Console

Vobiz requires creating an XML application to handle inbound calls. Follow these steps:
  1. Navigate to Applications:
    • Log in to your Vobiz Console
    • Navigate to the Applications section
    Vobiz console showing Applications section navigation
  2. Create New Application:
    • Click Create New Application
    • Configure the XML application with the following URLs:
      • Answer URL: https://api.dograh.com/api/v1/telephony/inbound/{workflow_id}
      • Hangup URL: https://api.dograh.com/api/v1/telephony/vobiz/hangup-callback/workflow/{workflow_id}
      • Fallback Answer URL: https://api.dograh.com/api/v1/telephony/inbound/fallback
    • Save the application
    Replace {workflow_id} with your actual workflow ID. If using self-hosted Dograh, replace api.dograh.com with your domain.
    Vobiz XML application configuration showing Answer URL, Hangup URL, and Fallback Answer URL
  3. Attach Phone Number:
    • After saving the application, edit it to attach a phone number
    • Select the phone number you want to use for inbound calls
    • Link it to your created application
    Vobiz application showing phone number attachment interface
  4. Verify Setup:
    • Ensure your Dograh 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 Dograh AI voice agent answers and responds
  3. Check call logs in both Dograh AI dashboard and Vobiz dashboard

​
Troubleshooting

Ensure phone numbers include 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 WebSocket connection is established
  • Check firewall rules for WebSocket traffic
  • Ensure audio pipeline is configured correctly
  • Verify webhook URL is correctly configured in Vobiz dashboard
  • Ensure webhook URL is publicly accessible from internet
  • Check that phone number is properly linked to webhook
  • Verify Dograh AI instance is running and responding
  • Confirm voice agent workflow is properly configured
  • Check webhook processing is working correctly
  • Verify WebSocket connection establishes successfully
  • Review call logs for error messages

​
Best Practices

  • Store credentials securely in the database
  • 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