Introduction

Batch calls let you initiate high-volume call campaigns by uploading a list of recipients via CSV. These calls share a dynamic prompt or pathway, and you can monitor progress and results from a centralized dashboard. Common use cases include:

Outbound Campaigns

Reach customers with limited-time offers or updates.

Customer Reminders

Follow up with clients for appointments, payments, or check-ins.

Lead Qualification

Qualify or re-engage leads from your CRM or sign-up funnel.

Data Collection

Prompt users for updated contact info, preferences, or survey responses.

Creating a Batch Call

To start a batch call:
  1. Navigate to the Batch Calls page in the sidebar.
  2. Click Create Batch Call in the top right.
You’ll land on a configuration screen similar to the normal call creation flow, with the addition of a CSV upload step. Batch calls are built around a CSV file containing all information on your recipients, with each row representing a single recipient. Batch Call Creation UI

Required Fields

Your uploaded CSV must include at least one column titled phone_number. Additional columns can be included to define dynamic variables referenced during the call. Example format:
phone_numberbusiness_nameprevious_customerchampion_namewebhook
+12345678909South Bay CoffeeYesSarah Hhttps://example.com/webhook1
+10987654321John’s LaundryNoJohn Whttps://example.com/webhook2
With this CSV, we are aiming to send 2 calls out in our batch, to +12345678909 and +10987654321. In each of those calls, we can have access to the information in the other columns (business_name, previous_customer, champion_name, webhook) throughout our prompt or pathway, similar to request data in a normal call. In order to gain access to these, we can either format the CSV column names to prepend ‘request_data.’ to each column name (request_data.business_name, request_data.previous_customer, etc.) or we can convert them all through our UI: Batch Call CSV Conversion
Above shows how we set each column to be mapped to use as request data during each call. Alternatively, you can set each column to be mapped to any other call configuration setting.
Once we mark the column as request data, we can reference it in our prompt or pathway using the familiar {{column_name}} syntax.

Monitoring Batch Progress

After launching a batch, return to the Batch Calls dashboard You’ll see each batch listed with:
  • Status (e.g. Completed, Partial, Failed)
  • Batch Name
  • Batch Timestamp
  • Batch ID
  • Buttons to View Logs and Cancel the Batch

Understanding Batch Statuses

Your batch will progress through various statuses as it processes. Here’s what each status means:
  • Initializing - The batch is being set up and prepared for processing. This happens immediately after creation.
  • Validating - The system is verifying your CSV format, phone numbers, and call parameters before dispatching.
  • Dispatching - Calls are being actively sent out to recipients from your CSV.
  • In Progress - Calls are actively being processed and conversations are ongoing.
  • In Progress (Chunked) - Large batches are being processed in smaller chunks for better performance.
  • Waiting for Scheduled Calls - The batch is waiting for calls with specific start times to be executed.
  • Completed - All calls in the batch were successfully processed and finished.
  • Completed Partial - Some calls succeeded, but some failed or were skipped. Check the logs for details.
  • Failed - The entire batch failed to process due to a critical error. Review the error logs for troubleshooting.

Example Use Case

Let’s say you’re running a follow-up campaign for returning customers Upload a CSV like:
phone_numbercustomer_nameservicedate
12345678909EmilyHome CleaningJuly 10
Then set your prompt:
Hi {{customer_name}}, just checking in to see if you'd like to 
schedule your next {{service}}. We're available as early as {{date}}. 
Would you like me to get that on the books?
The agent will automatically personalize each call using the values from that row in your CSV

Frequently Asked Questions

Invalid or blank numbers will be skipped automatically and reported in the error logs
Yes. Any tools or pathways configured in your call settings will apply across the batch
Use the Call Logs page (filtered by batch ID) to inspect each call’s transcript, outcome, and variables
You can use our API to send a batch call. See our API Reference for more details.