Articles  /  Setup

Writing a Scenario and Instructions for an AI Phone Agent

Setup 8 min read By the TelAI team

An AI phone agent does what its scenario and instructions tell it to do. When a call goes well, it is usually because someone wrote clearly what the call was for, how the agent should sound and what to do when things went sideways. When a call goes badly, the fix is usually a sentence or two in the instructions.

This guide walks through writing a scenario for a phone agent, from the one-line purpose of the call to the edge cases that only show up once real people start calling.

Start with the job of the call

Before you write anything about tone or wording, write one sentence that says what a successful call looks like. For example:

  • "Answer questions about returns and exchanges, and set up store credit for callers without a receipt."
  • "Call customers whose orders are delayed, tell them the new delivery date, and offer free shipping on their next order."
  • "Call the insurer's claims line, get the current status of the claim, and note the name of the person you spoke with."

That sentence keeps the rest of the scenario honest. If an instruction doesn't help the agent do that job, it probably doesn't belong.

Give it a persona that fits the call

The persona is who the agent is on the call: a name, a role and a manner. "Dana, a friendly member of the returns team" is enough. You don't need a backstory.

Match the persona to the call. A calm, unhurried manner suits a support line. A brisk, efficient one suits a call into a claims department where the person on the other end has a queue to get through. The voice you pick should fit the persona too, which is easy when the voice can be chosen per call.

TelAI requires the agent to say it is an AI at the start of each call and to tell callers the call is recorded. Write that opening in the persona's own words, so it sounds like a friendly introduction rather than a legal notice. "Hi, this is Dana, the AI assistant for Hartley Outdoor. This call is recorded. How can I help?" covers both in one breath.

Write instructions for the ear

Instructions written for a chat window often sound wrong on the phone. Spoken answers need to be shorter and simpler than written ones, because a caller can't scroll back up.

  • Keep answers short. "Answer in a sentence or two, then stop and let the caller respond."
  • One question at a time. "Never ask for two pieces of information in the same sentence."
  • Avoid lists. Three options are about the most a caller can hold in their head. If there are more, ask a question to narrow them down first.
  • Read numbers back. "Repeat order numbers and phone numbers back to the caller to confirm them."
  • Plain words. Internal names for products, plans or departments mean nothing to callers. Tell the agent what to call things out loud.

Spell out the rules

Most of the useful instructions are business rules the agent can't guess. Write them as plainly as you would for a new employee on their first day:

  • What the agent may offer, and the limits. "You can offer store credit for the full price. You cannot issue refunds to a card."
  • What it must confirm before acting. "Confirm the order number and the email on the account before discussing the order."
  • What it must never do. "Never quote delivery dates that are not in the order details."
  • What to do when it doesn't know. "If the answer isn't in the knowledge base, say you'll have someone follow up, and take the caller's name and best number."

Keep facts out of the instructions where you can. The return window, the store hours and the warranty terms belong in the knowledge base. The instructions say how to behave. Mixing them makes both harder to update. See preparing a knowledge base for AI phone calls.

Plan for the calls that go sideways

The calls you test with are polite and on topic. Real calls are not. Write a line or two for each of these:

  • The caller asks for a person. Decide whether the agent transfers the call, takes a message or explains when someone will call back.
  • The caller is upset. Acknowledge it briefly, don't argue, and get to what you can do for them.
  • The caller goes off topic. Answer briefly if it's harmless, then bring the call back to its purpose.
  • Wrong number or wrong person. Apologize and end the call politely.
  • The caller asks again whether they are talking to a machine. The agent already said so at the start, but some callers miss it. Have it confirm plainly and carry on.

Tell it when the call is over

Agents that don't know when to stop keep offering more help long after the caller is ready to hang up. Say what the end of a good call sounds like: "Once the store credit is set up and the caller has no more questions, thank them and end the call." TelAI hangs up gracefully when the conversation is over, and clear instructions help it recognize that moment.

An example scenario

Purpose: Answer questions about returns and exchanges for Hartley Outdoor, and set up store credit for callers without a receipt.

Persona: Dana, a friendly member of the returns team. Calm and patient.

Instructions: Answer in a sentence or two. Ask one question at a time. Confirm the order number or the email on the order before discussing a specific return. Without a receipt, you can offer store credit for the full price, but not a refund. If the caller asks for a manager, take their name and best number and tell them someone will call back within one business day. When the caller has no more questions, thank them and end the call.

Test, read and revise

Expect to revise the scenario after the first round of test calls. Call it yourself, then have people who didn't write it call too, because they won't phrase things the way you expect. Read the transcripts. Look for answers that were too long, questions the agent couldn't handle, and places where it followed an instruction too literally.

Once real calls are coming in, the post-call analysis helps you find where to look. Calls with high frustration scores, or tags you didn't expect, are usually the ones that point at a missing instruction. And if a supervisor ends up steering calls the same way more than once, that instruction belongs in the scenario.


TelAI lets you set a custom scenario, persona and instructions for each call or campaign. See knowledge and instructions

Hear TelAI on your own kind of call

TelAI puts a natural-sounding AI voice agent on your phone line, with live controls for your team and an analysis of each call. You can also see how it works first.

Request a demo