This article explains how to collect information from your calls with your AI Voice Agent. You will learn how to receive the details you need after a call, such as the caller’s name or the reason for calling (extraction variables), and how to give your agent information about the caller before the call starts, such as a contact found in your CRM (precall AI actions).
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.
Extraction variables: receive the details you need after a call
An extraction variable is a piece of information you want to receive after a call, such as the caller’s first name or the reason for the call. When the call is transferred or ends, your agent reads the conversation, finds the information and sends it in the call summary note and the webhook.
- You can add up to 25 extraction variables. Start with a few, and add only what you need.
- Your agent finds the information in the call transcript. You do not need to mention the variables in the conversation flow.
- If your agent has to ask the caller for a value, put the question in the conversation flow.
Add an extraction variable
Steps
- Go to Aircall Dashboard > AI Agents > AI Voice Agents and open your agent.
- In the left menu, select Pre- and postcall.
- Under Postcall, in Extraction variables, select Add variable.
- In Key, enter a short name for the information, for example first_name. A key can only use lowercase letters and underscores: spaces become underscores as you type, and uppercase letters are not available.
- In Description, explain what your agent should look for in the conversation. Your agent uses this description to find the information.
- Repeat for each value. Select the X next to a variable to remove it.
Examples
| Key | Description | What you receive |
|---|---|---|
| first_name | The customer’s first name | The caller’s first name, if they say it during the call |
| reason_for_call | What was the reason for the call | A short summary of why the caller phoned |
| order_number | The order number the caller mentions | The order number, if the caller gives one |
Tip: Write the description as if you were explaining to a colleague what to look for. The clearer the description, the better your agent finds the information.
If you used intake questions
The new experience has no Intake questions section. Write the questions in the conversation flow, and create one extraction variable for each answer you want to receive after the call. See Writing the conversation flow of your AI Voice Agent.
Precall AI actions: give your agent information before the call
A precall AI action runs before the call starts, using the phone number of the caller. For example, your agent can look up the caller in your CRM, so it knows who is calling from the first word. If nothing is found, the call continues without it.
- Your agent always knows the caller’s phone number, even if the conversation flow does not mention it.
- Precall AI actions work for inbound calls only.
- Use precall actions for lookups. Actions that change something, such as booking a meeting, belong in the conversation flow, not before the call.
- Only some actions can run before the call: Search Contact in Zendesk, Get Contact in HubSpot and Find Customer in Salesforce.
Add a precall AI action
Steps
- Go to Aircall Dashboard > AI Agents > AI Voice Agents and open your agent.
- In the left menu, select AI actions, then Add AI action.
- Choose the integration, for example HubSpot, then the action that finds a contact, for example Get Contact. For specific AI Actions setup guides, please visit our AI Actions setup guides section.
- Select Use for caller context if the AI Action has that checkbox.
- Save your changes. The action now appears in Pre- and postcall, under Precall AI actions.
The list in Pre- and postcall is read only. To change or remove a precall action, go back to AI actions.
FAQs
How many extraction variables can I add?
Up to 25. Start with a few, and add more only when you need them.
Do I need to mention extraction variables in my conversation flow?
No. Your agent finds the information in the transcript after the call. Only put a question in the flow if your agent has to ask the caller for the value.
What is the difference between a precall action and an extraction variable?
A precall AI action brings information in before the call starts, such as who the caller is. An extraction variable sends information out after the call, such as why the caller phoned.
Are there other actions after the call?
Not at the moment. Extraction variables are the only postcall setting you can configure. 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.