Documentation
Chat
- Getting Started
- Installation
- Core Concepts
- Escalation System
- Widget Keys
- Secret Keys (sk_)
- REST API
- Channels & Integrations
- Messaging Platform API
Voice
- Voice Agent
- Setup Guide
- Phone Numbers
- Outbound Campaigns
Platform
- Billing & Pricing
- Glossary
- FAQ
Phone Numbers
Manage phone numbers for your voice agent — forward your existing number or provision a new one.
Overview
Your voice agent needs a phone number to receive and make calls. You can keep using your existing business number by forwarding calls, or get a dedicated number from the platform.
All phone numbers use E.164 format — the international standard (e.g. +60123456789).
Connection options
Forward your number
Keep your existing number and forward calls to your AI agent. Your clients call you as usual — the AI answers when you're unavailable or you can forward all calls.
Requires: a platform-provisioned AI line (auto-created during setup) + call forwarding on your phone.
Dedicated number
Provision a new phone number that goes directly to your AI agent. Choose from local, mobile, or toll-free numbers in 20+ countries.
Best for: separate AI lines, teams, or when you want a distinct number for your AI.
Bring your own SIP trunk (advanced)
If you already have a SIP trunk from another provider, you can connect it directly. Provide your SIP domain and authentication credentials.
Best for: businesses with existing telephony infrastructure.
Setting up call forwarding
After your AI line is provisioned, forward your existing number to it:
Forward all calls: Dial
*21*[AI line number]#Forward when busy: Dial
*67*[AI line number]#Forward when no answer: Dial
*61*[AI line number]#Cancel forwarding: Dial
#21#
Multiple numbers
You can forward multiple personal numbers to the same AI line. This is useful if you have separate numbers for different purposes (e.g., one per carrier or region).
Each forwarded number can be verified separately for outbound caller ID.
Outbound caller ID
When your AI makes outbound calls (campaigns, follow-ups, test calls), the recipient sees a caller ID:
Verified number: your own phone number shows as caller ID
Unverified: the platform AI line number shows as caller ID
To verify your number for outbound, go to the Numbers page and complete the SMS verification step. We send a 6-digit code to confirm you own the number.
Provisioning a dedicated number
Go to Numbers in the voice section
Click "Get a New Number"
Select a country and optionally an area code
Choose between local or toll-free
Confirm the monthly cost
Releasing a number
Releasing a dedicated number is permanent — you cannot recover it. Active calls must complete before a number can be released. Your forwarded personal numbers can be removed at any time without affecting the underlying phone line (you still keep your number).
Plan limits
Your plan determines how many concurrent call lines you can have. This includes both dedicated numbers and forwarding targets. If you reach your limit, you'll need to release a number or upgrade your plan to add more.
Related: Voice Setup Guide • E.164 Format • Outbound Campaigns • Voice Agent Overview
