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.

SettingWhere you configure it
First message and variablesAI Voice Agent
Conversational guidelines, knowledge, and intake questionsAI Voice Agent
Voicemail behaviourAI Voice Agent
Escalation and call transferAI Voice Agent
Contact list and variable mappingOutbound Campaign
Number poolOutbound Campaign
Calling hoursOutbound Campaign
Call attempts, time between attempts, and ringing timeOutbound Campaign
Call outcomesOutbound 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

  1. Go to the AI Voice Agent section in your Aircall Dashboard.
  2. Click Create.
  3. Select Outbound as the call direction.
  4. Fill in the configuration fields, including name, voice, knowledge, and intake questions.
  5. 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 placedWhere variable values come from
Outbound CampaignYour 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:

  1. Go to Aircall Dashboard > AI Agents > AI Voice Agents and select your AI Voice Agent
  2. Navigate to the Outbound call workflow section and toggle on Allow for calls to be transferred.
  3. Select a transfer role: a specific user, a team, or an external number.
  4. Choose a trigger condition:  the agent will transfer the call when this happens.
  5. Write a transfer message
  6. Save your changes.
image showing outbound call workflow section

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:

  1. Go to the agent details page.
  2. Click Test call in the right-hand panel.
  3. If your first message includes variables, fill them in when prompted.
  4. Allow microphone access.
  5. Say "Hello" to start the conversation.
  6. 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:

  1. Open the agent details page and click Connect number.
  2. 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:

  1. In the Outbound Call Workflow tab, copy the webhook URL under Trigger calls from your tools.
  2. Paste it into your CRM, scheduling tool, or automation platform and set the request method to POST.
  3. 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

FieldWhat it is
contact_phoneThe number to call, in E.164 format including the country code, for example +15551234567
idempotency_keyA unique identifier that prevents duplicate calls, such as a contact ID combined with a date
contextThe values for the variables in your first message and voicemail message
Attempt expirationHow 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:

LimitValue
Concurrent calls per company5
Concurrent calls per number1

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.

CountryNot eligibleEligible / recommended
FranceMobile numbers (06, 07); standard geographic numbers (01 to 05, 09)NPV numbers only (contact the Number Operations team)
SpainMobile numbers (starting with 6 or 7)Geographic landlines, for example Madrid or Barcelona
GermanyMobile numbers (015x, 016x, 017x)Geographic numbers registered to your business
AustriaMobile numbers are not recommendedGeographic numbers
SwitzerlandMobile numbers are not recommendedGeographic numbers