From 17 November 2026, every AI Voice Agent you create has the new setup experience. Agents you created before that date have the legacy experience, with a different left menu and different settings.

For this reason, the setup sections of AI Voice Agents on the same account can look completely different. For example, an agent you created in October and an agent you create in December will not have the same left menu. Nothing is wrong with your account: both experiences work.

This article helps you find out which one your agent has, and which guide to follow.

Words you will see in this article and during your AI Voice Agent configuration

  • Conversation flow: a text box where you write, in your own words, what your agent should do during a call, step by step. For example: greet the caller, ask for the order number, then look it up.
  • Transfer branch: a place your agent can send a call to, such as your Billing team. You create one branch for each destination.
  • Extraction variable: a piece of information you want to receive after the call, such as the caller’s name or the reason for the call. Your agent finds it in the conversation and sends it to you.
  • AI action: a connection to another app, such as HubSpot or Shopify, that lets your agent look up or update information during a call.
  • Call flow: the path a call follows when someone dials your phone number. You set it up in the Numbers section of the Dashboard.

Which experience does your agent have?

Go to Aircall Dashboard > AI Agents > AI Voice Agents. Agents with the legacy experience show a Legacy tag next to their name. Agents without the tag have the new experience. 

To double-check, select your agent to open it, then look at the menu on the left side of the page and compare it with the table below.
 

Legacy experienceNew experience

Guides by task

TaskLegacy experienceNew experience
Configure & create your agentConfiguring your AI Voice Agent (legacy experience) Configuring your AI Voice Agent, Creating your AI Voice Agent
Write what your agent says and doesSections Conversational guidelines and Intake questions in Configuring your AI Voice Agent (legacy experience) Writing the conversation flow of your AI Voice Agent
Set up transfers to your teamSection Call transfer rules in Configuring your AI Voice Agent (legacy experience) Setting up call transfers with transfer rules
Capture data from the callSection Intake questions in Configuring your AI Voice Agent (legacy experience) Capturing call data with extraction variables and precall AI actions
Use AI ActionsUsing AI Actions with AI Voice AgentsUsing AI Actions with AI Voice Agents
Add your agent to a call flowAdding your AI Voice Agent to a call flowAdding your AI Voice Agent to a call flow
Activate or deactivate your agentConnect number in Configuring your AI Voice Agent (legacy experience)Connect number in

Create an agent

Every agent you create from 17 November 2026 has the new experience. On the AI Voice Agents page, select Create AI Voice Agent, then Inbound or Outbound. Then choose how to build your agent: prompt with Ask Aircall, Start from a template or build manually.

For a detailed guideline on how to create an agent please see Creating your AI Voice Agent.

Options to build an Inbound AI Agent

Get the new experience on an agent you created before 17 November 2026

Your legacy agent is never changed, so your callers are not affected. You can get the new experience in two ways:

  • Create a new agent with Ask Aircall: Tell Ask Aircall in your own words what your legacy agent does, and it builds a new agent for you. Your legacy agent stays untouched.
  • Migrate your agent: Migrate from Legacy makes a copy of your agent in the new experience. The copy is a draft, so it does not answer calls yet. Your instructions are copied into its conversation flow, and your AI actions (the connections to other apps, such as HubSpot) carry over.

Migrate your agent

Steps:

  1. Go to Aircall Dashboard > AI Agents > AI Voice Agents.
  2. Open the three-dot menu of your agent and select Migrate from Legacy. 
  3. Open the new agent and check it. Read the conversation flow in During call, and check the AI Actions. Some actions can look like plain text instead of a small coloured label (called a pill). They still work. To tidy them up, delete the text and type / in the flow to add the action again. Please see Writing the conversation flow of your AI Voice Agent.
  4. Test agent call to call your new migrated agent and hear how it answers.
  5. When you are happy with the new agent, publish it. Then go to the call flow of your number, which is the path a call follows when someone dials it, and replace the legacy agent with the new one. Please see Adding your AI Voice Agent to a call flow.
Important: The migrated agent is a draft and is not added to any call flow. Your legacy agent keeps handling calls until you replace it.

What is different?

Both experiences let you configure an agent that answers calls for you. What changes is where you set things up and how you tell your agent what to do. For each thing you may want to set up or update, the table below shows where to find it in the legacy experience and where to find it in the new one.

What you want to set upLegacy experience: where to find itNew experience: where to find it
Who your agent isIn Profile, you give your agent a name and a short description.In Persona, you name your agent (Name) and what it should achieve (Goal). 
How your agent soundsIn Profile, you choose a voice.In Persona, you choose the voice, the language and how formal your agent is. You describe the tone in your own words, for example “Warm and professional”. You can also turn on filler phrases, such as “one moment”, and a soft background sound.
What your agent says and doesIn Call script, you write the greeting and the farewell message. Under it, the conversational guidelines hold the rules your agent follows during the call.In During call, you write the greeting and the farewell message. Then, in one text box called the conversation flow, you write everything your agent should do during the call, step by step, as if you were explaining the job to a new colleague. The flow is optional: if it is empty, your agent can still answer basic questions from your knowledge sources. Please see Writing the conversation flow of your AI Voice Agent.
Connecting to other apps (AI actions)In AI actions, you add the actions your agent can use, such as looking up a contact in HubSpot. A box called Conversation guidelines for these actions is where you explain when to use them.In AI Actions, you add actions in the same way. Then, in the conversation flow available under During call, you type / where your agent should use an action and pick it from the list, or you select Add AI actions next to the action in the side panel. 
Knowing who is callingSome AI actions, such as a contact lookup in HubSpot, Zendesk or Salesforce, have an option called Use for Caller Context. It makes your agent look up the caller before the call starts. It works for inbound calls only.Your agent always knows the caller’s phone number. Under Precall AI actions in Pre- and postcall, you see the actions that run before the call starts, such as a contact lookup. You add them in AI actions with Use for caller context. The list in Pre- and postcall is read only.

FAQs

What do I get with the new experience?

  • Everything in one place. Your agent’s instructions for the call live in one conversation flow, so it is easier to read, check and change. It is also more flexible: you can adapt your agent to your own business logic without introducing contradictions between instructions.
  • Settings your agent follows. The maximum call length, confirming key details, filler phrases and the check-in when a caller goes quiet are real settings, so your agent always follows them.
  • Build and adjust by chatting. With Ask Aircall, you describe what you want in your own words, and you review what it builds.
  • Information after every call. With extraction variables, you choose the details you want to receive, such as the caller’s name or the reason for the call.

Why do two of my AI Voice Agents look different?

They were created on different sides of 17 November 2026. Agents created before that date have the legacy experience, and agents created from that date have the new experience. Agents with the old experience show a Legacy tag in the AI Voice Agent list.

Will my legacy agents change on their own?

Not at the moment. Creating a new agent or cloning an agent does not change your legacy agents for now, and they keep working. Aircall plans to migrate agents to the new experience automatically soon.

Do I have to move my legacy agents to the new experience?

If you don’t migrate them, they will keep working as they are, but Aircall recommends moving to the new experience, for example to read and change your agent more easily or to build it by chatting with Ask Aircall. Create a new agent with Ask Aircall, or migrate the agent. Aircall also plans to migrate agents automatically soon.

Does cloning or creating a new agent change my legacy agent?

No. Your legacy agent is not changed and keeps handling calls until you replace it in the call flow.

Can I migrate from legacy all my agents at once?

No. You migrate agents from legacy one at a time. Review each migrated agent before you use it.

Do my phone numbers and call flows work differently?

No. Connecting a number and adding an agent to the call flow works the same way for both experiences. An agent is active only while it is connected to a number. To deactivate it, remove the number in Connect number and remove the agent from the call flow.

Where are the intake questions in the new experience?

There is no separate Intake questions section. Instead, write the questions you want your agent to ask in the conversation flow, in During call. To receive the answers after the call, add extraction variables in Pre- and postcall: you name the information you want, for example the caller’s first name, and your agent fills it in from the conversation. Please see Writing the conversation flow of your AI Voice Agent.

Which experience does an agent created from a template have?

Until around 27 November 2026, an agent created from a template has the legacy experience, so its left menu shows Profile and Call script. After that date, templates create agents with the new experience.