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
Voice Agent Setup Guide
Get your AI voice agent up and running in under 5 minutes.
Step 1: Configure your voice agent
Navigate to Voice Agent in your dashboard sidebar. If this is your first time, you'll see a guided setup wizard.
Greeting message — what your AI says when it answers a call
Voice — choose from several natural-sounding AI voices
Language — the primary language for the conversation (or auto-detect)
Your AI agent uses your uploaded knowledge base to answer questions — the same documents and web pages you've added for your chatbot.
Step 2: Set up your phone number
Your voice agent needs a phone number for calls to reach it. You have two options:
Option A: Forward your existing number (recommended)
Keep the phone number your clients already know. Set up call forwarding so when you're unavailable, calls go to your AI agent.
How it works:
We provision a dedicated AI line for your account
You set up call forwarding on your phone to that line
When clients call you and you don't answer, your AI picks up
Option B: Get a new dedicated number
Provision a brand new number exclusively for your AI agent. Clients call this number directly to reach your AI.
Best for: separate AI-only lines, teams, or when you want a distinct number for automated calls.
Step 3: Set up call forwarding
After your AI line is provisioned, set up forwarding on your existing phone. You can choose:
Forward when busy — AI answers only when you're on another call
Forward when no answer — AI answers after you don't pick up (e.g., 15 seconds)
Forward all calls — every call goes directly to the AI
Forwarding codes by carrier
Dial these codes from your phone. Replace [number] with your AI line number.
Standard GSM (most carriers)
Forward when busy: *67*[number]#
Forward when no answer: *61*[number]#
Cancel forwarding: #21#
Maxis / Hotlink / Celcom / Digi (Malaysia)
Forward when busy: **67*[number]#
Forward when no answer: **61*[number]#
Cancel forwarding: ##21#
Step 4: Verify for outbound calls (optional)
If you want your AI to make outbound calls (campaigns, follow-ups) and show your number as the caller ID, verify your number:
Click "Verify for Outbound" during setup (or later in the Numbers page)
We send a 6-digit code via SMS to your number
Enter the code to confirm ownership
Once verified, outbound calls from your AI will display your number as the caller ID — so clients recognize who's calling.
What happens when someone calls
Once everything is set up, here's the call flow:
Client calls your number (or your AI line directly)
Call is forwarded to your AI agent
AI answers with your greeting message
AI answers questions using your knowledge base
Call transcript and summary appear in your dashboard
Troubleshooting
Calls aren't reaching the AI — verify forwarding is active by calling your number from a different phone. You should hear the AI greeting. If you hear your voicemail instead, the forwarding isn't configured correctly.
Verification SMS not received — check your spam/junk folder. Some enterprise lines block international SMS. Try again or contact support for manual verification.
"Plan limit reached" error — your plan has a maximum number of phone lines. Release unused numbers or upgrade your plan.
Outbound calls showing wrong number — make sure you've completed the verification step. Unverified numbers use the platform line as caller ID.
Related: Voice Agent Overview • Phone Numbers • Outbound Campaigns • E.164 Format
