Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.vobiz.ai/llms.txt

Use this file to discover all available pages before exploring further.

Overview

Time to complete
~10 minutes
Difficulty
Beginner-Friendly (No Code)
Goal
Route 3CX calls via Vobiz
This guide shows how to connect 3CX - a popular software-based PBX - to Vobiz as a SIP trunk provider, enabling your 3CX phone system to make and receive calls through Vobiz numbers globally.
Integration flow:
OUTBOUND
3CX Extension
3CX PBX
Vobiz
Phone Network
INBOUND
Phone Network
Vobiz
3CX PBX
3CX Extension

Prerequisites

Vobiz Account with active balance → Create account
3CX installation - self-hosted or 3CX-hosted (v16, v18, or v20) → 3CX download
Admin access to the 3CX Management Console
A Vobiz phone number purchased or ported → Phone Numbers

Part 1: Vobiz setup

Create a SIP trunk

  1. Log in to the Vobiz Console
  2. In the left sidebar, navigate to SIP Trunk > Outbound Trunks > Trunks
  3. Click + Create Trunk
  4. Enter a Trunk Name (for example, “3CX Integration”) and an optional Description
  5. Under Authentication & Linking, select a Credential from the Credentials List - or click + Create New Credential if you don’t have one yet
  6. Click + Create Trunk to save
After creating the trunk, copy the following values from the Authentication & Linking section - you will paste these into 3CX in the next step:
FieldDescription
SIP Domain<your_unique_domain>.sip.vobiz.ai
UsernameYour SIP credential username
PasswordYour SIP credential password
You now have a Vobiz SIP trunk ready to accept registrations from 3CX.

Configure inbound routing (optional)

If you want 3CX to receive inbound calls on your Vobiz number, you need to point the trunk’s inbound destination to your 3CX SIP URI.
  1. In the Vobiz Console, go to your trunk and note the Inbound Destination field.
  2. You will fill this in after completing the 3CX setup in Part 2.

Part 2: 3CX setup

Add Vobiz as a SIP trunk

  1. Open the 3CX Management Console (typically at https://your-3cx-host:5001)
  2. In the left sidebar, go to SIP Trunks
  3. Click Add SIP Trunk
  4. Under Country, select your country
  5. Under Main Trunk No., enter your Vobiz phone number in E.164 format (for example, +918071387434)
  6. Under Provider in your Country, choose Generic (scroll to the bottom of the list if it is not immediately visible)
  7. Click OK to proceed to the trunk configuration form

Configure the trunk details

Fill in the following fields on the trunk configuration page:
3CX FieldValue
NameVobiz (or any label you prefer)
Registrar / ServerYour Vobiz SIP Domain (e.g., abc123.sip.vobiz.ai)
Outbound ProxyLeave blank
Number of SIM callsSet based on your Vobiz concurrency limit
Authentication ID (SIP User ID)Your Vobiz credential Username
Authentication PasswordYour Vobiz credential Password
Main Trunk No.Your Vobiz phone number in E.164 format
Do not include sip: or any URI scheme in the Registrar / Server field. Enter only the hostname (e.g., abc123.sip.vobiz.ai).

Configure outbound caller ID

Under the Outbound Parameters tab:
  • Set Outbound Caller ID to your Vobiz phone number in E.164 format
  • Leave Outbound Call Routing as the default unless you have a custom dial plan

Save and apply

Click OK to save the trunk. 3CX will attempt to register with the Vobiz SIP server. The trunk status should turn green (registered) within a few seconds.
A green trunk status confirms that 3CX has successfully registered with Vobiz.

Part 3: Configure inbound DID

To route inbound calls from your Vobiz number to a 3CX extension or ring group:
  1. In the 3CX Management Console, go to DIDs
  2. Click Add DID
  3. Set DID number to your Vobiz phone number (E.164 format)
  4. Set Destination to the extension, ring group, or IVR that should answer inbound calls
  5. Select the Vobiz trunk from the Trunk dropdown
  6. Click OK to save

Point Vobiz inbound to 3CX

Now go back to the Vobiz Console and update your trunk’s inbound destination to your 3CX SIP URI:
  1. In the Vobiz Console, open your trunk
  2. Find the Inbound Destination field
  3. Enter your 3CX SIP URI - this is the public IP or hostname of your 3CX server (for example, your-3cx.example.com or the IP address of the 3CX host)
  4. Save the trunk
For 3CX cloud-hosted installations, use the SIP domain shown in Settings > SIP within the 3CX console. For self-hosted, use the public IP or FQDN of your 3CX server.

Part 4: Test the integration

Test outbound calling

  1. Pick up a 3CX extension (desk phone, softphone, or the 3CX mobile app)
  2. Dial an external number in full E.164 format or using your standard dial plan
  3. The call should route through Vobiz and connect

Test inbound calling

  1. Call your Vobiz phone number from an external phone
  2. The call should ring on the 3CX extension or ring group you configured in the DID settings

Troubleshooting

Trunk shows “Not Registered” or red status

CauseFix
Incorrect SIP DomainEnsure the Registrar field contains only the hostname without sip: (e.g., abc123.sip.vobiz.ai)
Wrong credentialsDouble-check the Username and Password from the Vobiz Console
Firewall blocking SIPEnsure UDP port 5060 and RTP ports 9000–10999 are open outbound from the 3CX server
NAT issuesIn 3CX, go to Settings > Network and enable STUN or enter your public IP

Outbound calls fail or get “no route” error

  • Verify the Outbound Caller ID matches your Vobiz phone number exactly (E.164)
  • Check that the Outbound Call Routing rule includes a Vobiz trunk as the provider
  • Confirm your Vobiz account has sufficient balance

Inbound calls do not reach 3CX

  • Confirm the Vobiz trunk Inbound Destination points to the correct 3CX public IP or domain
  • Make sure the DID in 3CX matches the incoming number format (E.164)
  • Check that UDP port 5060 is open inbound on your 3CX server or firewall

SIP 401 Unauthorized

  • Verify credentials in the Vobiz Console under SIP Trunk > Credentials
  • Ensure the 3CX trunk Authentication ID matches the Vobiz credential Username exactly

Quick reference

SettingWhere to get itWhere to paste it
SIP DomainVobiz Console > Trunk3CX Trunk > Registrar / Server
UsernameVobiz Console > Credentials3CX Trunk > Authentication ID
PasswordVobiz Console > Credentials3CX Trunk > Authentication Password
Vobiz phone numberVobiz Console > Phone Numbers3CX Trunk > Main Trunk No. and DID
3CX public IP / domain3CX Settings > NetworkVobiz Trunk > Inbound Destination

Resources

Vobiz 3CX Support
Integration complete!Your 3CX phone system can now make and receive calls through Vobiz across 130+ countries.