> ## Documentation Index
> Fetch the complete documentation index at: https://graine.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Campaign Overview

> Manage and run voice calling campaigns at scale

## What are Campaigns?

Campaigns allow you to automate voice calls to a list of contacts using your configured agents. Perfect for outbound sales, reminders, surveys, and customer outreach.

## Key Features

<CardGroup cols={2}>
  <Card title="Bulk Calling" icon="phone-volume">
    Call hundreds or thousands of contacts automatically
  </Card>

  <Card title="Smart Scheduling" icon="calendar">
    Schedule calls by timezone and working hours
  </Card>

  <Card title="Auto Retry" icon="arrows-rotate">
    Automatically retry failed calls with configurable settings
  </Card>

  <Card title="Progress Tracking" icon="chart-line">
    Monitor campaign progress in real-time
  </Card>
</CardGroup>

## Campaign Workflow

<Steps>
  <Step title="Create Campaign">
    Configure name, agent, phone numbers, and schedule
  </Step>

  <Step title="Upload Contacts">Import your calling list via CSV</Step>

  <Step title="Start Campaign">Launch and monitor in real-time</Step>

  <Step title="Analyze Results">
    View call outcomes and export data
  </Step>
</Steps>

## Campaign Status

Campaigns progress through these states:

| Status        | Description                            |
| ------------- | -------------------------------------- |
| **Draft**     | Created but not started                |
| **Scheduled** | Waiting for start time                 |
| **Active**    | Currently making calls                 |
| **Paused**    | Temporarily stopped (can resume)       |
| **Completed** | All calls finished or end time reached |
| **Failed**    | Campaign encountered errors            |

## Campaign Settings

### Basic Information

* Campaign name
* Selected agent
* Phone numbers to use
* Schedule (start/end dates and times)

### Working Hours

* From hour (e.g., 9 AM)
* To hour (e.g., 6 PM)
* Timezone
* Days of week

### Retry Configuration

* Max retry count (default: 5)
* Cooldown between retries (default: 45 minutes)
* Retries only during working hours

## Use Cases

<AccordionGroup>
  <Accordion title="Outbound Sales">
    * Lead generation
    * Product demonstrations
    * Appointment setting
    * Follow-up calls
  </Accordion>

  <Accordion title="Customer Service">
    * Service reminders - Appointment confirmations - Follow-up surveys - Feedback
      collection
  </Accordion>

  <Accordion title="Surveys & Research">
    * Market research - Customer satisfaction surveys - Product feedback - Opinion
      polls
  </Accordion>

  <Accordion title="Reminders & Notifications">
    * Appointment reminders
    * Payment reminders
    * Event notifications
    * Subscription renewals
  </Accordion>
</AccordionGroup>

## Best Practices

<CardGroup cols={2}>
  <Card title="Start Small" icon="seedling">
    Test with 10-20 contacts before full campaign
  </Card>

  <Card title="Respect Hours" icon="clock">
    Honor timezones and working hours
  </Card>

  <Card title="Moderate Retries" icon="repeat">
    Use 3-5 retries with appropriate cooldowns
  </Card>

  <Card title="Test Agent" icon="flask">
    Thoroughly test your agent before launch
  </Card>
</CardGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Create Campaign" icon="plus" href="/campaigns/creating-campaigns">
    Step-by-step campaign creation guide
  </Card>

  <Card title="CSV Format" icon="file-csv" href="/campaigns/csv-format">
    Learn the correct format for contact lists
  </Card>
</CardGroup>