dograh/docs/integrations/telephony/vobiz.mdx

---
title: "Vobiz Integration"
description: "Configure Vobiz for voice communication in Dograh AI"
---

## 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](https://vobiz.com)
- 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**

<Note>
Vobiz provides cloud-based telephony services with global reach and competitive pricing.
</Note>

### 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](#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

   <img
     className="block dark:hidden"
     src="/images/vobiz-inbound-config-1.png"
     alt="Vobiz console showing Applications section navigation"
   />
   <img
     className="hidden dark:block"
     src="/images/vobiz-inbound-config-1.png"
     alt="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

   <Note>
   Replace `{workflow_id}` with your actual workflow ID. If using self-hosted Dograh, replace `api.dograh.com` with your domain.
   </Note>

   <img
     className="block dark:hidden"
     src="/images/vobiz-inbound-config-2.png"
     alt="Vobiz XML application configuration showing Answer URL, Hangup URL, and Fallback Answer URL"
   />
   <img
     className="hidden dark:block"
     src="/images/vobiz-inbound-config-2.png"
     alt="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

   <img
     className="block dark:hidden"
     src="/images/vobiz-inbound-config-3.png"
     alt="Vobiz application showing phone number attachment interface"
   />
   <img
     className="hidden dark:block"
     src="/images/vobiz-inbound-config-3.png"
     alt="Vobiz application showing phone number attachment interface"
   />

2. **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

<AccordionGroup>
  <Accordion title="Invalid phone number error">
    Ensure phone numbers include country code in E.164 format: `+1234567890`
  </Accordion>
  
  <Accordion title="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
  </Accordion>
  
  <Accordion title="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
  </Accordion>
  
  <Accordion title="No audio on calls">
    - Verify WebSocket connection is established
    - Check firewall rules for WebSocket traffic
    - Ensure audio pipeline is configured correctly
  </Accordion>
  
  <Accordion title="Inbound calls not connecting">
    - 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
  </Accordion>
  
  <Accordion title="Voice agent doesn't respond to inbound calls">
    - Confirm voice agent workflow is properly configured
    - Check webhook processing is working correctly
    - Verify WebSocket connection establishes successfully
    - Review call logs for error messages
  </Accordion>
</AccordionGroup>

## 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