Skip to content

outbound campaigns quickstart and overview #531

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Jun 24, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 2 additions & 22 deletions fern/calls/call-outbound.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -78,29 +78,9 @@ Use both `customers` and `schedulePlan` together to schedule batched calls.
}
```

## Uploading Your CSV File to the Dashboard
## Creating Outboud Calls from the Dashboard

Use the [`example template`](../static/batch-sample.csv) to get started.

* The only required columns are **`phone`** and **`name`**.
* Any other columns (like `appointment_time`, `location`, etc.) can be used as dynamic variables in your assistant's script.

## How to Launch a Batch Call

1. Go to **Phone Numbers** in the sidebar.
2. Select the **number** you want to call from.
3. Scroll to **Outbound Settings** → click **Call Many Numbers**.
4. **Upload your CSV file** (drag & drop or click to upload).
5. Select your **Assistant**, **Squad**, or **Workflow**.
6. Click **Make Calls** to start now, or **Schedule Calls** to set a future date/time.

> *Calls will run concurrently — not sequentially.*

## Tips for Clean Data

* Use **UTF-8 encoding** when saving your CSV.
* Avoid blank rows or duplicated headers.
* Double-check that your column names match the variables used in your assistant.
Learn more about how to launch [Outbound Calling Campaigns via Dashboard](/outbound-campaigns/quickstart)

## Trusted Calling and Caller ID

Expand Down
9 changes: 9 additions & 0 deletions fern/docs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -367,6 +367,15 @@ navigation:
path: squads/silent-transfers.mdx
icon: fa-light fa-arrow-right-arrow-left

- section: Outbound Campaigns
contents:
- page: Quickstart
path: outbound-campaigns/quickstart.mdx
icon: fa-light fa-rocket
- page: Overview
path: outbound-campaigns/overview.mdx
icon: fa-light fa-eye

- section: Chat
contents:
- page: Quickstart
Expand Down
110 changes: 110 additions & 0 deletions fern/outbound-campaigns/overview.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,110 @@
---
title: Outbound campaigns overview
subtitle: Create, execute, and manage outbound phone campaigns directly within the Vapi Dashboard
slug: outbound-campaigns/overview
description: Learn how to efficiently schedule calls, manage recipients, analyze performance metrics, and review detailed call logs and transcripts with Vapi's Outbound Call Campaigns
---

## Overview

Outbound Call Campaigns allow users to efficiently create, execute, and manage outbound phone campaigns directly within the Vapi Dashboard. It enables users to efficiently schedule calls, manage recipients, analyze performance metrics, and review detailed call logs and transcripts.

<Frame>
<img src="../static/images/outbound-campaigns/campaigns.jpeg" alt="Vapi Setup Campaign" />
</Frame>

## Key benefits

- **Intuitive UI**: Quickly set up campaigns in an easy-to-follow setup page
- **Personalized**: Use dynamic variables to personalized outreach
- **Analytics**: Get real-time monitoring and detailed analysis of call performance and outcomes

## Common use cases

- **Conversion Optimization**: Re-engage potential customers via targeted follow-up calls for abandoned carts
- **Appointment Reminders**: Reduce missed appointments with timely reminder calls
- **Customer Satisfaction**: Conduct post-service feedback and follow-up calls to enhance customer experiences
- **Subscription Renewals**: Facilitate timely renewals with proactive call reminders
- **Insurance Updates**: Verify and update policy details through targeted calls

## Campaign setup process

Outbound Call Campaigns follow a structured process:

<Steps>
<Step title="Campaign Configuration">
Set campaign name and type.
</Step>

<Step title="Phone Number Selection">
Choose outbound phone numbers (recommend Twilio).
</Step>

<Step title="Recipient Management">
Upload recipients via CSV, supported with dynamic variables.
</Step>

<Step title="Assistant Selection">
Select an existing assistant to handle the call.
</Step>

<Step title="Review & Execute">
Review campaign and initiate or schedule calls for later.
</Step>
</Steps>

## Campaign analytics

The Campaign Dashboard provides comprehensive insights:

- **Campaign Overview**: Monitor status, completed calls, pick up rate, and voicemail
- **Detailed Call Reports**: Access individual call details, customer information, call duration, outcome statuses, and transcripts

## Required information

Outbound Campaigns only require a number to work. `number` column is required and needs to be spelled in lowercase.

| number | |
| --- | --- |
| +14151231234 | |
| +14153455678 | |

<Note>
Phone numbers must be formatted in E.164 format: [+] [country code] [subscriber number including area code]
- Example: +14151234567
- Maximum 15 digits total
- No spaces or special characters
</Note>

## Tips for Clean Data
- Use UTF-8 encoding when saving your CSV.
- Avoid blank rows or duplicated headers.
- Double-check that your column names match the variables used in your assistant.

## Avoiding Spam

To maximize call answer rates and establish trust with recipients, you should implement proper caller identification and trusted calling standards. This involves several key components that work together to verify your identity and build caller reputation.
Learn more about [Trusted Calling](/calls/outbound-calling#trusted-calling-and-caller-id)

## Dynamic variables

Outbound Campaigns allows users to specify dynamic variables to pass to Assistants via additional columns in the CSV file. Outbound Campaigns can take one more additional columns.

| number | name | customer_issue |
| --- | --- | --- |
| +14151231234 | John | password reset |
| +14153455678 | Mary | address update |

`{{name}}` and `{{customer_issue}}` can be used in the Assistant prompt as dynamic variables, based on this CSV file.

<Note>
- Column names cannot have spaces. Use `{{customer_issue}}` instead of `{{customer issue}}`
- Column names must start with a letter
- Users can use the same [Default Variables](/assistants/dynamic-variables#default-variables) as they can within Assistants
</Note>

## Concurrency

Check concurrency limits in your Vapi organization. If your org has a concurrency limit of 10, a maximum of 10 calls will be started at a single time. The rest of the calls will be queued and retried a few minutes later as your concurrency slots become available. To increase call rate, you need you increase your Vapi org concurrency limit.

Note that concurrency limits are on the Vapi side. Your telephony provider (e.g. Twilio) may have other rate limits.
93 changes: 93 additions & 0 deletions fern/outbound-campaigns/quickstart.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,93 @@
---
title: Outbound campaigns quickstart
subtitle: Build a simple personalized outbound campaign that conducts post-service feedback and follow-up calls to improve customer experience
slug: outbound-campaigns/quickstart
description: Build a simple personalized outbound campaign that conducts post-service feedback and follow-up calls to improve customer experience
---

## Overview

Build a simple personalized outbound campaign using Vapi that conducts post-service feedback and follow-up calls to improve customer experience and gather valuable insights from your customers.

<Frame>
<img src="../static/images/outbound-campaigns/setup.jpeg" alt="Vapi Campaigns" />
</Frame>


**In this quickstart, you'll learn to:**
- Set up an outbound campaign with customer data
- Configure personalized feedback collection calls
- Launch and monitor campaign performance
- Access detailed call outcomes and analytics

## Prerequisites

- A [Vapi account](https://dashboard.vapi.ai)
- Phone number set up in your organization with a provider like Twilio (Vapi free numbers do not work for Outbound Campaigns)
- Recipient information ready in CSV format
- An existing Assistant configured in your account

---

## 1. Launch a Campaign

<Steps>
<Step title="Open the Vapi Dashboard">
Go to [dashboard.vapi.ai](https://dashboard.vapi.ai) and log in to your account.
</Step>

<Step title="Navigate to Outbound Campaigns">
Click `Outbound Campaigns` in the left sidebar to access the campaigns section.
</Step>

<Step title="Create a new campaign">
- Click **Create Campaign**
- Enter a **Campaign Name** (e.g., "Post-Service Feedback Campaign")
- Select **Campaign Type** based on your feedback collection needs
</Step>

<Step title="Configure phone number">
Select a phone number from your available numbers. This must be a number from your phone provider (like Twilio), not a Vapi free number.
</Step>

<Step title="Manage recipients">
Upload your customer list:
- Click **Manage Recipients**
- Upload your CSV file with customer information
- Review the recipient list for accuracy
- Follow [best practices](/outbound-campaigns/overview#required-information) on how to format your CSV file
</Step>

<Step title="Select assistant">
Choose the Assistant that will conduct the feedback calls:
- Select from your existing Assistants
</Step>

<Step title="Review and execute">
- Review all campaign settings
- Verify recipient count and Assistant configuration
- Click **Launch Campaign** to start the outbound calls
</Step>
</Steps>

---

## 2. Monitor Your Campaign

<Steps>
<Step title="Access campaign dashboard">
Once launched, monitor your campaign performance in real-time through the Campaign Dashboard.
</Step>

<Step title="Review campaign outcomes">
- View completion rates and call statuses
- Track progress of scheduled campaigns
- Cancel campaigns you no longer want to run
</Step>

<Step title="Track individual calls">
See call logs for each customer contact, including:
- Call duration and outcome
- Transcript and recordings
</Step>
</Steps>
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added fern/static/images/outbound-campaigns/setup.jpeg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading