This article explains how to write the conversation flow of your AI Voice Agent: the instructions that tell your agent what to ask, when to look up information and when to transfer or end a call. You do not have to write it from scratch. Ask Aircall can write it for you, and you review and adjust it. You can also write it yourself, with a structure and a full example to follow.
Note: Throughout this article, we use one example agent: the inbound line of a software company. It uses Zendesk AI actions and three transfer branches: Nexus Support, Vault Billing and Growth Sales.
If your agent shows a Legacy tag next to its name, please see Configuring your AI Voice Agent (legacy experience) or Find your AI Voice Agent setup guide.
What is the conversation flow?
The conversation flow sits on the During call page of your agent. It tells your agent how to handle a call: what to ask, when to look up information, and when to transfer or end the call. Think of it as the instructions you would give a new colleague who answers your phone.
Your agent already speaks naturally, keeps its answers short and answers questions from your knowledge sources. The flow adds what is specific to your business: the steps of the call, the AI actions to use and the teams to transfer to. If your agent only answers questions, you can leave the flow empty.
To open the conversation flow
Steps:
- Go to Aircall Dashboard > AI Agents > AI Voice Agents and open your agent.
- In the left menu, select During call.
- Find Conversation flow. The Available data and actions panel is on the right.
Start with Ask Aircall
We recommend not writing the flow from scratch. Ask Aircall writes it for you, from a description of a good call or from the procedures your team already follows.
Steps:
- Open Ask Aircall from your agent by clicking on the green bubble on the top right corner of your screen.
- Describe how a good call goes, or paste your call script or SOP (the written steps your team follows).
- Review the flow it writes, and adjust it with the guidance below.
For example: Write a conversation flow for our inbound line. Look callers up in Zendesk with their phone number and check for open tickets. Answer common questions ourselves. Technical issues go to Nexus Support and billing issues to Vault Billing, both with a ticket first. Sales enquiries go to Growth Sales.
Ask Aircall and the agent settings stay in sync. If you edit the flow yourself, Ask Aircall sees your changes, and the other way round. Please see Creating an AI Voice Agent with Ask Aircall.
How a good flow looks
There is no single right way to write a flow. These tips are a good starting point.
- Steps in the order of the call. Give each step a short heading, for example “Step 1: Identify the caller”.
- One instruction per bullet. Short bullets are easier for your agent to follow than paragraphs.
- Every situation covered. Write what happens in each case, for example when a contact is found and when it is not.
- Rules at the end, if needed. Anything that applies to the whole call goes in its own section.
- Simple formatting. Type # followed by a space for a heading, - followed by a space for a bullet, or 1. followed by a space for a numbered step.
Add AI actions, transfers and the caller’s phone number
References connect the flow to the rest of your agent. They appear in the flow as small labels called pills.
Steps:
- In the flow, type "/" where you want the reference.
- Choose AI actions, Transfer or Contact information.
- Pick the item to insert.
You can also select an item in the Available data and actions panel on the right. The item is inserted where your cursor is, or added as a new bullet at the end of the flow.
- AI actions run an action from the AI actions page, for example looking up a contact.
- Transfer sends the call to one of your transfer branches.
- Contact information contains the Phone number the caller is calling from. Your agent can use it on every call, even if the flow does not mention it.
Important: References only work when you insert them from the menu or the panel. Typing the name of an action or a branch as plain text does not connect it.
A pill cannot be edited as text: delete it as one unit. If you rename or delete an AI action or a transfer branch that the flow uses, the flow flags it so you can fix it.
Set up transfers
A transfer branch is a place your agent can send a call to, such as one of your teams. You create the branches in the Transfer rules tab, and you use them in your flow. For the complete setup, please see Setting up call transfers with transfer rules.
- When Call transfer is activated in the Transfer rules tab, your agent always has a Fallback transfer branch with a ready-made transfer message.
- Add a transfer branch for each team you transfer to in the Transfer rule tab, with a name and a transfer message. Your agent says the transfer message right before it transfers the call.
- In the conversation flow available in During call write when to transfer, type “transfer to” and insert the branch.
- Your branches also appear under Transfer in the Available data and actions panel.
Important: Your agent transfers where your flow tells it to. Include what to do when a caller asks for a person, and which branch to use when no other branch fits.
You do not need to write what your agent says when it transfers. The transfer message of the branch covers it. There are no timing options such as Immediate, Help first or After intake questions: you decide in the conversation flow when each transfer happens.
Example: the flow of one agent
Every agent’s flow is different, and Ask Aircall writes yours from your own calls. To show what a finished flow can look like, here are the parts of the example agent’s flow, one at a time. Your flow will have its own steps.
Identify the caller
Your agent finds out who is calling before anything else, so most callers never have to introduce themselves.
- In this example, a contact lookup already runs before the call starts, so the step only covers both outcomes.
- When no contact is found, the agent asks for an email address and runs the search again.
Check for open tickets
Once your agent knows what the caller needs, it checks your systems before acting.
- The step says when the action runs and what to do with each result.
- An open ticket that matches means no duplicate ticket is created.
Route the call
Each reason for calling has its own branch. The agent creates a ticket before it transfers, so the team picking up already has the context.
- The flow fills in the details of the AI action, such as the tag and the priority of the ticket.
- “Only after ticket is confirmed” makes sure the ticket exists before the call leaves the agent.
Answer common questions
The agent knows which questions it handles itself. This lets it resolve calls instead of passing every caller on.
Qualify a sales enquiry
Sales needs some information before they pick up, so the agent asks first, then transfers.
Your agent asks one question at a time, so a short list keeps the call moving.
When the caller asks for a person
Callers often ask for a person straight away. This step tells the agent how to handle it.
Asking once gets most callers to the right team. If they do not say, the call goes to Nexus Support.
Close an existing ticket
AI actions can also update your systems. Here the agent resolves a ticket once the caller confirms that the issue is fixed.
Rules
This agent ends with a few rules that apply to the whole call. Not every flow needs them.
- The Phone number reference means the agent never asks the caller for it.
- If an AI action fails, the caller still gets a next step.
What to leave out of the flow
Some things have their own setting. Set them there, not in the flow, so your agent does not receive the same instruction twice.
| Leave out of the flow | Set it here | What it does |
|---|---|---|
| Greeting and farewell | Greeting and farewell message, on the During call page | Your agent says them at the start and at the end of every call. |
| Name and tone of voice | Persona | It defines who your agent is and how it sounds. |
| Product information, prices, opening hours | Knowledge sources | Your agent answers caller questions from them. |
| Repeating details back to the caller | Call settings: Always confirm key details | Your agent repeats names, numbers, dates and amounts, and asks the caller to confirm. |
| Asking “anything else?” before ending | Call settings: End call confirmation | Your agent asks if there is anything else it can help with before it ends the call. |
| Call length and silence | Call settings: Maximum call duration and Inactivity timeout | It sets how long a call can last, and what your agent does when the caller goes quiet. |
| What your agent says when it transfers | The transfer message of the branch, in Transfer rules | Your agent says it right before it transfers the call. |
Save and test your flow
Steps:
- Select Save.
- Select Test agent call at the top of the page to call your agent and hear how it follows the flow. You can also run Simulations. Please see Testing your AI Voice Agent with Simulations.
- Change what does not work, and test again. You can edit the flow yourself or ask Ask Aircall to update it.
- Your changes go live when you select Publish changes.
FAQs
How do I tell my AI Voice Agent what to say and do on a call?
Write it in the conversation flow, on the During call page, or ask Ask Aircall to write it for you. The flow covers what to ask, when to look up information and when to transfer or end the call.
Do I have to write the conversation flow myself?
No. Ask Aircall can write it from a description of a good call, or from your call script or SOP. You review it and adjust it.
What happens if I leave the conversation flow empty?
Your agent answers callers using its knowledge sources and its persona.
Can I use the same AI action or branch more than once?
Yes. Insert the reference wherever it is needed. The example uses Nexus Support in Step 3 and in Step 5.
Where do I set the greeting, the tone of voice or the call length?
Not in the flow. Each of them has its own setting. See What to leave out of the flow, above.
Can I reuse the guidelines of an agent created before?
Give them to Ask Aircall with your call script, and it writes a conversation flow for you. Intake questions become steps in the flow, and extraction variables capture the answers. Please see Capturing call data with extraction variables and precall AI actions.