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
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
- Log in to the Vobiz Console
- In the left sidebar, navigate to SIP Trunk > Outbound Trunks > Trunks
- Click + Create Trunk
- Enter a Trunk Name (for example, “3CX Integration”) and an optional Description
- Under Authentication & Linking, select a Credential from the Credentials List - or click + Create New Credential if you don’t have one yet
- Click + Create Trunk to save
| Field | Description |
|---|---|
| SIP Domain | <your_unique_domain>.sip.vobiz.ai |
| Username | Your SIP credential username |
| Password | Your 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.- In the Vobiz Console, go to your trunk and note the Inbound Destination field.
- You will fill this in after completing the 3CX setup in Part 2.
Part 2: 3CX setup
Add Vobiz as a SIP trunk
-
Open the 3CX Management Console (typically at
https://your-3cx-host:5001) - In the left sidebar, go to SIP Trunks
- Click Add SIP Trunk
- Under Country, select your country
-
Under Main Trunk No., enter your Vobiz phone number in E.164 format (for example,
+918071387434) - Under Provider in your Country, choose Generic (scroll to the bottom of the list if it is not immediately visible)
- Click OK to proceed to the trunk configuration form
Configure the trunk details
Fill in the following fields on the trunk configuration page:| 3CX Field | Value |
|---|---|
| Name | Vobiz (or any label you prefer) |
| Registrar / Server | Your Vobiz SIP Domain (e.g., abc123.sip.vobiz.ai) |
| Outbound Proxy | Leave blank |
| Number of SIM calls | Set based on your Vobiz concurrency limit |
| Authentication ID (SIP User ID) | Your Vobiz credential Username |
| Authentication Password | Your Vobiz credential Password |
| Main Trunk No. | Your Vobiz phone number in E.164 format |
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:- In the 3CX Management Console, go to DIDs
- Click Add DID
- Set DID number to your Vobiz phone number (E.164 format)
- Set Destination to the extension, ring group, or IVR that should answer inbound calls
- Select the Vobiz trunk from the Trunk dropdown
- 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:- In the Vobiz Console, open your trunk
- Find the Inbound Destination field
-
Enter your 3CX SIP URI - this is the public IP or hostname of your 3CX server (for example,
your-3cx.example.comor the IP address of the 3CX host) - 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
- Pick up a 3CX extension (desk phone, softphone, or the 3CX mobile app)
- Dial an external number in full E.164 format or using your standard dial plan
- The call should route through Vobiz and connect
Test inbound calling
- Call your Vobiz phone number from an external phone
- 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
| Cause | Fix |
|---|---|
| Incorrect SIP Domain | Ensure the Registrar field contains only the hostname without sip: (e.g., abc123.sip.vobiz.ai) |
| Wrong credentials | Double-check the Username and Password from the Vobiz Console |
| Firewall blocking SIP | Ensure UDP port 5060 and RTP ports 9000–10999 are open outbound from the 3CX server |
| NAT issues | In 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
| Setting | Where to get it | Where to paste it |
|---|---|---|
| SIP Domain | Vobiz Console > Trunk | 3CX Trunk > Registrar / Server |
| Username | Vobiz Console > Credentials | 3CX Trunk > Authentication ID |
| Password | Vobiz Console > Credentials | 3CX Trunk > Authentication Password |
| Vobiz phone number | Vobiz Console > Phone Numbers | 3CX Trunk > Main Trunk No. and DID |
| 3CX public IP / domain | 3CX Settings > Network | Vobiz Trunk > Inbound Destination |
Resources
Vobiz 3CX Support- Vobiz: support@vobiz.ai
- 3CX: 3cx.com/support
Integration complete!Your 3CX phone system can now make and receive calls through Vobiz across 130+ countries.