Vobiz Setup

This guide walks you through connecting your Vobiz account to Vocobase for outbound calling.

Configure Vobiz with the V2 API (PUT /api/v2/config/telephony/vobiz) for the default connection. To create multiple named Vobiz connections, use POST /api/v2/telephony/connections. Once Vobiz is configured, start calls programmatically using POST /calls/start with "provider": "vobiz".

Prerequisites

A Vobiz account with a verified Auth ID and Auth Token
At least one Vobiz phone number provisioned for outbound voice
An approved Vocobase account with "vobiz" present in allowed_telephony_providers (check GET /config)

If "vobiz" is not yet listed in your account config’s allowed_telephony_providers, contact your Vocobase account manager to enable it.

Get your Vobiz credentials

Go to vobiz.ai and sign in to your account.

Copy your Auth ID and Auth Token

From your account settings, copy your Auth ID and Auth Token.

Auth ID — identifier in the form MA_XXXXXXXX
Auth Token — alphanumeric string

Your Auth Token grants full access to your Vobiz account. Treat it like a password.

Identify the phone number you will call from

From your Vobiz account, copy the number you plan to use as the caller ID.The number must be in E.164 format (e.g., +918011223344) and must be enabled for outbound voice.

Configure Vobiz in Vocobase

Send the credentials through the V2 API.

This endpoint updates your default Vobiz connection. To create multiple named Vobiz connections, use POST /api/v2/telephony/connections and store the returned connection_id.

curl -X PUT https://api.vocobase.com/api/v2/config/telephony/vobiz \
  -H "Authorization: Bearer rg_live_abc123def456ghi789jkl012" \
  -H "Content-Type: application/json" \
  -d '{
    "auth_id": "MA_XXXXXXXX",
    "auth_token": "your_vobiz_auth_token",
    "from_number": "+918011223344"
  }'

const response = await fetch(
  "https://api.vocobase.com/api/v2/config/telephony/vobiz",
  {
    method: "PUT",
    headers: {
      "Authorization": "Bearer rg_live_abc123def456ghi789jkl012",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      auth_id: "MA_XXXXXXXX",
      auth_token: "your_vobiz_auth_token",
      from_number: "+918011223344"
    })
  }
);
const result = await response.json();
console.log(result);

import requests

response = requests.put(
    "https://api.vocobase.com/api/v2/config/telephony/vobiz",
    headers={
        "Authorization": "Bearer rg_live_abc123def456ghi789jkl012",
        "Content-Type": "application/json"
    },
    json={
        "auth_id": "MA_XXXXXXXX",
        "auth_token": "your_vobiz_auth_token",
        "from_number": "+918011223344"
    }
)
print(response.json())

A successful response confirms credentials were stored:

{
  "success": true,
  "data": {
    "auth_id": "MA_X****XXXX",
    "from_number": "+918011223344",
    "message": "Vobiz credentials updated successfully."
  }
}

Your Auth Token is encrypted at rest and never returned in API responses. The Auth ID is masked.

To rotate credentials later, send the same request again with the new values. Every field is required on each call — the endpoint replaces the stored credential set rather than patching it.

Confirm it is configured

GET /api/v2/config reports Vobiz under allowed_telephony_providers and shows telephony.vobiz.configured: true once your credentials are saved. See Check provider access.

Make a test call

Start an outbound call with "provider": "vobiz".

curl -X POST https://api.vocobase.com/api/v2/calls/start \
  -H "Authorization: Bearer rg_live_abc123def456ghi789jkl012" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "to_number": "+919876543210",
    "provider": "vobiz"
  }'

Vocobase manages the carrier connection and media path for Vobiz. Accounts only need to configure credentials and pass "provider": "vobiz" when starting calls. If your account has more than one active Vobiz connection, also pass connection_id — omitting it returns CONNECTION_AMBIGUOUS. See Bring Your Own Phone for the full request and response shape.

Optional: voicemail detection

For Vobiz outbound calls, supported accounts can enable carrier-side voicemail detection per agent. Set voicemail_detection_enabled to control detection for that agent. When Vobiz reports voicemail, Vocobase marks the call as voicemail and ends the call. The same agent field, voicemail_message, is accepted for API parity and for providers that can play a post-detection message. Vobiz currently uses the hangup behavior above.

Carrier-side voicemail detection must be enabled for your Vobiz connection by Vocobase before these agent settings affect live calls.

curl -X PUT https://api.vocobase.com/api/v2/agent/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer rg_live_abc123def456ghi789jkl012" \
  -H "Content-Type: application/json" \
  -d '{
    "voicemail_detection_enabled": true,
    "voicemail_message": "Hi, this is Priya from Acme Corp. I will call you back soon."
  }'

Troubleshooting

”Vobiz not configured” or 403 on `/calls/start`

Confirm "vobiz" is in allowed_telephony_providers from GET /config. If it is not, contact your Vocobase account manager.

401 from Vobiz during verification

Auth ID or Auth Token is wrong. Re-copy them from your Vobiz account settings.
If you recently rotated the Auth Token in Vobiz, send PUT /config/telephony/vobiz again with the new token.

Calls ring but drop immediately

Confirm the destination number is reachable from your Vobiz account. Some Vobiz accounts have geographic restrictions that require explicit enablement.
Check the Vobiz call logs for the exact reason the call was dropped (e.g., “Invalid from number”, “No route to destination”).

Caller ID shows the wrong number or “Unknown”

The from_number saved on your Vocobase Vobiz connection must match a number that Vobiz has provisioned for your account, in E.164 format. Update it via PUT /config/telephony/vobiz if it does not.

Next steps

Telephony Connections

Create and manage multiple named connections.

Plivo Setup

Configure Plivo as an additional telephony provider.

Quick Start

Create an agent and make your first call.

Getting Started

Building Agents

Making Calls

Receiving Calls

After the Call

Telephony Providers

Advanced

API Reference

Endpoints

Vobiz Setup

Vobiz Setup

Prerequisites

Get your Vobiz credentials

Configure Vobiz in Vocobase

Confirm it is configured

Make a test call

Optional: voicemail detection

Troubleshooting

”Vobiz not configured” or 403 on `/calls/start`

401 from Vobiz during verification

Calls ring but drop immediately

Caller ID shows the wrong number or “Unknown”

Next steps

Telephony Connections

Plivo Setup

Quick Start

​Vobiz Setup

​Prerequisites

​Get your Vobiz credentials

​Configure Vobiz in Vocobase

​Confirm it is configured

​Make a test call

​Optional: voicemail detection

​Troubleshooting

​”Vobiz not configured” or 403 on /calls/start

​401 from Vobiz during verification

​Calls ring but drop immediately

​Caller ID shows the wrong number or “Unknown”

​Next steps

Telephony Connections

Plivo Setup

Quick Start

Vobiz Setup

Prerequisites

Get your Vobiz credentials

Configure Vobiz in Vocobase

Confirm it is configured

Make a test call

Optional: voicemail detection

Troubleshooting

”Vobiz not configured” or 403 on `/calls/start`

401 from Vobiz during verification

Calls ring but drop immediately

Caller ID shows the wrong number or “Unknown”

Next steps