Where to start
Voice agents belong to a brand. Open Brand → AI agent → Phone and click Create agent.
You do not have to have a phone number yet. An agent without a number simply never rings, and its row says "No number" until you assign one.
Three ways to create one
The New phone agent dialog offers three routes on its first screen:
- A template. Ready-made agents for common jobs: Receptionist, Customer Support, Sales and After-hours FAQ. A template fills in the name, the system prompt, the voice, the language and the greeting, and you can change every one of them afterwards. Each template card has a play button so you can hear its greeting before you pick it.
- Start from scratch. An empty agent you fill in yourself.
- Draft with AI. Describe in a sentence or two what the agent should do, and Yaplet writes the persona, picks a voice and drafts the greeting for you.
Two things about the AI route. First, it works from this brand's details — its company name, website and tone — so you do not have to repeat them in your description. Second, it needs the brand to have an AI agent: if it does not, the dialog says "This brand has no AI agent yet" and the Draft agent button stays disabled. Use a template instead, or add Yaplet to the brand first.
Whichever route you take, click Continue, check the basics on the next screen (name, voice, language, greeting, instructions and, if you like, one of your numbers that no agent uses yet) and click Create agent. The agent is created and its page opens. If the number cannot be attached, the agent is still created and a message asks you to pick the number on its page. You can come back to it any time by clicking the agent's row under Brand → AI agent → Phone. The page has no tabs: it is one page of sections, from the agent's name at the top down to the Calls list at the bottom.
Changes on the page are saved with Save changes in the title bar. It shows "Unsaved changes" while you have edits, and Discard undoes them. Pause, Resume and Delete agent act at once and are not part of Save.
Name and status
The Name is internal only — it shows in your dashboard, never to a caller. Something like "EN reception · main line" saves time later. Below it, Status shows whether the agent is Active or Paused, with a Pause or Resume button that takes effect at once.
Voice & greeting
Language is the agent's working language. It decides the default greeting and the language every call starts in, and the call stays in that language. The agent changes language only when the caller clearly asks to continue in another one, in any language (for example "English please"), and then it stays in the new language until the caller asks for another. A short phrase, an unclear sound, a noise or even a whole sentence that sounds like another language does not change it; when the agent can't understand the caller, it asks them, in the current language, to repeat. The voices themselves are multilingual, so the same voice handles every supported language.
Voice is picked from cards grouped into families. Switch family with the buttons above the cards, search every family by name or descriptor with the Search voices box, or narrow the list with the Female and Male buttons. Press play on any card to hear the AI notice and your greeting in that voice. A sample you have not played yet in this visit is a small paid voice generation, billed like the rest of your AI usage. Playing the same sample again is free.
| Field | What it does |
|---|---|
| AI notice and Greeting | Every call opens with a fixed, read-only AI notice in the agent's language ("This call is answered by an AI assistant." — required by the EU AI Act, can't be edited or interrupted), then your greeting. Leave the greeting empty and Yaplet uses a default one in the agent's language. If your rules require a recording notice, put it in the greeting — that one is not played automatically. |
| Callers can interrupt the greeting | Off by default: the greeting plays in full. Switch it on and a caller speaking over the greeting stops it and the agent starts listening. Leave it off when the greeting has to be heard, such as a legal notice. |
Saving after you change the greeting text or the voice regenerates the stored greeting audio automatically, so the first second of the next call matches what you just heard.
Instructions
The Instructions field is the system prompt: who the agent represents, the tone to use, what it may and may not do, and any hard rules. This is the field that decides how the agent behaves on a real call. Alongside it, the agent also uses the brand's company description and the Answer instructions of the brand's AI agent, and if the brand has no AI agent, the brand's details.
Write the prompt the way you would brief a new starter: a clear role and a handful of firm rules. You do not need to tell it to stick to what the brand actually knows — it never improvises facts from general knowledge anyway. Telling the agent what to do works better than listing what not to do.
Under the instructions, a read-only box called When it has no answer says what happens when the agent does not know something: it says it does not have that information and never guesses. There is nothing to choose there. Instead it gives the caller the company's contact details from the brand's knowledge, or names the company's website if it finds none — so keep your contact details in the brand's knowledge.
A call cannot be handed to a person, so the field below it, When a caller asks for a person, says what the agent does instead. Left empty, it tells the caller it can't connect them and gives your contact details; it never offers to take a message or promises a callback. Fill it in — for example Offer a callback and ask what it's about. — and it follows your text when a caller asks for a person, wants a callback or wants to leave a message, but it never promises a time unless your text names one. When it agrees something your team has to do, your team gets an alert with a short summary, and the conversation waits in the inbox with that summary as a private note. If the caller's number is hidden, it first asks how to reach them. The field takes up to 2,000 characters. Only this field can allow messages or callbacks: asking for them in the Instructions field has no effect.
Phone numbers
Pick which of your numbers ring this agent. A number can only be on one agent at a time, so assigning it here takes it off whichever agent had it.
There is nothing else to link: the agent answers from its brand. Need another number? The link under the picker takes you to Settings → Connections → Phone numbers.
Call recording
Record calls saves a stereo MP3 of every call, with the caller on one channel and the agent on the other. Stored privately, capped at 100 recordings per organization; when it is full the oldest are removed first.
Switching recording on shows a compliance warning, and it is worth reading: recording is regulated, the rules on consent, disclosure and retention differ by country and by use case, and making sure you have a legal basis and have told your callers is your responsibility, not Yaplet's.
Test it with Talk to it
You do not need a phone number to hear your agent. Click Talk to it on the agent's page and a side panel opens. Click Start call, allow your browser to use the microphone, and talk. The words of both sides appear in the panel as they are spoken, together with anything the agent looked up. Click Hang up to end the call, and Call again to try once more.
- The test uses the last saved version of the agent, so save your changes first. Unsaved changes are not included.
- It works on a paused agent too.
- Use headphones. Without them, Yaplet hears itself through your speakers.
- Actions run for real: a workflow or an API tool the agent uses will really run.
- A test call is charged to your workspace the same way as a real call, and like phone calls it needs a paid plan.
- A test call stops after 5 minutes, and each person can make up to 10 test calls an hour.
- It leaves no conversation in your inbox, and it does not use up the per-caller limits that apply to real callers.
- If the agent agrees something your team has to do, the panel shows a Told your team line instead: a test call alerts nobody.
Calls
At the bottom of the page: every call this agent has handled, defaulting to the last 30 days. Each row shows the caller, the date, the duration, the cost and the status, with a play button when there is a recording and a link straight into the conversation in your inbox. Your test calls are in this list too: the caller shows as Test call and the row carries a Test badge. Because a test call leaves no conversation in the inbox, it has no link into one.
What the agent list tells you
Back on Brand → AI agent → Phone, each row shows the agent's voice and language, its number, a Live, No number or Paused badge, and sometimes a warning that is worth acting on:
- "No number" — the agent exists but nothing rings it.
- "This brand has no knowledge yet — the agent can't answer questions." — the agent has a number and will answer, but the brand has nothing on its Knowledge screen for it to look things up in. It still greets callers and answers from its prompt; for any other question it says it does not have that information.
The ⋯ menu on a row holds Edit, Pause or Resume, Duplicate and Delete. A note on the page also says how much phone time one caller gets per day is set in Brand settings, and its Usage limits link takes you there.
Pausing an agent
Open the ⋯ menu on the agent's row and choose Pause (the agent's own page has a Pause button too). Incoming calls stop being routed to it and the row shows a Paused badge; the same menu then offers Resume. The configuration is untouched.
Pausing stops per-minute charges, because no calls are answered. It does not stop the monthly rental on the number.
Deleting an agent
Also on the ⋯ menu. Deleting is allowed at any time, even while numbers are attached. What happens:
- The agent's numbers are un-assigned and their routing reset. They stay in your account and keep costing their monthly rental until you release them at Settings → Connections → Phone numbers. The confirmation names how many numbers are affected.
- Past calls stay where they are — transcripts and recordings remain in your inbox.
What to do next
Try the agent with Talk to it, then assign a number and call it yourself. Then make sure the agent has something to answer with: What your voice agent knows, and where that knowledge comes from. For the voice catalog and the language list, see Pick a voice and language for your number, and for recordings see Listen to call recordings and read transcripts.