> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tala-assistant.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Campaigns

> Run automated outbound calling campaigns at scale

## Overview

Campaigns let you automate outbound calls to lists of contacts. Perfect for appointment reminders, follow-ups, lead qualification, and customer outreach.

## How Campaigns Work

1. **Prepare your contact list** (CSV file)
2. **Select a voice agent** (workflow)
3. **Configure campaign settings**
4. **Launch and monitor**

Your voice agent calls each contact automatically, handling conversations and recording outcomes.

## Creating a Campaign

### Step 1: Prepare Your Contact List

Create a CSV file with your contacts. Required column:

| Column         | Required | Description                                    |
| -------------- | -------- | ---------------------------------------------- |
| `phone_number` | Yes      | Phone number (E.164 format, e.g. +33612345678) |
| `first_name`   | No       | Use in personalization                         |
| `*any column*` | No       | Available as context variables                 |

**Example CSV**:

```csv theme={null}
phone_number,first_name,appointment_date,doctor_name
+33612345678,Jean,15 janvier,Dr. Martin
+33698765432,Marie,16 janvier,Dr. Dupont
+33687654321,Pierre,17 janvier,Dr. Bernard
```

<Note>
  All columns become context variables in your workflow. Use `{{ first_name }}` to reference the first\_name column.
</Note>

### Step 2: Create the Campaign

1. Go to **Campaigns** from the main menu
2. Click **New Campaign**
3. Name your campaign
4. Select your voice agent (workflow)
5. Upload your CSV file
6. Review the contact preview

### Step 3: Configure Settings

| Setting              | Description                          |
| -------------------- | ------------------------------------ |
| **Start time**       | When to begin calling                |
| **Calling hours**    | Hours during which calls are made    |
| **Retry attempts**   | How many times to retry failed calls |
| **Concurrent calls** | Number of simultaneous calls         |

### Step 4: Launch

1. Review your campaign summary
2. Click **Launch Campaign**
3. Monitor progress in real-time

## Monitoring Campaigns

### Campaign Dashboard

Track your campaign's progress:

* **Total contacts**: Number of contacts in the list
* **Completed**: Successfully finished calls
* **In progress**: Currently active calls
* **Pending**: Waiting to be called
* **Failed**: Calls that couldn't connect

### Call Outcomes

Each call is categorized by outcome:

| Outcome       | Description                |
| ------------- | -------------------------- |
| **Completed** | Call finished successfully |
| **No answer** | Contact didn't pick up     |
| **Busy**      | Line was busy              |
| **Failed**    | Technical issue            |
| **Voicemail** | Reached voicemail          |

### Disposition Codes

Custom tags assigned during calls based on conversation outcome:

* **Interested** - Contact expressed interest
* **Not interested** - Contact declined
* **Call back** - Contact requested callback
* **Wrong number** - Invalid contact

<Note>
  Configure disposition codes in your workflow settings.
</Note>

## Campaign Best Practices

<CardGroup cols={2}>
  <Card title="Respect Calling Hours" icon="clock">
    Only call during appropriate business hours for your contacts' timezone
  </Card>

  <Card title="Test First" icon="flask">
    Run a small test batch (10-20 contacts) before launching full campaign
  </Card>

  <Card title="Personalize" icon="user">
    Use context variables to make calls feel personal, not robotic
  </Card>

  <Card title="Monitor Actively" icon="eye">
    Watch the first few calls to catch issues early
  </Card>
</CardGroup>

### Retry Strategy

Configure smart retries for better reach:

* **First retry**: 2 hours after initial attempt
* **Second retry**: Next business day
* **Max attempts**: 3 per contact

## Pausing and Canceling

### Pause a Campaign

1. Go to your active campaign
2. Click **Pause**
3. Pending calls are held, active calls complete normally

### Resume

1. Click **Resume** on a paused campaign
2. Calling continues from where it stopped

### Cancel

1. Click **Cancel** to stop permanently
2. Active calls complete, pending calls are abandoned

## Viewing Results

After your campaign completes:

1. Go to **Campaigns** → Select your campaign
2. View the summary:
   * Completion rate
   * Average call duration
   * Disposition breakdown
3. Download detailed results as CSV

## Accès API

<Note>
  L'accès programmatique aux campagnes est disponible sur demande. Contactez notre équipe pour obtenir vos identifiants API.
</Note>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Calls not going out">
    * Verify phone number format includes country code (+33...)
    * Check that your workflow is published
    * Ensure you have available minutes
  </Accordion>

  <Accordion title="Low answer rate">
    * Try different calling hours
    * Check caller ID settings
    * Review your contact list quality
  </Accordion>

  <Accordion title="Calls ending too quickly">
    * Review your workflow for issues
    * Check the greeting—is it too long?
    * Test with Looptalk first
  </Accordion>
</AccordionGroup>

## Next Steps

* [Create a voice agent for your campaign](/workflows/creating-workflows)
* [Learn about context variables](/workflows/context-variables)
* [Test your workflow with Looptalk](/features/looptalk)