Vobiz
Set up Vobiz as your telephony provider for SIP-based outbound and inbound voice calls with zoxaAI.
What you'll learn
How to configure Vobiz as a telephony provider in zoxaAI, including the automatic application creation feature, credential setup, and the phone number format requirement.
Vobiz
Vobiz is a SIP-based communications provider. zoxaAI integrates with Vobiz for both outbound and inbound calling using its XML-based call control and bidirectional audio streaming.
Provider Details
| Feature | Value |
|---|---|
| Provider name | vobiz |
| Audio format | mulaw |
| Sample rate | 8,000 Hz |
| Call transfer | No |
| Auto-create application | Yes |
| Webhook signature verification | Yes (HMAC-SHA256 body signature) |
| Account ID field | auth_id |
Prerequisites
- A Vobiz account
- At least one Vobiz phone number
Credentials
| Field | Where to Find It | Sensitive | Required | Description |
|---|---|---|---|---|
| Account ID | Vobiz dashboard | Yes | Yes | Your Vobiz Account ID (e.g., MA_SYQRLN1K) |
| Auth Token | Vobiz dashboard | Yes | Yes | Your Vobiz Auth Token for API authentication |
| Application ID | Vobiz dashboard > Applications | No | No | A Vobiz Application ID. If left blank, zoxaAI auto-creates one on save. |
Setup
Open the Telephony Page
Navigate to Telephony in the zoxaAI sidebar.
Add a New Configuration
Click Add Configuration. Select Vobiz from the provider dropdown.
Enter Your Credentials
Paste your Account ID and Auth Token from the Vobiz dashboard.
Application ID is optional. If you leave it blank, zoxaAI automatically creates a Vobiz Application for you (see below).
Name and Save
Give the configuration a name (e.g., "Vobiz Production") and click Save.
Add Phone Numbers
Right after you save, zoxaAI opens the new configuration and fetches the voice numbers on your Vobiz account. Click Add next to the ones you want, or Add all. You can fetch again any time with Fetch from Vobiz in the Phone Numbers section.
To add a number by hand instead, click Add phone number and enter it in E.164 format:
+919876543210Only active voice numbers owned by this account are listed (not sub-account numbers). A number linked to a different Vobiz application shows an info icon: outbound calls work, but inbound calls reach zoxaAI only after you link the number to this configuration's application.
Phone number format
Enter numbers with or without the + prefix (+919876543210 or 919876543210); zoxaAI strips the + when it calls the Vobiz API. The + form is recommended for consistency with the other providers, and it is what Fetch from Vobiz adds.
Auto-Created Application
When you do not provide an Application ID, zoxaAI automatically creates a Vobiz Application during the save process. The auto-created application has:
- App name:
zoxa-<random-id>(e.g.,zoxa-a3b2c1d4e5f6) - Answer URL:
https://your-domain.com/api/v1/telephony/run - Answer method: POST
This means inbound calls work immediately for any number linked to the auto-created application.
Outbound Calls
Vobiz outbound calls use its REST API with XML-based call control. Audio is streamed bidirectionally over WebSocket in audio/x-mulaw;rate=8000 format.
| Source | Description |
|---|---|
| Test calls | Place a test call from the agent editor |
| API calls | Use POST /api/v1/call with your API key |
| Campaigns | Bulk outbound dialing across a contact list |
Inbound Calls
Vobiz fully supports inbound calling. If you used the auto-created application, inbound calls work immediately.
If you are using a pre-existing Application, configure it manually:
Open Vobiz Dashboard
Go to the Vobiz dashboard and navigate to your Application settings.
Assign an Agent
In the zoxaAI dashboard, go to Telephony > your Vobiz configuration and open the phone number (or add it). Select the agent that should answer in the Inbound target dropdown and save. You can also bind the number to an agent through the API with POST /api/v1/call and type: "inbound".
See Inbound Calling for the full inbound routing guide.
Signature Verification
Vobiz uses HMAC-SHA256 signature verification on the raw request body. zoxaAI verifies this automatically using your stored Auth Token. No additional configuration is required.
Troubleshooting
| Issue | Cause | Solution |
|---|---|---|
| Auto-create fails on save | Invalid Account ID or Auth Token | Verify your credentials in the Vobiz dashboard |
| Inbound calls not routing | Number not linked to the Vobiz Application | In the Vobiz dashboard, assign the number to the auto-created (or manually configured) application |
| Phone numbers not matching | Numbers include + prefix | Remove the + prefix from all Vobiz phone numbers |
| Outbound calls fail | No phone numbers added | Add at least one Vobiz number without the + prefix |