Concepts

Voylo connects phone numbers to your voice systems over SIP. A call comes in on a number, Voylo routes it to a destination you control (a voice AI agent or any SIP endpoint) or runs call-control logic on it. Five objects cover the whole model.

Account & workspaces

An account is your organization — the billing entity. It owns the plan, the shared minutes allowance, the wallet, and any rented numbers. Under it you have one or more workspaces (e.g. Production and Staging), which hold the actual resources: numbers, trunks, applications, calls, team members, API keys, and webhooks. Usage from every workspace rolls up to the account.

Numbers

There are two kinds, and they behave differently:

• BYO (SIP trunk)— bring a number you already own from your carrier. You configure the trunk (allowed source IPs, auth, custom headers); it's yours, so it's fully configurable.
• Voylo rental— rent a DID from Voylo: pick a country, complete KYC, choose how many channels (concurrent calls). You only set the destination and toggle inbound/outbound — there's no SIP config because it's our number.

See Numbers for both flows.

Trunks

A trunk is a SIP route between Voylo and your systems.

• Inbound trunk — where calls to a number go: an ordered list of SIP destinations (your voice agent or any SIP endpoint) with health-aware failover.
• Outbound trunk — an authenticated endpoint your systems register to, to place calls out through Voylo, egressing with one of your numbers as the caller ID.

Applications & VoyloML

Instead of routing a number straight to a trunk, you can attach an Application that runs VoyloML — a Twilio/Plivo-style XML call-control language. Play audio, gather DTMF or speech, dial, record, conference, and drive the call from your backend via a webhook. See VoyloML reference and Applications.

Billing

Billing lives on the account and has three moving parts:

• Plan — a monthly subscription with an included minutes allowance(shared across the account's workspaces); minutes beyond the bundle are overage.
• Wallet — prepaid balance that covers overage and any pay-as-you-go usage; it never expires.
• Number rentals— the monthly fee for Voylo-provided DIDs (BYO numbers have none). Inbound on a rented number is included in its channels; outbound is metered at the number's local / international rate.

Manage it under /app/billing.