TelVox · Connect
Assign numbers. Route inbound to your code.
Assign DIDs from your pool to applications, point inbound traffic at your own handlers, and rotate caller ID for local presence. Self-serve search and purchase is honestly on the roadmap — today the team provisions with you.
# illustrative — shape may differ at GA
# point an assigned number at your application's answer URL
curl -X POST https://api.telvox.dev/v1/phone-numbers/PN3f9c... \
-H "Authorization: Bearer $TELVOX_API_KEY" \
-d answer_url="https://your.app/voice/answer" \
-d caller_id_strategy="area_code_match"Local presence
Pick the rotation each campaign needs.
Spread calls across your pool, pin a number to a contact, or match the destination's area code — all real, shipped caller-ID strategies.
Caller-ID strategies
- round-robin
- sticky
- area-code match
What's real today
Assignment and routing now; self-serve buying later.
DID assignment, per-application routing and caller-ID rotation ship today. Self-serve number search and purchase is honestly on the roadmap.
DID pool assignment
Assign numbers and DIDs from your pool to applications and campaigns. Each number knows which handler owns it, so inbound traffic lands exactly where you intend.
Per-application routing
Point each number at its own answer URL. Inbound calls hit your endpoint and your app decides what happens next — route per application or per campaign.
Round-robin & sticky rotation
Rotate caller ID across your DID pool round-robin for spread, or sticky so a given lead always sees the same number — both shipped in Dial today.
Area-code match for local presence
Present a number that matches the destination's area code to lift answer rates. Local-presence caller-ID matching is a real, shipped capability.
Inbound to your handlers
Inbound calls to an assigned number are delivered to the answer URL you configure, so your application is in control of every inbound flow.
Team-assisted provisioning
Today the TelVox team provisions and ports numbers with you. Self-serve search and purchase via the API is on the roadmap, not yet available.
Honest status
Self-serve number search and purchase is roadmap.
To be explicit: there is no in-API number search or purchase today, and toll-free and multi-country inventory are not self-serve yet. Today the TelVox team provisions, ports and assigns numbers with you. Assigning numbers to applications, routing inbound to your handlers and caller-ID rotation are real and shipped — the buy-it-yourself flow is honestly on the roadmap, not a commitment we present as already live.
Questions
Numbers FAQ
No — and we want to be explicit about that. Self-serve number search and purchase is on the roadmap, not shipped. Today the TelVox team provisions, ports and assigns numbers with you. What is real right now is assigning numbers from your pool to applications, pointing them at your handlers, and caller-ID rotation.
Self-serve toll-free and multi-country number inventory is roadmap, not something you can browse and buy in-API today. Tell us the countries and number types you need and the team will scope what we can provision now versus what's planned for general availability.
Caller-ID rotation presents different outbound numbers across calls. You can rotate round-robin across your pool, keep it sticky so a contact always sees the same number, or match the destination's area code for local presence. All three strategies are real and shipped in Dial today.
No — the snippet is illustrative. Connect is in developer preview, so the exact phone-numbers endpoints, fields and strategy values may change before general availability. We'll publish versioned reference docs as the shapes settle.
Get the right numbers pointed at your app.
Join the developer preview and we'll provision your DIDs and wire inbound routing to your handlers.