Skip to content
EN
Open app

For AI assistants: this page as plain markdown is at https://docs.voicelogica.ai/raw/telephony/your-own-carrier.md, and https://docs.voicelogica.ai/llms.txt lists the docs by topic, one file each, small enough to read whole. Read those rather than this HTML page.

Your own carrier

8 min read
Copy as Markdown
View as MarkdownOpen the raw .md file.md

Use this when the numbers already live at your carrier or PBX. Telephony - Trunks - + Add Trunk opens the New SIP Trunk drawer. The agent’s Channels - Telephony tab can open the same flow with + Add SIP trunk, then picks which numbers this agent answers.

A trunk without numbers still leaves the agent silent. A trunk with numbers and no default (and no inbound route) leaves callers ringing. Both sides have to be done.

Telephony Trunks with Add Trunk
byoc-trunksExpand

The drawer asks How do you connect? Pick the shape that matches the other side - the type cannot change after save.

VOIP provider
Connect numbers from carriers like Yuboto, Telnyx, or Twilio. Provider can be a named preset or Custom / manual setup (presets prefill host, port, transport).
Public IP PBX
Voice Logica signs in on a PBX with a public IP reachable from the internet.
Local IP PBX
The PBX is on a LAN. Download the connector, wait until it is live, then enter the PBX IP. See Edge device.
Incoming PBX
Their phone system registers here so you can take their calls.
Microsoft Teams
Teams Phone calls reach your AI agent. Pair it in Microsoft 365 after the trunk exists.
New SIP Trunk drawer How do you connect
your-own-carrier-formExpand

The drawer has General and Advanced tabs. On General, after you pick a type, fill at least:

Trunk NameREQUIRED
Name it after the carrier, not “SIP Trunk 1”.
Provider
Preset or Custom / manual setup.
Host / IP AddressREQUIRED
Where to register or send SIP.
Default Phone Number
Optional default DID on the trunk.
UsernameREQUIRED
SIP username.
Login (Authorization ID)
Authorization ID when the provider splits login from username.
PasswordREQUIRED
SIP password.
AI agent / Destination
Where unrouted calls land (this agent, a user, group, and so on).
Max Channels
Concurrent calls on this trunk, inbound and outbound together. Leave it empty for unlimited. At the cap, a new inbound call gets busy (486 Busy Here), and campaigns wait for a free channel without using a lead attempt.
Trunk enabled
Leave on when you are ready for registration.

Advanced (only if the provider asked): Connection type, Port, Transport, SIP Contact host, Domain, From Domain, Outbound Proxy, Allowed RTP source IPs. The Advanced tab also carries:

Registration expiry (seconds)
How long we ask the provider to keep the registration (60–86400 s). We always renew earlier. Shown on registering trunks.
Pick Up Delay (seconds)
Seconds an inbound call rings before the AI answers, so a human extension can pick up first. 0 answers immediately, max 60.
Outside-line prefix
Digit your PBX puts in front of outside numbers (usually 0). It is stripped from inbound caller numbers and added back on calls out through this trunk.
SRTP (encrypted media)
Offer encrypted media (SDES SRTP) on outbound calls, falling back to plain RTP if the peer refuses. Turn on when the peer expects it.

Two further trunk settings exist on the connection but are not shown in this drawer - they are set through the API / Claude MCP: blocking outbound calls to international numbers outside Greece and Cyprus, and a pre-answer inbound webhook (a CALL_INBOUND POST whose response can override the agent, welcome message, context and variables before the call is answered).

Before the first REGISTER, whitelist Voice Logica in the far-end SIP / firewall when the provider requires it (IPs are shown in product settings).

Default destination - where unrouted calls land

Section titled “Default destination - where unrouted calls land”

A trunk without a destination leaves callers ringing when no inbound override exists. Set destination to this AI agent (or a user / group / conference / external number).

On the agent tab, sending unrouted calls to this agent does the same job from the other side.

First setup - trunk, numbers, then this agent

Section titled “First setup - trunk, numbers, then this agent”
  1. Whitelist required IPs on the carrier / PBX when asked.

  2. Telephony - Trunks - + Add Trunk (or agent + Add SIP trunk)

    Pick the type, fill General fields, set destination = this agent, enable, Create Trunk.

  3. Manage numbers

    Add the DIDs on the trunk. A trunk with no numbers cannot connect anything on the agent tab.

  4. Wait until registration shows online (provider trunks)

    Use SIP logs on the row if it stays offline.

  5. Agent - Channels - Telephony

    Connect numbers to this agent, or send unrouted calls here if every number on the trunk should land on this agent.

  6. Call in from a real phone

    Open Calls. Do not add inbound routes until a second number needs a different landing.

  1. Add Trunk / Add SIP trunk and pick Microsoft Teams.
  2. Name it and create it. Your dedicated SBC address appears after create.
  3. Follow How to connect Microsoft Teams in the trunk settings (Microsoft 365 checklist).

Use a Telnyx credentials-based SIP Connection.

FieldValue
Hostsip.telnyx.com (or sip.telnyx.eu for the EU region)
Port / transport5060, UDP
Username / passwordthe Credentials of that SIP Connection in the Telnyx portal
  • One device per connection. Telnyx keeps only one active registration per credentials-based connection. If the same credentials are also used on a softphone, desk phone, PBX or another platform, whichever registered last wins and this trunk keeps dropping. Give every device its own Telnyx SIP Connection (Telnyx).
  • Registration is for incoming calls. Telnyx needs it only to send calls to you; outgoing calls authenticate on their own (Telnyx).
  • 403 from Telnyx means wrong credentials or a disabled SIP Connection or account (Telnyx).

A trunk can move to another company with its numbers, caller IDs and outbound routes. The stored SIP password moves with it, so nothing is re-entered.

  1. Go to Telephony - Trunks and open the trunk’s menu.
  2. Choose Move to another company, pick the Company and press Move trunk.
  3. Calls on the line pause for a few seconds while it registers again. Its numbers then ring the new company’s AI agent; change that in Routing.

If the move stops with The move was interrupted, the trunk is back on its line in the old company. Press Move trunk again: the retry finishes the move and routes the numbers that already reached the new company.

Who can move a trunk: Voice Logica admins, account managers between their own and granted companies (a demo company is also accepted), and resellers between their own clients. No company you can move this trunk to means you have no access to another company.

Through the MCP connector: telephony_query action list_sip_trunk_move_targets lists the companies, and telephony_execute action move_sip_trunk (sipTrunkId, targetCompanyId) moves it.

Why does my SIP trunk registration stay offline?

The credentials are wrong, the carrier or PBX has not allowed our IPs, or the trunk is disabled. Check the SIP logs on the trunk row in Telephony - Trunks.

Why does my SIP trunk register, then keep getting rejected with 401?

If the trunk registers for a while and then the carrier answers 401 Unauthorized again and again, the password is right: a wrong password never registers at all. Almost always the same SIP account is also registered somewhere else (a softphone, desk phone, an old PBX or another platform), and the carrier keeps only one registration.

  1. Remove these credentials from every other device, or ask the carrier for a separate account for this trunk.
  2. If nothing else uses them, create a new password at the carrier and enter the same password on the trunk here.

After repeated rejections we pause the trunk and retry automatically (5 minutes, then longer), so the carrier does not block the account. Your company’s notification email gets a Registration paused message with the likely cause. A successful registration recovers the trunk on its own. For Telnyx, see Telnyx above.

Why is Connect a number missing, or the numbers drawer empty, on my agent?

The trunk has no numbers (DIDs), or it is disabled. Add the numbers under the trunk’s Manage numbers first, and make sure the trunk is enabled.

Why does the wrong agent answer calls on my SIP trunk?

The trunk’s default destination or an inbound override points elsewhere. Fix the default, or connect the number on the agent you want: each number answers one agent.