This article explains how to configure your AI Voice Agent. You will set up who your agent is and how it sounds, what it says and does during a call, the information it uses to answer questions, how it handles transfers, and how it goes live on your phone number. Use it to configure a new agent or to update an agent you have already created.
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.
Manage your agents from the AI Voice Agents page
The main AI Voice Agents page lists all agents you have created, showing each agent's name, type, description, status, and calls in the last 7 days.
From this page you can also:
- Track your free trial minutes or current usage for the billing period using the usage tracker at the top of the page
- Edit, migrate from legacy, export config or delete an agent using the three-dot menu next to its name
- Set a usage alert to get notified by email when consumption reaches a threshold you define
Important: The usage tracker shows minutes used against your alert threshold, not your total plan minutes. For example, 942 / 950 min means 942 minutes have been used toward a 950-minute alert threshold, not that your plan only includes 950 minutes. Check the Billing section of your Aircall Dashboard to confirm your plan's actual monthly minute allowance.
Note: If the agent is still assigned to a call flow, you will see a warning requiring you to unassign it before deletion.
Set a usage alert
Steps:
- Go to Aircall Dashboard > AI Agents > AI Voice Agents.
- Click the three-dot menu in the top-right corner.
-
Select Monitor consumption.
-
Under Send an alert at (in minutes), enter the number of minutes at which you want to be notified.
- Toggle on Notify the billing email and/or Notify my email, depending on who should receive the alert.
- Click Apply
Tip: These alerts are informative only. Reaching the threshold does not pause or interrupt your AI Voice Agent service.
Open your agent
Go to Aircall Dashboard > AI Agents > AI Voice Agents and select your agent. The page lists your agents with their name, type, description, status and calls in the last 7 days. To build a new agent, select Create AI Voice Agent.
Your agent menu
The left menu groups the settings in three areas:
- Configure: Persona, During call, Pre- and postcall, Call settings, Memory, AI actions, Knowledge sources and Transfer rules.
- Deploy: Simulations and Connect number.
- Monitor: Performance.
At the top of every page, Test agent call lets you call your agent at any time. At the bottom, you save and publish your changes.
Persona
Persona defines who your agent is and how it sounds.
- Name: name your agent, for example, “Lara”. It's shown in the agent list.
- Goal: write one sentence about what your agent should achieve, for example “Answer order questions when the team is offline”.
- Tone and speaking style: describe in your own words how your agent sounds and speaks, for example “Warm and professional. Keep it short and plain, no jargon.”
Audio
- Language: select the language your agent speaks. For the list of languages, see Aircall’s AI Voice Agent overview.
- Formality: select Formal, Informal or Adapt to the caller. With Adapt to the caller, your agent starts formal, then matches the caller. It applies to languages that distinguish formal and informal address, such as “vous” and “tu” in French, or “Sie” and “Du” in German.
- Voice: select the voice of your agent.
- Noise removal: filters out noise on the caller’s side so your agent hears them clearly. Off by default.
- Filler phrases: uses short phrases like “let me check” or “one moment” to fill pauses. On by default.
- Ambient sound: plays a soft background sound so calls feel more natural. Off by default.
- Voice settings: adjust three sliders. Temperature (Stable to Variable) controls how stable or varied the voice sounds. Similarity controls how closely the voice matches the original voice: higher values increase similarity. Speed (Slower to Faster) controls how quickly the voice speaks.
During call
During call sets what your agent says at the start and at the end of a call, and what it does in between.
Greeting and farewell message
- Greeting message: write the first thing callers hear when your agent answers, for example “Hi, thanks for calling. How can I help you today?” Say that callers are speaking with an AI Voice Agent, and what the agent can and cannot help with.
- Farewell message: write the last message callers hear when your agent ends a call.
If Infer greeting from the handoff context is on in Memory, your agent does not use this greeting when it receives a call from another AI Voice Agent.
Tip: Avoid special characters in these messages, as they may cause your agent to misread the text. Characters to avoid include emojis, accented letters (é, ñ), symbols (€, ™) and non-Latin scripts such as Cyrillic or Chinese characters.
Conversation flow
The conversation flow tells your agent what to ask, when to look up information, and when to transfer or end the call. If you create your agent with Ask Aircall, it writes the flow for you and you review it. If your agent only answers questions, leave the flow empty. For more, see Writing the conversation flow of your AI Voice Agent.
On the right, Available data and actions lists the AI actions, transfer branches and contact information you can add to the flow. Select + next to an item, or type / in the flow, to insert it.
Pre- and postcall
Pre- and postcall lets your agent run actions before the call starts and capture data when it ends.
Precall AI actions
Precall AI actions run with the caller’s phone number before the call starts, so your agent knows who is calling from the first word. For example, a CRM contact lookup. If nothing is found, the call continues without it. The list in Pre- and postcall is read only.
To add one, select Use for caller context on the action in AI actions. Only some actions support this: Search Contact in Zendesk, Get Contact in HubSpot and Find Customer in Salesforce.
Extraction variables
Extraction variables are the values you want to see after the call, for example the caller’s first name or the reason for the call. When the call is transferred or ends, your agent reads the call transcript, finds the values and adds them to the call summary note and the webhook. You can add up to 25 variables. Start with a few and add only what you need.
Steps
- In Postcall, under Extraction variables, select Add variable.
- In Key, enter a short name for the value, for example first_name. Keys use snake_case: spaces become underscores as you type, and uppercase letters are not available.
- In Description, describe what to find in the transcript, for example “The customer’s first name” or “The reason for the call”. Your agent uses this description to find the value.
- Repeat for each value. Select the X next to a variable to remove it.
Extraction variables run on the transcript after the call, so you do not need to mention them in the conversation flow. They are the only setting you can configure after the call. If a call is transferred to a person, the reason for the transfer is also sent with the call data, but you cannot configure it.
Your agent always knows the caller’s phone number, even if the conversation flow does not mention it. For more details, please see Capturing call data with extraction variables and precall AI actions.
Call settings
Call settings apply to every call your agent handles.
- Maximum call duration: choose between 1 and 30 minutes. The default is 10 minutes, which is recommended for performance.
- Always confirm key details: your agent repeats back details like names, numbers, dates and amounts, and asks the caller to confirm. On by default.
- End call confirmation: before ending the call, your agent asks if there is anything else it can help with. On by default.
When the caller goes quiet, your agent checks in with a message it generates. This is not configurable.
Memory
Memory controls how your agent uses information from other conversations.
- Infer greeting from the handoff context: if your agent receives a call from another AI Voice Agent, it creates the greeting from what the caller already said instead of using your greeting message. Please see How AI Voice Agents share context during a live transfer.
- Conversational memory: allow this agent to use insights from past interactions when responding to callers. For global memory settings, please see AI Settings: manage your AI configuration in one place.
A notice reminds you that an agent that does not use memory also contributes to it: its conversations feed the shared memory used by agents with memory enabled.
AI Actions
Under AI Actions you can let your agent connect to other apps during calls to find, update or create information. Select Add AI action and choose the action. For the setup of each integration, please see Using AI Actions with AI Voice Agents.
Note: There is no “Conversation guidelines for these actions” box. Write when to use each action in your conversation flow by inserting the action with /. See Writing the conversation flow of your AI Voice Agent.
Knowledge sources
Add the sources your agent uses to answer caller questions. The page lists your sources with their Name, Context and Capacity. An Optimization capacity bar at the top of the page shows how much of your 300,000-character limit your knowledge sources use.
Select Add source to add one. Changes apply automatically once processing is complete. For best practices, please see Using knowledge sources for your AI Agents.
At the bottom of the page, under Company information, enter your Company name (required), which your agent uses on calls, and an optional Company description.
Transfer rules
Transfer rules let your agent hand a call over to your team. Turn on Allow your agent to transfer the call, then select Add transfer branch for each destination. Each branch has a name and a transfer message, and adds a matching branch to the call flow of your number, where you choose its destination. A Fallback transfer branch is included.
To tell your agent when to use a branch, write it in your conversation flow and insert the branch there. You can also insert the Fallback transfer. Please see Setting up call transfers with transfer rules.
Important: To receive transfers, add your agent to the call flow of a number.
Connect number
Connect number puts your agent on a phone number.
Steps
- Under Deploy, select Connect number.
- Select an existing number, or create and buy a new one. The call flow of the number opens.
- Add your agent to the call flow.
- Save and publish the call flow.
For details, please see Adding your AI Voice Agent to a call flow.
Deactivate your agent
Steps
- Under Deploy, select Connect number.
- Remove the number from your agent.
- Open the call flow of that number in the Call flow editor, remove your agent from it, then save and publish the call flow.
Note: An agent answers calls only while it is connected to a number. You cannot pause an agent and keep it in the call flow of a number, because the call flow would stop working. For outbound agents, pausing a campaign does not deactivate the agent.
Test and improve your AI Voice agent
- Select Test agent call at the top of the agent page to call your agent and hear how it handles a conversation.
- Test in the chat: open a text test chat in Ask Aircall.
- In Simulations, create scenarios and run them as often as you like, or test your agent with a text conversation. Please see Testing your AI Voice Agent with Simulations.
- Ask Aircall to create test scenarios and simulations. Run them against your draft and show the pass and fail rates, the unmet criteria and the transcripts. It can also explain why a simulation failed and propose fixes.
- Change anything: ask for changes in the Ask Aircall chat, or edit any section yourself. The chat and the agent settings stay in sync, in both directions.
Examples of requests you can make:
- “Make the tone more formal and switch the language to French.”
- “Collect the caller’s name, email and order number.”
- “Transfer calls about invoices to the Billing team.”
- “What is different between my draft and the published version?”
- “Evaluate my agent and tell me what to improve.”
- “Create a test where the caller asks for a refund outside opening hours.”
- “Why did my last simulation fail?”
Note: Tests and simulations do not use your live integrations. Tools such as HubSpot or Shopify are simulated: no real data is read or written, and no real calls are made. Check the connection status of your integrations before you go live.
Save and publish your changes
Your changes stay as a draft until you publish them. Your agent answers calls only while it is connected to a phone number. Until then, its status is Inactive. See Connect number, above.
- Save: stores your changes as a draft. Your live agent is not affected.
- Publish changes: makes your saved changes live.
- Discard draft and Delete agent: in the three-dot menu at the bottom right.
Monitor your agent
Under Monitor, select Performance to see how your agent handles calls. Please see Understand and improve your AI Voice Agent with Agent performance and Track AI Voice Agent's performance.
Connect your agent to your tools
Your agent can use your content and your tools during calls, through knowledge sources and AI actions. To learn how to connect your agent to your tools, please see visit Connecting your AI Agents.
FAQs
Can I rename my agent?
Yes. To rename your agent, change the Name in Persona. The new name appears in your list of agents.
Where are the intake questions?
There is no Intake questions section. Write the questions in the conversation flow and capture the answers with extraction variables. Please see Writing the conversation flow of your AI Voice Agent.
Can I get these sections on an agent that shows Call script?
Yes. Migrate the agent from the legacy experience, or create a new one with Ask Aircall. Please see Find your AI Voice Agent setup guide.
Do changes to knowledge sources need to be published?
No. Changes to knowledge sources apply automatically once processing is complete.
How do I deactivate or pause my AI Voice Agent?
You cannot pause an agent while it stays in the call flow of a number. To deactivate your agent, remove the number in Connect number, then remove the agent from the call flow in Smartflows. See Connect number, above. For an outbound agent, pausing a campaign does not deactivate the agent.