Docs

Connections

Set up a SIP trunk

Set up a SIP trunk to connect your phone system or carrier to your agents. It is encrypted and needs no username or password.

A SIP trunk connects your own phone system or carrier to your agents. An AI receptionist then answers calls to numbers that you already have. The connection is encrypted. Nuteq AI accepts a trunk call based on the public IPv4 address that it comes from. There is no SIP username or password.

Before you start

You need these things before you create a trunk:

  • The owner or admin role in your Nuteq AI business. Members can view trunks. They cannot change a trunk or run a test call.
  • An active agent for each number.
  • A person who can change the settings of your phone system, your carrier account, and your firewall.

Nuteq AI must also turn on SIP trunks for your business. If a test call says that SIP trunks are not on, contact support.

Which settings does your phone system need?

Your phone system sends each call to Nuteq AI with these settings. The Carrier settings card on the SIP trunks page shows the same values. You can copy most of them from there.

SettingValueWhat it means
SIP serversip.nuteqai.com:5061Send calls here over TLS.
TLS server name (SNI)sip.nuteqai.comYour phone system names this server when it opens the encrypted connection.
TransportTLS 1.2 or newer over TCPNuteq AI does not accept calls over plain UDP or TCP.
Media encryptionSRTP with SDES keys, AES_CM_128_HMAC_SHA1_80Nuteq AI refuses calls without encrypted audio.
Audio codecsG.711 u-law (PCMU) or A-law (PCMA)Offer at least one of the two.
Called number format+E.164, for example +15550100100Send the dialed number in the Request-URI or To header.
Audio portsUDP 10000-10399Allow audio to and from these ports on Nuteq AI.

How Nuteq AI reads the called number

Nuteq AI picks the agent from the number that your phone system dials. The number must match a row under Phone numbers. Nuteq AI reads the number from the Request-URI first. It reads the To header only if the Request-URI has no number.

Send the number in +E.164 format: a plus sign, the country code, and the number with no spaces. Example: +15550100100.

Nuteq AI never uses the From header to choose a number or an agent. The caller's own number does not change where the call goes.

How call audio travels

Nuteq AI sends and receives call audio directly with the media address that your phone system puts in its call offer. There is no relay.

  • The media address must be a public IPv4 address. Nuteq AI refuses an offer that asks for audio at a private address, such as 192.168.1.20.
  • The media address can differ from the address that sends the call. Example: your carrier uses a separate media gateway.
  • Nuteq AI sends audio to the exact address and port in the call offer. It does not switch to the address or port that your audio arrives from.
  • If your phone system is behind a router that translates addresses (NAT), the router must keep each audio port the same on the public side. Example: give your phone system a small fixed range of audio ports. Forward each port to it unchanged.
  • Your firewall must let UDP audio travel in both directions between your media address and Nuteq AI ports 10000 to 10399. If a call is answered but no audio reaches Nuteq AI, check the firewall first.

How requests during a call travel

After Nuteq AI answers, your phone system and Nuteq AI send each other requests during the call. Examples are hold and hang up.

  • Your phone system sends its requests to the address in Nuteq AI's Record-Route header. Nuteq AI accepts them if your phone system keeps the name sip.nuteqai.com or replaces it with Nuteq AI's IP address. In Asterisk, the rewrite_contact setting can be on or off.
  • Nuteq AI sends its own requests, such as a hang up from your agent, over the encrypted connection that your phone system opened. This works if the address in your phone system's Contact header is private or public. Your phone system does not need to accept incoming connections from Nuteq AI. In Asterisk, external_signaling_address can be set or unset.
  • Keep that connection open for the whole call. If it closed, Nuteq AI opens a new connection to the Contact address. This works only if your phone system accepts encrypted connections there.

Which source IP addresses can you add?

Source IP ranges are the public IPv4 addresses that your carrier or phone system sends calls from. Nuteq AI refuses calls from any other address. Each range follows these rules:

  • A range is one address, such as 203.0.113.10, or a network no wider than /24, such as 203.0.113.0/24.
  • Write a network with its first address. Nuteq AI accepts 203.0.113.0/24. It does not accept 203.0.113.7/24.
  • You cannot add private addresses, reserved addresses, or IPv6 addresses.
  • Ranges on one trunk cannot overlap.
  • Two active trunks of your business cannot use overlapping ranges.
  • Other businesses can use the same address. This is normal for a carrier that sends many customers' calls from the same addresses. The number that the caller dialed decides which trunk answers.

Only one active trunk in Nuteq AI can answer a phone number. If the page says that another active SIP trunk of yours uses a range, or that a trunk uses a number, turn that trunk off or contact support.

One trunk holds up to 20 ranges and 100 phone numbers. A business can have up to 50 trunks.

Set up the trunk

  1. Collect the public IPv4 addresses that your phone system or carrier sends calls from. Collect the numbers that you want your agents to answer.
  2. Open the SIP trunks page in your dashboard, at the address that ends in /dashboard/settings/sip-trunks. The page has no tab in Settings. Click New trunk and enter a Trunk name, such as "Head office phone system".
  3. Under Source IP ranges, enter each address or network. Click Add range for more rows.
  4. Under Phone numbers, enter each number with its country code. Choose the agent that answers it. Click Add phone number for more rows.
  5. Click Save draft. A draft trunk accepts no calls.
  6. Give the values in the Carrier settings card to the person who manages your phone system or carrier account. Open the audio ports in your firewall.
  7. Click Activate. The button is available when the saved draft has at least one range and one number, and has no unsaved changes. Activation starts to answer calls from these IP ranges at once.
  8. In the Test call card, choose a number under Number to call. Click Start test call.
  9. When the card says "Call +15550100100 now from your phone system." (with your number), call that number through the trunk within 15 minutes.
  10. Stay on the line until your agent speaks. Then hang up. After Nuteq AI checks the call, the card shows "Ready. Calls to this trunk reach your agent."

If Nuteq AI refuses the test call or the call does not finish, the card shows what went wrong and what to change. Read SIP trunk test call results explains every message.

What does Ready mean?

Ready means that a test call to one of the trunk's numbers went all the way through:

  • The call came from an allowed address, matched an agent, and was answered.
  • Audio traveled in both directions.
  • Your agent spoke.
  • Nuteq AI saved the call.

A trunk that is on but has not passed a test call shows Active, not Ready.

An active trunk answers calls with or without Ready. Run a test call before real callers use the trunk.

Ready goes away when you change the trunk's ranges or numbers, deactivate the trunk, or activate it again. A new test call brings it back. A rename keeps Ready.

A test call checks one number. Test the other numbers too if they use different agents or come through a different carrier.

Which greeting and voice does a trunk call use?

A trunk call uses the agent's call settings, such as the greeting, voice, and language. If the agent also answers a Nuteq AI phone number, a trunk call uses the same settings as that number. Otherwise, it uses the settings that you choose in the agent editor.

Change, deactivate, or delete a trunk

  • Change. You can change an active trunk and click Save changes. The change applies to the next call. A call in progress continues. Saving also ends any open test call. A change to the ranges or numbers removes Ready until a new test call passes.
  • Deactivate. Nuteq AI stops answering new calls from the trunk at once. After you activate it again, the trunk needs a new test call.
  • Delete. Nuteq AI stops calls at once and removes the trunk's settings. You cannot undo this.

Deactivate and delete ask you to confirm first.

A trunk that was set up earlier with a SIP username and password shows Unsupported legacy. You can only delete it. Then add an IP-authenticated trunk in its place.

What do SIP trunks not support?

A SIP trunk carries calls in one direction: from your phone system to your agents. Nuteq AI does not support:

  • Registering with a SIP username and password. Nuteq AI refuses registration requests. Your phone system must send calls without registering.
  • Plain SIP over UDP or TCP on port 5060, and unencrypted audio (plain RTP). Nuteq AI accepts only TLS on port 5061 with SDES-SRTP.
  • Audio codecs other than PCMU and PCMA, such as Opus.
  • IPv6 addresses for calls, audio, or source ranges.
  • Outgoing calls from Nuteq AI through your trunk.
  • Transfers of a trunk call back into your phone system.

Which phone systems and carriers were tested?

Each phone system or carrier has one of three statuses:

  • Verified. Nuteq AI completed a test call with it, using the settings on this page.
  • Known limitation. It cannot work with a Nuteq AI SIP trunk, as the notes explain.
  • Untested. Nuteq AI did not test it. It may work if it meets every setting above. Nuteq AI has not confirmed it.

Only Asterisk 22.10.1 is verified, and only with the settings in its notes. Other Asterisk versions and the other phone systems and carriers below are untested. The exceptions are the rows marked as a known limitation.

Phone system or carrierStatusNotes
Asterisk 22.10.1 (PJSIP)verifiedTLS transport with method tlsv1_2, verify_server on, and the system certificate list. Endpoint with media_encryption sdes, allow ulaw and alaw, rtp_symmetric, force_rport, and direct_media off. Behind NAT, external_media_address set to the public address and a fixed audio port range forwarded unchanged. Tested with rewrite_contact and external_signaling_address both off and both on, with PCMU and PCMA, hold and resume, and hang up from either side.
Asterisk, other versionsuntested
FreePBXuntested
FreeSWITCHuntested
3CXuntested
Cisco Unified Border Element (CUBE)untested
Twilio Elastic SIP Trunkinguntested
Telnyx SIP trunkinguntested
Bandwidthuntested
Any system that can only register with a username and passwordknown limitationNuteq AI does not accept registration.
Any system that can only send plain SIP on port 5060 or unencrypted audioknown limitationNuteq AI accepts only TLS on port 5061 with SDES-SRTP.
Any carrier that sends calls from ranges wider than /24known limitationEach range can be no wider than /24.

Get help with a trunk

Each call in the Test call card shows a Call-ID for support. This is the identifier that your phone system gave the call. When you contact support, send:

  • The Call-ID.
  • The trunk name.
  • The number you called.
  • The time of the call.
  • The message that the card showed.

Support can find the same call from the Call-ID.

By Nuteq AI TeamPublished Updated 9 min read

Was this page helpful?

Keep reading

Frequently asked questions

Does a Nuteq AI SIP trunk need a SIP username and password?
No. Nuteq AI accepts a trunk call based on the public IPv4 address that it comes from. Your phone system sends calls without registering. A trunk that was set up earlier with a username and password shows Unsupported legacy. You can only delete it.
Which audio settings does a SIP trunk require?
TLS 1.2 or newer to sip.nuteqai.com on port 5061, SRTP with SDES keys using AES_CM_128_HMAC_SHA1_80, and G.711 u-law or A-law audio. Nuteq AI refuses plain SIP, plain RTP, other codecs, and IPv6.
What does Ready mean on a trunk?
Ready means that a test call to one of the trunk's numbers went all the way through. The call came from an allowed address, your agent spoke, and Nuteq AI saved the call. A trunk that is on but not tested shows Active.

Ready to stop missing calls?

Nuteq AI answers every call and text, books appointments, and captures every lead — 24/7.