Phone Numbers
Buy and manage phone numbers for your voice agents. Covers local, mobile, toll-free and shared-cost numbers, country-specific regulatory requirements, the monthly rental, the one-time setup fee, and how cancellation works.
How Numbers Work in Yaplet
Phone numbers are provisioned through Telnyx, our telephony partner, and managed directly inside Yaplet. A number is its own billable item — separate from your Yaplet plan — and is always assigned to exactly one voice agent at a time.
Local
A number with a geographic area code. Best for businesses with a regional presence and lower per-minute carrier rates.
Mobile
A number that looks like a mobile line. Useful where customers won't call landlines, especially on consumer markets.
Toll-free
A free-to-call number for the caller. The receiving business pays per-minute. Great for support hotlines.
Shared-cost
A number where the cost is split between caller and receiver. Available in a small set of countries with their own conventions.
Buying a Number
Open Dashboard → Automation → Voice → Phone numbers and click Buy number.
Pick a country
Yaplet lists every country Telnyx currently sells numbers in. The list shows the monthly rental and the one-time setup fee per type before you commit.
Pick a type
Local, mobile, toll-free or shared-cost depending on what's available for the chosen country.
Search and choose
Search by prefix or by city. Click a candidate to lock in the exact number.
Confirm and pay
Review the line item — the one-time setup fee, the prorated rental for the rest of the current month, and the monthly rental that will start on the next billing date — and confirm. The number is yours within minutes for most countries.
Regulatory Requirements
Some countries require additional documents before a number can be activated. Examples include proof of address, end-user declarations, and country-specific tax IDs.
When you order a number that needs paperwork, Yaplet opens a regulatory order with the carrier and tracks each required item on the Phone numbers page:
- Open requirement — you haven't uploaded the document yet.
- Under review — uploaded, waiting for carrier approval.
- Approved — accepted; the number activates within minutes.
- Rejected — re-upload requested with a reason.
Assigning a Number to an Agent
Once a number is active, open the Connections tab of a voice agent and pick it from the list of available numbers. A number can only be attached to one agent at a time; reassign it by detaching from the current agent first.
Cancelling a Number
To stop a number's billing, detach it from any agent and click Cancel on its row. Cancellation in Yaplet is immediate, not end-of-period:
- The number is released the moment you confirm and stops answering calls. You cannot reclaim it through Yaplet once released.
- Any unused days remaining in the current billing cycle are refunded prorated to the day.
- The one-time setup fee is non-refundable — it covered the upfront cost of provisioning the number, which the carrier does not return.
Billing Summary
- Monthly rental — varies by country and number type. Visible at purchase and on the Phone numbers page. Charged monthly from the next billing date.
- One-time setup fee — paid once per number on purchase, non-refundable.
- Prorated first-month rental — paid on purchase, covers the days between purchase and your next billing date.
- Per-minute conversation usage — metered separately at $0.12/min in Yaplet credits, the unified usage currency used across every usage-based feature, and added to your next invoice. See Pricing & limits.