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.
You don't need to migrate your existing phone system. A voice agent works with a brand-new number you buy through Yaplet, and you can forward your old line to it later when you're ready.

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.

Changes on the agent's page are saved with Save changes in the title bar (Discard undoes them). Pause, Resume and deleting the agent act at once and are not part of Save.
Draft with AI writes the persona from this brand's own company name, website and tone. If the brand has no AI agent yet, the panel says "This brand has no AI agent yet" and the Draft agent button stays disabled, so start from a template instead.

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.

Some countries require documents (proof of address, proof of identity) before a number can be activated. In that case the dialog says Your number is reserved and its Continue verification button opens the wizard. An order that is still waiting on something shows Verification required in the list, and its Continue button walks you through each requirement.
If a purchase is refused, the dialog stays open and shows a red "The purchase did not go through" panel with the provider's reason. Only a successful purchase closes it — so a closed dialog means the number really is yours.
An order that needs paperwork catches up on its own. Opening the Phone numbers page refreshes the list, and a number that has finished activating shows up within an hour at worst.

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:

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
Test from a quiet place, and use headphones for Talk to it, or Yaplet hears itself through your speakers. Background noise makes it much harder to tell whether a problem is the agent or the line.
A test call stops after 5 minutes, and each person can make up to 10 an hour. Actions run for real: workflows and API tools really run. It is charged to your workspace the same way as a real call, so it needs a paid plan, like phone calls. It doesn't use up the per-caller limits that apply to real callers, and it leaves no conversation in the inbox. Instead, it shows in the agent's Calls list with the caller Test call and a Test badge.

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.

A voice agent handles the whole call on its own. It cannot transfer the call to a person or to another phone number — when it cannot help, it says so plainly and gives your company's contact details from the brand's knowledge (or names your website if it finds none). It never offers to take a message or promises a callback, so keep your contact details in the brand's knowledge. The one exception is when you fill in When a caller asks for a person on the agent's page: then it can offer what you wrote there, such as a callback, and tell your team.

Voice & language

The 30 voices and 12 languages — and which of the three "language" settings does what.

Knowledge base & tools

What the agent can look up on a call, and what it can and cannot do.

Pricing & limits

What a minute of voice costs and where to track usage.

© 2026 Yaplet. All rights reserved.