What you get, and what you bring#
When managed provisioning is available and completes successfully, your organization receives a telephony configuration named Menace Voice Cloudonix SIP. It provides a SIP domain connected to the Menace Voice pipeline without requiring your own Cloudonix account. Check that this configuration exists and its setup checklist is complete before relying on managed SIP.
What it does not include is phone service. Menace Voice does not sell or resell phone numbers, and no calls flow until you connect a carrier:
| Menace Voice provides | You provide |
|---|---|
| A SIP domain and its inbound SIP endpoint | A SIP trunk from your carrier, or your own PBX |
| A fixed outbound origin IP to allow on your side | Phone numbers (DIDs) on that trunk |
| The voice agent runtime on both call directions | Any per-minute charges your carrier bills |
Until you finish the steps below, Menace Voice Cloudonix SIP cannot place a call. The configuration page shows a setup checklist that tracks exactly which of these steps are still outstanding.
Don't have a SIP trunk or PBX? This page is not the shortest path. Open an account with a telephony provider instead — see Telephony Integration for the list — and you can be calling in a few minutes with no SIP configuration at all.
If you would rather bring your own Cloudonix account instead of using the provisioned domain, follow Cloudonix Integration and add a separate configuration. Self-hosted deployments can also connect their own Asterisk via Asterisk ARI.
Prerequisites#
- A SIP trunk from a carrier (or a PBX such as Asterisk or FreeSWITCH) that can accept calls from a fixed IP address and send calls to a hostname
- At least one phone number (DID) on that trunk
- Permission to change the trunk's IP allowlist and routing on the carrier side
Step 1: Read your SIP endpoints from Menace Voice#
- Go to Telephony configurations and open Menace Voice Cloudonix SIP
- Expand SIP connectivity
- Choose the region closest to your carrier —
Global,India, orUAE. Every value on the panel is region-specific, so set this first - Note the two values you will need on the carrier side:
- Inbound hostname and ports — where your carrier sends calls to Menace Voice
- Outbound origin IP address — the address Menace Voice's calls arrive from
Step 2: Point your carrier at Menace Voice (inbound)#
On your carrier or PBX, route your DIDs to the inbound hostname and port shown in SIP connectivity. UDP and TCP share one port; TLS uses a separate one.
This is the direction that makes your agent answer calls.
Step 3: Create the outbound trunk (outbound)#
Menace Voice needs to know where to send calls when your agent dials out.
- On your carrier, allow the origin IP address from Step 1 to send SIP traffic to your trunk. Calls from Menace Voice are unauthenticated and identified by source IP, so this step is required
- Back in Menace Voice, under Outbound trunks, choose Add trunk and fill in:
- Name — any name you choose. Letters, digits and hyphens only
- SIP domain — the hostname of your carrier or PBX, for example
sip.example.com. Menace Voice puts this in both the SIPToheader and the Request-URI - Region — the edge Menace Voice dials your carrier from. The dialog shows the origin IP that region uses, which is the one to allowlist above
- Leave Enabled on and choose Save trunk
You can add more than one trunk — a second carrier, or a failover. Each keeps its own region, and each lists the numbers that dial out over it.
Without an enabled outbound trunk, outbound calls have nowhere to go. This is the most common reason a test call from the agent editor fails.
Step 4: Add your phone numbers#
Cloudonix requires a caller ID on every outbound call and rejects the call without one, so this step is required even if you only care about inbound.
- Choose Add number on the trunk whose carrier gave you the number — the trunk is then filled in for you. (Add phone number further down works too; there you pick the Outbound trunk yourself, or leave it unset for a number that belongs to no trunk.)
- Enter a number your carrier delivers to you, in
E.164 format —
+, country code, then the number, with no spaces or dashes, for example+14155550123 - Mark the number you want outbound calls to present as the default caller ID
Add every DID you intend to use. A number your carrier does not own will be rejected by the carrier even though Menace Voice accepts it — which is why the trunk assignment matters as soon as you have more than one carrier. With a single trunk, Menace Voice uses it for every number and the field can be left alone.
Step 5: Route inbound calls to an agent#
Only needed if you want to receive calls.
- In the Phone numbers section, edit the number that should be answered
- Set its Inbound workflow to the agent that should pick up
- Save
Menace Voice pushes the inbound webhook URL to the Voice Application on the provisioned domain automatically. You still need the DID bound to that application — see Step 2 of the Cloudonix inbound setup.
Step 6: Place a test call#
- Open an agent, and make sure it is saved with no validation errors
- Choose Phone Call
- Select Menace Voice Cloudonix SIP, pick your caller ID, enter a destination number, and start the call
Troubleshooting#
'Not ready for outbound calls' when starting a call
The setup checklist on the configuration page names the missing step. The two blocking ones are an enabled trunk (Step 3) and at least one phone number (Step 4).
Outbound calls fail immediately at the carrier
- Confirm the origin IP from SIP connectivity is allowed on your trunk
- Confirm the SIP domain on the trunk resolves and accepts SIP on the port your carrier expects
- Confirm the caller ID you are dialing from is a number your carrier actually owns — many carriers reject unowned caller IDs
Inbound calls never reach the agent
- Confirm your carrier is sending to the inbound hostname and port for the region selected on the panel, not another region's
- Confirm the called number exists in the Phone numbers list and has an Inbound workflow assigned
- Confirm the DID is bound to the Voice Application on the domain
You changed regions after setup
The inbound hostname, ports, and outbound origin IP all change with the region. Each trunk carries its own Region, so edit the trunk to move it, then update your carrier with the new values.