An Outbound AI Voice Agent places calls on your behalf and handles the conversation from the first message to the end of the call. You decide what the agent says, how it handles the conversation, what it does when it reaches voicemail, and when it hands the call to a human.
This article covers setting up the agent itself. To call a list of contacts, add your agent to an Outbound Campaign, the recommended way to place outbound AI calls. The campaign manages your contact list, number pool, calling hours, and retries. For campaign setup, please see Outbound Campaigns: Creating and managing AI Voice Agent campaigns.
Important: Triggering calls by webhook is still supported, but it will be deprecated and moved into Outbound Campaigns. For any new setup, use an Outbound Campaign. Webhook instructions are kept at the end of this article for existing setups.
What is an Outbound AI Voice Agent?
An Outbound AI Voice Agent automatically places calls on your behalf. Instead of waiting for customers to contact you, it proactively reaches out and holds a natural conversation with each contact.
Common use cases include:
- Appointment reminders and confirmations
- Billing and payment follow-ups
- Post-service surveys
- Lead qualification and follow-up
How the agent and the Outbound campaign work together
The agent defines the conversation. The Outbound campaign defines who is called, when, and from which numbers. A campaign references your agent configuration, it doesn't change it.
| Setting | Where you configure it |
|---|---|
| First message and variables | AI Voice Agent |
| Conversational guidelines, knowledge, and intake questions | AI Voice Agent |
| Voicemail behaviour | AI Voice Agent |
| Escalation and call transfer | AI Voice Agent |
| Contact list and variable mapping | Outbound Campaign |
| Number pool | Outbound Campaign |
| Calling hours | Outbound Campaign |
| Call attempts, time between attempts, and ringing time | Outbound Campaign |
| Call outcomes | Outbound Campaign (applied automatically) |
Note: While a campaign is active, the agent it uses is locked for editing. It's released once the campaign is completed or archived. Plan your first message and variables before adding the agent to a campaign.
Before you start
Make sure you have the following ready:
- A clear goal for the call and the first message the agent will open with
- The contact details you want the agent to use in the conversation, for example first name or appointment date, these become your variables
- At least one phone number eligible for automated outbound calling in your target country. Please see Number eligibility for automated outbound calls below
Setting up your agent
Step 1: Create your Outbound AI Voice Agent
- Go to the AI Voice Agent section in your Aircall Dashboard.
- Click Create.
- Select Outbound as the call direction.
- Fill in the configuration fields, including name, voice, knowledge, and intake questions.
- Save your agent.
Note: You don't need to connect a phone number to the agent when you use an Outbound Campaign, numbers are selected in the campaign's number pool. A number connected to the agent is only needed for webhook-triggered calls.
Step 2: Write your first message
The first message is required and is the first thing the agent says when a call is answered.
You can personalize it using placeholders for variables such as {{first_name}} or {{appointment_date}}. They're replaced with each contact's values when the call is placed.
Example:
"Hi {{first_name}}, this is a reminder from {{company_name}} about your appointment on {{appointment_date}}. I'm calling to confirm you're still available at that time."
Where the variable values come from depends on how calls are placed:
| How calls are placed | Where variable values come from |
|---|---|
| Outbound Campaign | Your contact list. Name each variable exactly like the matching CSV column header or HubSpot property name, for example appointment_date, so it can be mapped at import. Contacts missing a mapped value are excluded from the dialing queue. |
| Webhook (legacy) | The context object in each webhook request. Every variable in the first message must be included in the data sent when triggering the call. This ensures the agent has the same context a human agent would need before making a call. |
Tell the contact they're speaking with an AI
Your first message should clearly state that the contact is speaking with an AI assistant, for example: "Hi, this is an automated AI assistant calling on behalf of…". Check the disclosure and consent requirements for your target markets before you launch.
Step 3: Write your conversational guidelines
Use the conversational guidelines to define how the agent handles the call, including:
- The goal of the call
- How to respond to rescheduling requests
- How to handle objections
- When to end the call
Step 4: Configure voicemail handling
Go to the Outbound Call Workflow tab and choose how the agent behaves when voicemail is detected:
- Hang up: the agent disconnects immediately (default)
- Leave a message: the agent plays a message you define. The message supports the same variables as the first message.
Call recording
Recording settings are inherited from the connected phone number and displayed for reference. To modify them, follow the link to the number settings page.
Step 5: Set up escalation and call transfer
By default, if the contact requests a human agent or the AI Voice Agent cannot resolve the query, the outbound call ends. You can configure the agent to transfer the call to a human agent instead.
To enable this:
- Go to Aircall Dashboard > AI Agents > AI Voice Agents and select your AI Voice Agent
- Navigate to the Outbound call workflow section and toggle on Allow for calls to be transferred.
- Select a transfer role: a specific user, a team, or an external number.
- Choose a trigger condition: the agent will transfer the call when this happens.
- Write a transfer message
- Save your changes.
Once configured, when an escalation is triggered the agent plays a transfer message to the contact and performs a cold transfer to the configured destination. In an Outbound Campaign, these calls get the Escalated outcome.
Note: When the destination is a team, calls are distributed using simultaneous ringing with a 30-second ring time.
Step 6: Test your agent
Test the conversation before placing any live calls.
Steps:
- Go to the agent details page.
- Click Test call in the right-hand panel.
- If your first message includes variables, fill them in when prompted.
- Allow microphone access.
- Say "Hello" to start the conversation.
- Click the red hang-up button to end the call.
Placing calls
Option A: Placing calls with an Outbound Campaign (recommended)
Once your agent is tested, add it to an Outbound Campaign. In the campaign, you:
- Select AI agent as the agent type and choose your agent configuration
- Choose the number pool, calling hours, and retry settings
- Import your contacts as a CSV file or HubSpot static segment and map them to your agent's variables
- Confirm compliance and launch
For step-by-step instructions, please see Outbound Campaigns: Creating and managing AI Voice Agent campaigns.
Option B: Trigger calls by webhook (legacy)
Important: Webhook triggering will be deprecated and moved into Outbound Campaigns. Use this method only for existing setups. For new setups, use an Outbound Campaign.
With a webhook, your CRM or automation tool sends one request per contact to trigger each call. Calling hours, retries, and contact lists are managed in your own tool, not in Aircall.
Connect a phone number
Steps:
- Open the agent details page and click Connect number.
- Select a phone number from your available lines and save.
Note: Each agent can be connected to one phone number at a time. To call from several numbers, duplicate the agent, each copy has its own configuration and webhook. Outbound Campaigns support multiple numbers in one number pool.
Add the webhook to your tool
Steps:
- In the Outbound Call Workflow tab, copy the webhook URL under Trigger calls from your tools.
- Paste it into your CRM, scheduling tool, or automation platform and set the request method to POST.
- Select Basic Auth and enter your Aircall API ID and API Token. Click View API Keys in the Outbound Call Workflow tab to retrieve them.
Tip: If your contacts are stored in a spreadsheet or CSV file, use a tool like Zapier or Make.com to convert each row into a webhook trigger. These tools can automatically send a request for each new entry without requiring code.
Send the call data
Each request sends a JSON body with the contact and the values for your variables:
{
"contact_phone": "+15551234567",
"idempotency_key": "reminder-march-20-jane",
"context": {
"first_name": "Jane",
"appointment_date": "March 20th at 2:00 PM"
}
}Field definitions
| Field | What it is |
|---|---|
| contact_phone | The number to call, in E.164 format including the country code, for example +15551234567 |
| idempotency_key | A unique identifier that prevents duplicate calls, such as a contact ID combined with a date |
| context | The values for the variables in your first message and voicemail message |
| Attempt expiration | How long a queued request stays valid. Default 1 hour, maximum 24 hours |
You can send up to 120 requests per minute. Requests are queued and placed within the concurrency limits above. If a request expires before capacity is available, the call isn't placed.
For technical details, please see Trigger an outbound call in the Aircall API reference.
Pre-launch checklist
Before sending your first live call, confirm the following:
- Agent created with Outbound as the call direction
- First message written, including an AI disclosure
- Variable names match your contact list fields (campaign) or your webhook context (webhook)
- Conversational guidelines completed
- Knowledge populated, if applicable
- Voicemail behaviour configured
- Call transfer enabled with a valid destination, if you need human escalation
- Test call completed and behaviour validated
- Agent added to an Outbound Campaign, or webhook configured for existing setups
Monitoring and charges
In an Outbound Campaign, each contact gets an outcome automatically: Human answered, Machine answered, Voicemail, No answer, or Escalated. You can follow progress and outcomes from the campaign dashboard. Call metrics are also available in Aircall Analytics.
A call origination fee applies to each Outbound AI Voice Agent call attempt. Please see Understanding your AI Voice Agent charges.
Limits and eligibility
Concurrency limits
To protect call quality, these limits apply to all Outbound AI Voice Agent calls, whether placed by a campaign or by webhook:
| Limit | Value |
|---|---|
| Concurrent calls per company | 5 |
| Concurrent calls per number | 1 |
In a campaign, the number of phone numbers in the pool sets how many calls can run at the same time, within your company limit. When the limit is reached, the campaign waits and resumes as soon as a call ends.
Number eligibility for automated outbound calls
Some phone numbers can't be used for automated outbound calls. Aircall blocks ineligible numbers automatically during setup.
| Country | Not eligible | Eligible / recommended |
|---|---|---|
| France | Mobile numbers (06, 07); standard geographic numbers (01 to 05, 09) | NPV numbers only (contact the Number Operations team) |
| Spain | Mobile numbers (starting with 6 or 7) | Geographic landlines, for example Madrid or Barcelona |
| Germany | Mobile numbers (015x, 016x, 017x) | Geographic numbers registered to your business |
| Austria | Mobile numbers are not recommended | Geographic numbers |
| Switzerland | Mobile numbers are not recommended | Geographic numbers |