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 21 countries (the live list is `GET /v1/numbers/allowed-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.