Getting Started with Voice
A step-by-step walkthrough from an empty account to answering your first real phone call with an AI voice agent. Covers what you need first, the three setup steps, and how to test before you point a real number at it.
Before You Begin
A voice agent answers from the knowledge that belongs to its brand, so before you create one, make sure you have:
- A paid plan. Voice runs on the paid plans only — it is not part of the free plan or of the free 14 days. Only the organization owner can open Settings → Account → Billing to check the plan — an administrator is sent back to the dashboard. If you are not the owner, the check that works for you is the left menu: if Phone appears in the side menu of Brand → (your brand) → AI agent, voice is on and you are allowed to use it.
- Something for the agent to answer from. Teach the brand first at Brand → (your brand) → Knowledge. A chat AI is not required: a brand with no Yaplet still answers calls from its own knowledge.
- A payment method on file, because a phone number costs a one-time setup fee on purchase and a monthly rental after that.
Step 1 — Create the Agent
Create the agent first: the dialog that buys a number asks which agent should answer it. Open Brand → (your brand) → AI agent → Phone and click Create agent. In the New phone agent dialog, pick a starting point — a template (Receptionist, Customer Support, Sales or After-hours FAQ), Start from scratch, or Draft with AI — and click Continue. The next step, Set up your phone agent, asks for the Name, Voice, Language, Greeting, Instructions and Phone number. You have no number yet, so leave the phone number on Not now (if you have no free number, that row says so and links to Buy a number). Click Create agent. The agent's own page opens, with these sections to work through:
Name and status
The top section, headed with the agent's name. Its Name is only for you and your team — callers never hear it. Its Status shows Active or Paused: Pause stops it answering calls and Resume turns it back on, both at once.
Voice & greeting
The Language the agent works in, one of 30 voices, the Greeting it opens every call with, and whether callers may interrupt that greeting (off by default, so the greeting plays in full). Every call also opens with a fixed AI notice that you cannot edit. Every voice speaks every supported language, and you can play a sample before saving.
Instructions
What the agent does on a call: its role, tone and the steps it follows.
Phone numbers
The numbers that ring this agent. The agent belongs to a brand, and the brand is where its knowledge comes from.
Call recording
The Record calls switch.
Calls
Every call this agent has handled, test calls included, with playback for recorded calls. Defaults to the last 30 days.
See Creating an agent for the deep dive.
Step 2 — Buy a Number
Open Settings → Connections → Phone numbers. Click New phone number (or Get a phone number if you have none yet) and a dialog opens: you choose on the left and see exactly what you are buying on the right. Pick a country and a number type — Local, Mobile, National, Toll-free or Shared cost — optionally type the first digits you would like, then click one of the numbers offered. The summary on the right shows what you pay today and monthly. Choose your agent under Assign voice agent and click the activate button at the bottom, which shows the amount due now. Yaplet files the order with Telnyx for you, and when the number is live the dialog says Say hello to your new number!. In some countries the carrier also needs documents from you before the number can go live, which is what the next note covers.
See Phone numbers for the full guide to buying, assigning and releasing numbers.
Step 3 — Test, Then Go Live
Before you point a customer-facing number at the new agent:
- Talk to it. On the agent's page, press Talk to it in the title bar. A panel opens at the side: press Start call, allow your microphone and talk, just as a caller would. What you and Yaplet say shows in the panel as it is spoken, along with what it looked up. You don't need a phone number for this, and it works on a paused agent too. It uses the last saved version of the agent, so save your changes first.
- Ask three questions. Pick one you know the brand's knowledge covers, one it half covers, and one it doesn't. Confirm the agent answers correctly and admits when it doesn't know instead of inventing facts.
- Say goodbye and listen. The agent should say one short goodbye and then end the call on its own — you should not have to hang up.
- Call the number. Once a number is assigned, dial it from any phone. This is the check of the real number: the agent should pick up quickly and play the greeting in the right voice and language.
- Check the inbox. A call to your number appears under Inbox → Calls as soon as the call starts and fills in line by line while you talk. After the call it holds the full transcript and, if you enabled recording, a downloadable MP3.
When you're happy, either advertise the new number or forward your existing line to it. From the first minute, every call shows up in your inbox alongside chats and emails from the same caller.