Phone Numbers: provisioning, routing, and BYOC
Buy a phone number from Call2Me, bring your own via SIP, route inbound calls to agents — the lifecycle of a number on the platform.
Updated May 6, 2026
A phone number is the bridge between the public phone network and your voice agent. Inbound calls land on a number, the number routes to an agent, the agent answers.
Two acquisition paths
| Path | When | Pros | Cons |
|---|---|---|---|
| Buy through Call2Me | Need a number fast | One-click provisioning, billing rolled into wallet | Limited to supported countries; carrier choice is ours |
| BYOC via SIP | Existing number, regulated industry, custom carrier | Keep your existing number and contracts | Requires a SIP trunk and DNS/firewall setup |
Buying a number
In the dashboard:
- Phone Numbers → New Number
- Pick country + region (US, TR, DE, FR, GB, plus ~65 more)
- Pick number type: local, mobile, or toll-free
- Confirm — the number is live within minutes
Or via API:
curl -X POST https://api.call2me.app/v1/phone-numbers \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"country": "TR",
"type": "local",
"agent_id": "agent_abc123"
}'
The number is rented monthly. Cancel anytime from the dashboard — the number goes back to the pool at the end of the rental period.
BYOC: bringing your own number via SIP
If you already own a number with a different carrier (NetGSM, Telnyx, Twilio, an enterprise PBX), you can route it to Call2Me without changing the underlying carrier relationship.
The flow:
- Configure a SIP trunk in Phone Numbers → SIP Trunks
- Add your existing number, bind it to the SIP trunk and an agent
- Update your carrier's routing to send traffic to Call2Me's SIP endpoint
- Test: call the number, the agent should answer in 2–3 seconds
Full walkthrough: SIP Trunks.
Routing
Each number has a primary agent. Inbound calls go to that agent unconditionally. For more sophisticated routing, build the logic into the agent's prompt and use transfer:
If the caller asks about billing, transfer to +905551112233.
If the caller asks about technical support, transfer to +905554445566.
The agent reads intent and transfers — no separate IVR system needed.
Outbound caller ID
For outbound calls, the from_number field on POST /v1/calls controls
what the recipient sees. Two patterns:
- Use a number you own — most carriers and most countries allow this
- Use a number you've explicitly verified — for Twilio-style "verified caller ID" workflows
Spoofing a number you don't own is illegal in most jurisdictions. The platform doesn't help you do that.
Number lifecycle
| State | Meaning |
|---|---|
provisioning | Carrier is allocating the number (~2 min) |
active | Live and receiving calls |
suspended | Billing issue or compliance hold |
released | Cancelled, returned to the pool |
Status is visible per number in the dashboard.
What's next
- SIP Trunks — full BYOC walkthrough
- Calls — using
from_numberandto_number - Agents — binding a number to an agent
Frequently asked
Q.Where do the numbers come from?
Call2Me partners with carriers (Telnyx by default) to provision local numbers in roughly 70 countries. You can also bring your own via SIP trunk for full control over the carrier relationship.
Q.How much does a phone number cost?
Number rental varies by country and number type (local, mobile, toll-free). Pricing is shown in the dashboard at provision time. Per-minute usage is on top of rental.
Q.Can one number route to multiple agents?
A number routes to a single primary agent. For richer routing (queue, IVR-style menus, time-of-day rules), build that logic into the agent's prompt and use transfer.
Q.Can I port my existing number to Call2Me?
Direct porting is not currently a self-serve flow. The supported path is BYOC: keep the number with your existing carrier, point it at Call2Me via a SIP trunk.