Skip to main content
ElevenLabs Documentation Docs

Search documentation

Type to search this documentation.

On this pageOverview

Batch calling

Initiate multiple outbound calls simultaneously with your ElevenLabs agents.

https://www.youtube-nocookie.com/embed/TIOnL1TwzBs?rel=0

Overview

Section titled “Overview”

Batch Calling enables you to initiate multiple outbound calls simultaneously using your configured ElevenLabs 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

Section titled “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 separate columns.
  • Agent selection: Choose the specific ElevenLabs 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.

Concurrency

Section titled “Concurrency”

When batch calls are initiated, they automatically utilize the minimum of either 50% of your workspace’s concurrency limit or 70% of your agent’s concurrency limit. This ensures that sufficient concurrent capacity remains available for other conversations, including incoming calls and calls via the widget.

Requirements

Section titled “Requirements”
  • An ElevenLabs account with an agent setup.
  • A phone number imported

Creating a batch call

Section titled “Creating a batch call”

Follow these steps to create a new batch call:

  1. Navigate to Batch Calling

    Access the Outbound calls interface from the ElevenAgents dashboard

  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 ElevenLabs 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.

  5. Set timing

    • Send immediately: The batch call will start processing as soon as you submit it. - Schedule for later: Choose a specific date, time, and timezone 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

Section titled “Managing and monitoring batch calls”

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

Batch calling overview

Section titled “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

Section titled “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

Section titled “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.

Suggest an edit

Propose a replacement for this page. The site team reviews it before applying any changes.

Export
Documentation menu