Getting Started with Voice

A step-by-step walkthrough from a fresh Yaplet account to answering your first real phone call with an AI voice agent. Covers prerequisites, the three setup steps, and how to test before you point a real number at it.

Before You Begin

A voice agent reuses the same brain as your Vex chatbot, so before you create one make sure you have:

  • An active Yaplet plan with voice minutes available (check Settings → Subscription & billing).
  • At least one VEX chatbot configured with the knowledge base you want the phone agent to use.
  • A payment method on file, because phone numbers are billed monthly and require a one-time setup fee on purchase.
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 — Buy a Number

Open Dashboard → Automation → Voice and click Phone numbers. Pick a country, then a local, mobile, toll-free or shared-cost number. Yaplet handles the regulatory paperwork.

Some countries require additional documents (proof of address, end-user declarations) before the number becomes active. The Phone numbers page shows what's still pending for each order.

See Phone numbers for the full guide on buying numbers and regulatory requirements.

Step 2 — Create the Agent

Click Add voice agent. Pick one of the prebuilt templates as a starting point, or start blank, then walk through the three configuration tabs:

General

Name the agent, set the system prompt (its "job description"), choose a starting greeting, and decide whether the greeting is interruptible (off by default — the greeting plays in full first).

Voice & language

Pick one of 30 Gemini voices and the language the agent speaks. The voice and language are saved together so the greeting audio is pre-generated for instant playback.

Connections

Link the VEX chatbot whose knowledge base the agent should use, attach phone numbers, and optionally enable call recording.

See Creating an agent for the deep dive.

Step 3 — Test, Then Go Live

Before you point a customer-facing number at the new agent:

  1. Call yourself. Dial the assigned number from any phone. The agent should pick up within a second and play the greeting in the right voice and language.
  2. Ask three KB questions. Pick questions you know are covered, half-covered and not covered. Confirm the agent answers correctly and admits when it doesn't know instead of inventing facts.
  3. Hang up and check the inbox. The call thread should appear within a few seconds with a full transcript and (if enabled) a downloadable recording.
Use a quiet environment for the test call. Background noise can trip the noise gate and shorten the agent's listening window — perfectly normal, but it makes testing harder than it needs to be.

When you're happy, either advertise the new number or forward your existing line to it. From minute one every call shows up in your inbox alongside chats and emails from the same caller.

Voice agents currently handle the entire call on their own. They cannot transfer to a human or another phone number — if the agent can't help, it admits so out loud and offers to end the call. Live transfer is on the roadmap.

Voice & language

The 30 voices and 17 languages — how to pick the right combination.

Knowledge base & tools

How a voice agent uses your KB and when it calls workflow tools.

Pricing & limits

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