PHONE NUMBERS

Batch calling

Initiate multiple outbound calls simultaneously with your Conversational AI agents.

When conducting outbound call campaigns, ensure compliance with all relevant regulations, including the TCPA (Telephone Consumer Protection Act) and any applicable state laws.

Overview

Batch Calling enables you to initiate multiple outbound calls simultaneously using your configured Conversational AI agents. This feature is ideal for scenarios such as sending notifications, conducting surveys, or delivering personalized messages to a large list of recipients efficiently. This feature is available for both phone numbers added via the native Twilio integration and SIP trunking.

Key features

  • Upload recipient lists: Easily upload recipient lists in CSV or XLS format.
  • Dynamic variables: Personalize calls by including dynamic variables (e.g., user_name) in your recipient list as seperate columns.
  • Agent selection: Choose the specific Conversational AI agent to handle the calls.
  • Scheduling: Send batches immediately or schedule them for a later time.
  • Real-time monitoring: Track the progress of your batch calls, including overall status and individual call status.
  • Detailed reporting: View comprehensive details of completed batch calls, including individual call recipient information.

Requirements

  • An ElevenLabs account with an agent setup.
  • A phone number imported

Creating a batch call

Follow these steps to create a new batch call:

2

Initiate a new batch call

Click on the “Create a batch call” button. This will open the “Create a batch call” page.

Create a batch call page showing fields for batch name, phone number, agent selection, recipient upload, and timing options.
The 'Create a batch call' interface.
3

Configure batch details

  • Batch name: Enter a descriptive name for your batch call (e.g., “Delivery notice”, “Weekly Update Notifications”).
  • Phone number: Select the phone number that will be used to make the outbound calls.
  • Select agent: Choose the pre-configured Conversational AI agent that will handle the conversations for this batch.
4

Upload recipients

  • Upload File: Upload your recipient list. Supported file formats are CSV and XLS.
  • Formatting:
    • The phone_number column is mandatory in your uploaded file (if your agent has a phone_number dynamic variable that also has to be set, please rename it).
    • You can include other columns (e.g., name, user_name) which will be passed as dynamic variables to personalize the calls.
    • A template is available for download to ensure correct formatting.
Setting overrides

The following column headers are special fields that are used to override an agent’s initial configuration:

  • language
  • first_message
  • system_prompt
  • voice_id

The batch call will fail if those fields are passed but are not set to be overridable in the agent’s security settings. See more here.

5

Set timing

  • Send immediately: The batch call will start processing as soon as you submit it. - Schedule for later: Choose a specific date and time for the batch call to begin.
6

Submit the batch call

  • You may “Test call” with a single recipient before submitting the entire batch. - Click “Submit a Batch Call” to finalize and initiate or schedule the batch.

Managing and monitoring batch calls

Once a batch call is created, you can monitor its progress and view its details.

Batch calling overview

The Batch Calling overview page displays a list of all your batch calls.

Batch Calling overview page listing several batch calls with their status, recipient count, and progress.
Overview of batch calls, displaying status, progress, and other details for each batch.

Viewing batch call details

Clicking on a specific batch call from the overview page will take you to its detailed view, from where you can view individual conversations.

Batch call details page showing a summary (status, total recipients, started, progress) and a list of call recipients with phone number, dynamic variables, and status.
Detailed view of a specific batch call, showing summary statistics and a list of call recipients with their individual statuses.

API Usage

You can also manage and initiate batch calls programmatically using the ElevenLabs API. This allows for integration into your existing workflows and applications.