Skip to main content
Use Carrier import to connect numbers from Twilio, Telnyx, Zadarma or Vonage automatically. For a manually managed trunk, pick your carrier’s guide and follow the setup checklist below. For provider-specific FQDN direction, inbound authentication, and signaling allowlists, open the SIP provider guides.

Setup checklist

  1. In Settings → Phone numbers → Add a number → Add SIP integration, choose a SIP region and copy the inbound SIP URI.
  2. At your provider, set that URI as the origination / forwarding destination for your numbers.
  3. Create the trunk in the platform (form below) — inbound auth + outbound termination.
  4. Assign numbers to assistants and test inbound, then one outbound test call.
Add a number menu with the SIP integration option

Open Add a number under Phone numbers and choose Add SIP integration.

Inbound SIP addresses

Choose the region in the SIP integration form. Use the address the form displays for the number you are connecting.
Add SIP integration with Europe selected and the Famulor SIP URI visible

Select the SIP region and use Copy to copy the inbound SIP URI.

For a hostname field, use only the part after sip:. For a SIP URI field, keep sip: and add the transport parameter if your provider requires one.

Trunk type

Inbound (receiving calls)

Inbound form with DID, Provider source IPs and Allowed source IPs fields

Enter the DID and choose the authentication your provider uses. This example shows Provider source IPs.

  • Your phone number (DID) — public E.164 customers dial; must match what the carrier forwards to the platform SIP URI.
  • Inbound authentication
    • SIP username/password — only when the carrier explicitly sends digest credentials to the forwarding destination.
    • Provider source IPs — use when the carrier forwards to the platform FQDN without downstream digest and publishes stable SIP-signaling IPs/CIDRs. Do not use media ranges or overly wide networks.
  • At the provider: forward / originate to the platform SIP URI you copied.
Incoming calls are matched to the assistant you assign, exactly like marketplace numbers.

Outbound (calling out)

Outbound form with termination address, transport, region and caller ID settings

Under Outbound, set the provider’s termination hostname, transport, region and caller ID format.

  • Termination address — provider SIP host only (e.g. sip.telnyx.com). No sip: prefix, no port.
  • Transport — AUTO (recommended), UDP, TCP, or TLS. Secure trunking always uses TLS.
  • Outbound region — where the Famulor network originates the call. Prefer Automatic, or the country closest to your customers / carrier POP.
  • Outbound calling number format — how the FROM number is sent to the carrier. Must match the carrier’s setting (e.g. Telnyx Origination Number Format):
    • International with + (recommended for most)
    • International without +
    • National (no country code)
  • Credentials
    • Shared (recommended) — one username/password for inbound and outbound.
    • Separate — distinct inbound vs outbound secrets when the carrier requires it.
  • Outbound authentication — username/password when your carrier supports it. If the carrier or phone system can only accept calls from known source addresses, use the ranges under Outbound source addresses and choose an Outbound region on that list. Use “no credentials” only in that case, or when the carrier explicitly allows unauthenticated outbound.
Outbound calls and campaigns can then use your trunk and your caller IDs.

Fixed IP for outgoing calls

If your phone system or SIP provider requires a fixed source IP, book the Fixed IP for outgoing calls add-on or contact sales@famulor.io to arrange setup. After we configure the route for your SIP destination, turn on Fixed IP for outgoing calls in the trunk settings. The form displays the IP your provider needs to allowlist. The pilot supports custom SIP trunks with IP-based authorization and Secure trunking switched off.

Outbound source addresses

These are the Famulor network addresses your carrier or phone system sees on a bring-your-own SIP trunk, when the assistant calls your termination address. Numbers purchased in Famulor, and verified caller IDs, use the included phone service. Do not allowlist these ranges for those calls. For direct outbound routing, choose an Outbound region on the SIP integration. The assistant has no separate calling address. Choosing Germany stores that country on the outbound trunk, and calls then start in Germany. When Outbound region is Automatic, Germany, France, the United States, India, or Japan, signaling and audio use these ranges. Canada uses the same ranges: Allow TCP port 5060 for signaling. With secure trunking, allow TLS on port 5061. Audio uses UDP, and the port changes on every call, so allow UDP from these ranges rather than one port. Germany and France start the call in Europe. The United States, India, and Japan start it in that country. Automatic starts it in the Famulor network region that handles the conversation: Europe, the United States, or India. Those three use the ranges above. The United Kingdom, Australia, and the other countries in Outbound region are outside these ranges. If the phone system can only allow the three ranges, leave Outbound region on Automatic, or choose Germany, France, the United States, India, or Japan. If the chosen region is unavailable, a call can start in a nearby region that is not on this list. The phone system then rejects it until the chosen region is available again. Username and password is still the better check when the carrier supports it. Use the ranges when the phone system sends no password and can only allow source addresses. Do not allow a single host, and do not open the trunk to every address on the internet. These ranges were confirmed on 29 October 2026. Read this page again before you change a firewall.

Advanced

Expand Advanced when creating or editing a BYO trunk: HD Voice (G.722): enable on the Telnyx connection/codec settings when needed (supported with Telnyx, not Twilio).

Editing an existing trunk

Existing trunks are edited from Numbers → Configure → Carrier Settings (not from a separate trunk list on Add SIP integration).

Changing SIP region (Global to EU) & regional routing

For EU customers and compliance-sensitive workloads, you can choose where telephony signaling terminates by configuring the SIP region:
  • Initial setup: When creating a connection (Settings → Numbers → Add a number → Add SIP integration or Carrier import), select EU as the SIP region (default is Global).
  • Changing an existing trunk: You do not need to delete and recreate the connection to switch from Global to EU. Open Settings → Numbers, click Configure on the number row, navigate to Carrier Settings, and select EU as the SIP region (for imported carrier connections, this can also be updated via the Public API or the MCP tool update_carrier_connection). The platform will automatically update the signaling URI and repair routing. Remember to update the origination/forwarding URI on your carrier’s portal if required.
  • Independent of AI inference region: The telephony SIP region controls SIP signaling and media termination infrastructure for phone calls. It is completely independent of the AI inference region (configured under Settings → Workspace), which governs which cloud regions run LLM, STT, and TTS model inference. You can use an EU SIP trunk regardless of whether your workspace AI inference region is set to Global, EU, or US. Consult your agreement and data-processing documentation for the applicable regional commitments.

Limits and behavior

  • E.164 numbers on BYO trunks count against the same plan number allowance as purchased numbers.
  • Calls over your own trunk avoid the platform’s per-destination carrier surcharge — your provider bills termination directly. Plan minutes are still consumed; see billing.
  • Assistant features such as flows, warm transfer, and recording work identically on BYO trunks.

Troubleshooting

Outbound calls fail or don’t connect — check the termination host, transport, and credentials against your provider’s documentation first: a wrong transport (UDP vs. TLS), or an extra sip: prefix or port on the termination address, is the most common cause. Then compare the outbound calling number format and the codec settings with what the provider expects. Change one setting at a time and place a single test call after each, so History shows you which change fixed it. Inbound calls don’t reach the assistant — the provider must send calls to the platform’s SIP FQDN, never to a raw IP address; sending to an IP is the most common inbound failure. With Provider source IPs, confirm every current signaling IP or CIDR is entered — a stale or incomplete list drops calls silently. Then confirm the DID matches exactly what the provider sends: a SIP Extension trunk also needs its Primary DID set, since it isn’t a wildcard. Call transfers over SIP REFER fail — confirm the destination provider actually supports SIP REFER; not every carrier does, and that’s the most common cause. If one URI format fails, try the alternatives in order: with the port (sip:+1234567890@sip-server:5060), without the port, then a bare sip:+1234567890. Rule out the destination itself as well — check that the target number is reachable and not blocked before assuming the trunk is at fault. When a transfer was attempted and failed, the call’s event log holds call_transfer_failed or warm_transfer_failed; see Inbound & outbound calls for the shared failure shape. Test inbound and outbound independently — one working does not confirm the other. Still stuck? Contact support with the call ID, the exact trunk configuration, and, for transfer issues, the SIP URI format you tried. For a fuller diagnostic pass — a SIP status code reference, why the trunk shows as offline/unregistered, and a pre-support checklist — see SIP troubleshooting.

API and MCP

Create and manage trunks via the Public API (POST /api/v1/sip-trunks and related endpoints in the API reference), or with the MCP tools create_sip_trunk, list_sip_trunks, get_sip_trunk, and delete_sip_trunk. Both surfaces support the same customer-facing settings as the UI, and passwords are never returned.
Test inbound first: call one of your numbers and check it appears in History with the right assistant. Then verify outbound with a single test call before wiring the trunk into campaigns.

Separate SIP identity and caller ID

In Carrier Settings → Outbound SIP identity, keep Phone number (default) unless your own carrier requires the authentication username in the outbound From user. Choose SIP username for that requirement and keep your public number as the primary DID. SIP Extension does not select the authentication username. With SIP username identity, Caller ID source sends your international primary DID separately: From display name, P-Asserted-Identity, or P-Preferred-Identity. Match the selection to your carrier portal. The From display name always contains the primary DID; the other choices also add the selected header. Remove conflicting custom caller identity headers first. This opt-in applies to outgoing calls and new outbound legs for warm transfers. Existing trunks retain their previous behavior. Imported carrier connections use their managed identity settings. Incoming matching and assistant assignments stay the same. Use PATCH /sip-trunks/ in the current API reference or the MCP tool update_sip_trunk_identity to change this selection. Creation also supports these options.