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.

Screenshot: conversation flow

To open the conversation flow

Steps:

  1. Go to Aircall Dashboard > AI Agents > AI Voice Agents and open your agent.
  2. In the left menu, select During call.
  3. 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:

  1. Open Ask Aircall from your agent by clicking on the green bubble on the top right corner of your screen.
  2. Describe how a good call goes, or paste your call script or SOP (the written steps your team follows).
  3. 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.

Image showing ask aircall

 

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:

  1. In the flow, type "/" where you want the reference.
  2. Choose AI actions, Transfer or Contact information.
  3. Pick the item to insert.
[Screenshot: the / menu with AI actions, Transfer and Contact information]

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.
Available data and actions panel
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.
[Screenshot: the Transfer menu listing Nexus Support, Growth Sales and Vault Billing]
  • Your branches also appear under Transfer in the Available data and actions panel.
Screenshot 2026-11-17 at 12.56.38.png
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.

[Screenshot: Step 1 identifies the caller and uses Search Contact if needed]
  • 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.

[Screenshot: Step 2 checks for open tickets with List Open Tickets]
  • 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.

[Screenshot: Step 3 routes technical and billing issues to their branches]
  • 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.

[Screenshot: Step 4 answers common questions directly]

Qualify a sales enquiry

Sales needs some information before they pick up, so the agent asks first, then transfers.

[Screenshot: the sales enquiry asks a qualifying question, then transfers to Growth Sales]

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.

[Screenshot: Step 5 asks once, then transfers to Nexus Support as the default]

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.

[Screenshot: Step 6 resolves an open ticket with Resolve Ticket]

Rules

This agent ends with a few rules that apply to the whole call. Not every flow needs them.

[Screenshot: the Rules section using the Phone number reference]
  • 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 flowSet it hereWhat it does
Greeting and farewellGreeting and farewell message, on the During call pageYour agent says them at the start and at the end of every call.
Name and tone of voicePersonaIt defines who your agent is and how it sounds.
Product information, prices, opening hoursKnowledge sourcesYour agent answers caller questions from them.
Repeating details back to the callerCall settings: Always confirm key detailsYour agent repeats names, numbers, dates and amounts, and asks the caller to confirm.
Asking “anything else?” before endingCall settings: End call confirmationYour agent asks if there is anything else it can help with before it ends the call.
Call length and silenceCall settings: Maximum call duration and Inactivity timeoutIt sets how long a call can last, and what your agent does when the caller goes quiet.
What your agent says when it transfersThe transfer message of the branch, in Transfer rulesYour agent says it right before it transfers the call.

Save and test your flow

Steps:

  1. Select Save.
  2. 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.
  3. Change what does not work, and test again. You can edit the flow yourself or ask Ask Aircall to update it.
  4. 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.