Numbers
Two kinds of phone number flow through Voylo — your own (BYO) and ones you rent from us.
Every call starts at a number. Voylo supports two kinds, with different configuration models. Manage both at /app/numbers.
BYO numbers (SIP trunk)
Bring a number you already own from your carrier or PBX and point its SIP trunk at Voylo. Because it's your trunk, you configure it fully:
- Allowed source IPs — which hosts may send calls in on this number.
- Digest auth (optional) — credentials we challenge your carrier with, or present when yours challenges us.
- Outbound destination, transport, media, custom headers — for calls Voylo sends back to your SIP server.
Import via Numbers → Import a SIP number. BYO numbers are never charged a Voylo rental — you pay your own carrier.
Voylo rental numbers
Rent a DID directly from Voylo. These are our numbers, so there's no SIP config — you only choose the destination and toggle direction. The flow (/app/numbers/rent):
- Pick a country (each has its own DID price, channel price, and local/international rates).
- Choose channels — the number of concurrent calls the DID carries.
- Complete KYC — the fields and documents that country requires (e.g. company name, trade licence).
- Pay the first month from your wallet to reserve it.
- We review your KYC (and may request changes); on approval the number is provisioned and goes live.
Configuring a rented number
On a Voylo number's page you get exactly two controls:
- Destination — route inbound calls to an inbound trunk (your agent) or an application (VoyloML).
- Call direction — independent on/off switches for inbound and outbound.
Billing:inbound minutes are included in the channels you rent; outbound is metered per minute at the number's local or international rate. See Concepts → Billing.
Destinations
Either kind of number routes inbound to one of:
- an inbound trunk → your voice agent / SIP endpoint (with failover) — see Trunks; or
- an application → VoyloML call control (IVR, gather, record, conference, dial).
Use Test inboundon a number's page to simulate a call through its current destination.