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

# Workflows and Campaigns

> Create automated communication sequences with Bolna workflows and campaigns. Build multi-step outreach flows with calls, WhatsApp, and email automation.

<Note>
  Access the Campaigns at [https://platform.bolna.ai/campaigns](https://platform.bolna.ai/campaigns)
</Note>

## Overview

Create automated communication sequences with phone calls, WhatsApp messages, and email notifications. Chain workflows with conditional logic to build complex multi-step campaigns.

<Frame caption="Bolna Workflows and Campaigns Dashboard">
  <img src="https://mintcdn.com/bolna-54a2d4fe/7Qe-eVdYEohMijPY/images/workflows_campaigns/workflows.png?fit=max&auto=format&n=7Qe-eVdYEohMijPY&q=85&s=597fbb83add6a035afd7e75c533880f5" alt="Bolna workflows and campaigns dashboard showing list of created workflows" width="2814" height="1490" data-path="images/workflows_campaigns/workflows.png" />
</Frame>

### Key Concepts

<CardGroup cols={2}>
  <Card title="Workflows" icon="diagram-project">
    Reusable templates of multi-step communications (calls, WhatsApp, emails) including delays between steps
  </Card>

  <Card title="Campaigns" icon="rocket">
    Deployments that execute workflows with specific contact data and timing
  </Card>

  <Card title="Steps" icon="list-check">
    Individual actions within a workflow (call, WhatsApp, email, retry)
  </Card>

  <Card title="Criteria" icon="code-branch">
    Conditions that determine workflow transitions and campaign flow
  </Card>
</CardGroup>

***

## Workflows

### What are Workflows?

Reusable sequences of communication steps that define the type, timing, and order of actions across multiple campaigns.

<Frame caption="Workflow Builder Interface">
  <img src="https://mintcdn.com/bolna-54a2d4fe/7Qe-eVdYEohMijPY/images/workflows_campaigns/workflows.png?fit=max&auto=format&n=7Qe-eVdYEohMijPY&q=85&s=597fbb83add6a035afd7e75c533880f5" alt="Bolna workflow builder interface for creating multi-step communication sequences" width="2814" height="1490" data-path="images/workflows_campaigns/workflows.png" />
</Frame>

### Workflow Step Types

<CardGroup cols={3}>
  <Card title="Call Steps" icon="phone">
    **Purpose**: Initiate outbound phone calls to contacts

    **Features**: AI-powered conversations, voicemail detection, call timeout settings

    **Timing**: Configurable delay from previous step
  </Card>

  <Card title="WhatsApp Steps" icon="whatsapp" iconType="brands">
    **Purpose**: Send WhatsApp messages to contacts

    **Features**: Pre-notification before calls, interactive buttons and CTAs

    **Prerequisite**: Ai Sensy API key must be connected
  </Card>

  <Card title="Email Steps" icon="envelope">
    **Purpose**: Send email notifications and follow-ups

    **Features**: Template-based emails, scheduling information

    **Timing**: Configurable delay from previous step
  </Card>
</CardGroup>

***

### Creating Workflows

<Steps>
  <Step title="Access Workflow Builder">
    1. Navigate to the **Workflows** section in your dashboard
    2. Click **"Add New Workflow"** or select an existing workflow to edit
    3. The visual workflow builder opens with drag-and-drop functionality

    <Frame caption="Accessing the Workflow Builder">
      <img src="https://mintcdn.com/bolna-54a2d4fe/7Qe-eVdYEohMijPY/images/workflows_campaigns/create_new_workflow.png?fit=max&auto=format&n=7Qe-eVdYEohMijPY&q=85&s=7ad1554890428743eb095e64916d59d3" alt="Add new workflow button in Bolna dashboard" width="994" height="1548" data-path="images/workflows_campaigns/create_new_workflow.png" />
    </Frame>
  </Step>

  <Step title="Add Steps">
    1. **Add Steps**: Click the **"Add Step"** button to insert new communication steps
    2. **Step Types**: Choose from Call, WhatsApp, or Email

    <Frame caption="Adding Steps to Workflow">
      <img src="https://mintcdn.com/bolna-54a2d4fe/7Qe-eVdYEohMijPY/images/workflows_campaigns/add_workflow_steps.png?fit=max&auto=format&n=7Qe-eVdYEohMijPY&q=85&s=d85523cbb853f686a23ff32376a14099" alt="Adding call WhatsApp and email steps to workflow" width="2816" height="1472" data-path="images/workflows_campaigns/add_workflow_steps.png" />
    </Frame>

    **Adding WhatsApp Steps:**

    1. Click the **"+ Add Step"** button in the workflow builder
    2. Select **"WhatsApp"** from the dropdown menu
    3. The WhatsApp step will appear in your workflow canvas

    <Frame caption="Adding WhatsApp Step to Workflow">
      <img src="https://mintcdn.com/bolna-54a2d4fe/FTAkjADWhOFQdtXY/images/workflows_campaigns/add_whatsapp_step_in_workflows.png?fit=max&auto=format&n=FTAkjADWhOFQdtXY&q=85&s=61ec5af1c16d0de199d8f70007ceaaa5" alt="WhatsApp step added to workflow canvas" width="2896" height="1374" data-path="images/workflows_campaigns/add_whatsapp_step_in_workflows.png" />
    </Frame>
  </Step>

  <Step title="Configure Steps">
    * **Step Label**: Give each step a descriptive name
    * **Timing**: Set delay in minutes from previous step
    * **Step Configuration**: Configure specific settings for each step type

    <Frame caption="Editing Workflow Steps">
      <img src="https://mintcdn.com/bolna-54a2d4fe/7Qe-eVdYEohMijPY/images/workflows_campaigns/configure_workflow_steps.png?fit=max&auto=format&n=7Qe-eVdYEohMijPY&q=85&s=3f841f721b2bfe9f10c1e1775b5c6fda" alt="Workflow step configuration panel with timing and label options" width="2936" height="1532" data-path="images/workflows_campaigns/configure_workflow_steps.png" />
    </Frame>
  </Step>

  <Step title="Save Workflow">
    Click **"Save Workflow"** to persist your changes
  </Step>
</Steps>

***

### Configuring WhatsApp Steps

<Warning>
  Before adding WhatsApp steps to your workflow, you must first connect your Ai Sensy API key.
</Warning>

**Connect Ai Sensy API Key:**

**Providers** → Search **"Ai Sensy"** → **Connect** → Enter API Key → **Save**

<Frame caption="Connecting Ai Sensy API Key">
  <img src="https://mintcdn.com/bolna-54a2d4fe/FTAkjADWhOFQdtXY/images/workflows_campaigns/add_aisensy_api_key_in_bolna.png?fit=max&auto=format&n=FTAkjADWhOFQdtXY&q=85&s=6572481e3872a8fe6f4e569747302729" alt="Connecting Ai Sensy API key in Bolna providers section" width="2898" height="1246" data-path="images/workflows_campaigns/add_aisensy_api_key_in_bolna.png" />
</Frame>

1. Click on the **WhatsApp step** to open configuration
2. **Template Name**: Your Ai Sensy template (e.g., `welcome_message`)
3. **Parameter Keys**: CSV column names for template parameters (click **"+"** to add multiple)
4. Click **"Save"**

<Frame caption="Configuring WhatsApp Step">
  <img src="https://mintcdn.com/bolna-54a2d4fe/FTAkjADWhOFQdtXY/images/workflows_campaigns/configure_whatsapp_step.png?fit=max&auto=format&n=FTAkjADWhOFQdtXY&q=85&s=c872d479f68567748d6f7233581bf317" alt="WhatsApp step configuration with template name and parameter keys" width="694" height="800" data-path="images/workflows_campaigns/configure_whatsapp_step.png" />
</Frame>

<Tip>
  Parameter keys must match CSV headers exactly. Template name must match your approved Ai Sensy template.
</Tip>

***

### Workflow Examples

<AccordionGroup>
  <Accordion title="Basic Call Workflow">
    ```
    Step 1: Call (0 min delay)
    ```

    Simple single-step workflow for immediate outbound calling.
  </Accordion>

  <Accordion title="Advanced Multi-Step Workflow">
    ```
    Step 1: WhatsApp (0 min delay)
    Step 2: Call (30 min delay)
    Step 3: Email (60 min delay)
    ```

    WhatsApp notification first, call after 30 minutes, then email follow-up.
  </Accordion>
</AccordionGroup>

<Frame caption="Example Workflow Flows">
  <img src="https://mintcdn.com/bolna-54a2d4fe/7Qe-eVdYEohMijPY/images/workflows_campaigns/workflows.png?fit=max&auto=format&n=7Qe-eVdYEohMijPY&q=85&s=597fbb83add6a035afd7e75c533880f5" alt="Example multi-step workflow with WhatsApp call and email steps" width="2814" height="1490" data-path="images/workflows_campaigns/workflows.png" />
</Frame>

***

## Campaigns

### What are Campaigns?

Execute workflows with specific contact data, agents, and schedules. Can be single workflow or multi-workflow with conditional logic.

<Frame caption="Campaign Dashboard">
  <img src="https://mintcdn.com/bolna-54a2d4fe/7Qe-eVdYEohMijPY/images/workflows_campaigns/view_all_campaigns.png?fit=max&auto=format&n=7Qe-eVdYEohMijPY&q=85&s=2066919de10f693950216eaeeddacc35" alt="Bolna campaigns dashboard with campaign list and status" width="2934" height="1532" data-path="images/workflows_campaigns/view_all_campaigns.png" />
</Frame>

### Campaign Types

<Tabs>
  <Tab title="Single Workflow">
    * Execute one workflow across all selected contacts
    * Simple setup and execution
    * Perfect for basic outreach and follow-up sequences

    <Frame caption="Single Workflow Campaign Setup">
      <img src="https://mintcdn.com/bolna-54a2d4fe/7Qe-eVdYEohMijPY/images/workflows_campaigns/campaign_setup.png?fit=max&auto=format&n=7Qe-eVdYEohMijPY&q=85&s=3a6cfb20b9dbed4fbb8c082f0d988912" alt="Single workflow campaign setup with workflow and agent selection" width="2932" height="1462" data-path="images/workflows_campaigns/campaign_setup.png" />
    </Frame>
  </Tab>

  <Tab title="Multi-Workflow">
    * Chain multiple workflows using conditional criteria
    * Advanced conditional logic based on call outcomes
    * Perfect for complex sales processes and lead nurturing

    <Frame caption="Multi-Workflow Campaign Setup">
      <img src="https://mintcdn.com/bolna-54a2d4fe/7Qe-eVdYEohMijPY/images/workflows_campaigns/configure_workflows_criterias.png?fit=max&auto=format&n=7Qe-eVdYEohMijPY&q=85&s=dbbc9200b16149bac54700575346169c" alt="Multi-workflow campaign configuration with conditional criteria" width="2938" height="1568" data-path="images/workflows_campaigns/configure_workflows_criterias.png" />
    </Frame>
  </Tab>
</Tabs>

***

### Creating Campaigns

<Steps>
  <Step title="Campaign Details">
    1. **Campaign Name**: Choose a descriptive name for your campaign
    2. **Description**: Optional description of the campaign purpose
    3. **CSV File**: Upload contact data in CSV format
       * **Required Fields**: Name, phone\_number (in E.164 format)
       * **Optional Fields**: Any variables used in the agent

    <Frame caption="Campaign Details Configuration">
      <img src="https://mintcdn.com/bolna-54a2d4fe/7Qe-eVdYEohMijPY/images/workflows_campaigns/create_campaign.png?fit=max&auto=format&n=7Qe-eVdYEohMijPY&q=85&s=33f45cb4755d4c0a8bdf036205f4a652" alt="Campaign creation form with name description and CSV upload" width="2936" height="1460" data-path="images/workflows_campaigns/create_campaign.png" />
    </Frame>
  </Step>

  <Step title="Workflow & Agent Selection">
    1. **Select Workflow**: Choose from your available workflows
    2. **Select Agent**: Choose the AI assistant for communication
    3. **Phone Number**: Optional caller ID for outbound calls
    4. **Add Multiple Workflows**: For complex campaigns with multiple workflow pairs

    <Frame caption="Workflow and Agent Selection">
      <img src="https://mintcdn.com/bolna-54a2d4fe/7Qe-eVdYEohMijPY/images/workflows_campaigns/campaign_setup.png?fit=max&auto=format&n=7Qe-eVdYEohMijPY&q=85&s=3a6cfb20b9dbed4fbb8c082f0d988912" alt="Workflow selection and AI agent assignment for campaign" width="2932" height="1462" data-path="images/workflows_campaigns/campaign_setup.png" />
    </Frame>
  </Step>

  <Step title="Advanced Configuration (Multi-Workflow)">
    1. **Add Workflow Pairs**: Workflow + Agent combinations
    2. **Set Criteria**: Conditions for workflow transitions
    3. **Configure Timing**: When to start next workflow
    4. **Test Configuration**: Validate setup before launch

    <Frame caption="Multi-Workflow Configuration">
      <img src="https://mintcdn.com/bolna-54a2d4fe/7Qe-eVdYEohMijPY/images/workflows_campaigns/configure_workflows_criterias.png?fit=max&auto=format&n=7Qe-eVdYEohMijPY&q=85&s=dbbc9200b16149bac54700575346169c" alt="Advanced multi-workflow configuration with criteria conditions" width="2938" height="1568" data-path="images/workflows_campaigns/configure_workflows_criterias.png" />
    </Frame>
  </Step>

  <Step title="Review & Launch">
    1. **Review Summary**: Check all settings and configurations
    2. **Validate Data**: Ensure contact data is correct and complete
    3. **Launch Campaign**: Start execution and monitor progress

    <Frame caption="Campaign Review and Launch">
      <img src="https://mintcdn.com/bolna-54a2d4fe/7Qe-eVdYEohMijPY/images/workflows_campaigns/review_and_start_campaign.png?fit=max&auto=format&n=7Qe-eVdYEohMijPY&q=85&s=9dd7a55378d64253925b9c555e7495cb" alt="Campaign review and launch page with start button" width="2226" height="1670" data-path="images/workflows_campaigns/review_and_start_campaign.png" />
    </Frame>
  </Step>
</Steps>

***

### Multi-Workflow Campaigns

For multi-workflow campaigns, you can create workflow-agent pairs with specific criteria:

<CardGroup cols={2}>
  <Card title="Basic Pair" icon="link">
    * **Workflow**: Select workflow
    * **Agent**: Choose AI assistant
    * **Phone Number**: The number agent calls from
  </Card>

  <Card title="Advanced Pair with Criteria" icon="code-branch">
    * **Workflow**: Select workflow
    * **Agent**: Choose AI assistant
    * **Phone Number**: The number agent calls from
    * **Criteria**: Conditions for transition
    * **Next Workflow Time**: When to start next workflow
  </Card>
</CardGroup>

<Frame caption="Workflow Pair Configuration">
  <img src="https://mintcdn.com/bolna-54a2d4fe/7Qe-eVdYEohMijPY/images/workflows_campaigns/campaign_setup.png?fit=max&auto=format&n=7Qe-eVdYEohMijPY&q=85&s=3a6cfb20b9dbed4fbb8c082f0d988912" alt="Workflow-agent pair configuration for campaign steps" width="2932" height="1462" data-path="images/workflows_campaigns/campaign_setup.png" />
</Frame>

***

### Criteria and Conditions

| Condition Type | Operators            |
| -------------- | -------------------- |
| **Equality**   | `==`, `!=`           |
| **Comparison** | `>`, `<`, `>=`, `<=` |

| Logical Operator | Behavior                    |
| ---------------- | --------------------------- |
| **AND**          | All conditions must be true |
| **OR**           | Any condition can be true   |

<Frame caption="Criteria Configuration Interface">
  <img src="https://mintcdn.com/bolna-54a2d4fe/7Qe-eVdYEohMijPY/images/workflows_campaigns/configure_workflows_criterias.png?fit=max&auto=format&n=7Qe-eVdYEohMijPY&q=85&s=dbbc9200b16149bac54700575346169c" alt="Criteria builder with comparison and logical operators" width="2938" height="1568" data-path="images/workflows_campaigns/configure_workflows_criterias.png" />
</Frame>

***

## CSV Data Format

### Required Format

All phone numbers should include the country prefix in [E.164](https://en.wikipedia.org/wiki/E.164) format and use `contact_number` as the header.

```csv example_batch_file.csv theme={"system"}
contact_number,first_name,last_name,email
+91931237890,Bruce,Wayne,bruce@example.com
+91912345678,Bruce,Lee,bruce.lee@example.com
+91921000000,Satoshi,Nakamoto,satoshi@example.com
+44999999007,James,Bond,james@example.com
```

<Frame caption="CSV Data Format Example">
  <img src="https://mintcdn.com/bolna-54a2d4fe/7Qe-eVdYEohMijPY/images/workflows_campaigns/create_campaign.png?fit=max&auto=format&n=7Qe-eVdYEohMijPY&q=85&s=33f45cb4755d4c0a8bdf036205f4a652" alt="CSV data format example with contact numbers in E.164 format" width="2936" height="1460" data-path="images/workflows_campaigns/create_campaign.png" />
</Frame>

### Callback Matching

When contacts call back, Bolna matches their phone number to the CSV row for personalized conversations.

**Example:** Agent can say: *"Hi John, I see you're calling about the product you showed interest in at Acme Corp."*

### Excel/Google Sheets Tips

<Tip>
  In Excel, add an apostrophe before `+` (e.g., `'+91931237890`) to prevent formula interpretation.
</Tip>

***

<Note>
  Campaign system is in beta. Phone call workflows are fully functional. WhatsApp and email coming soon.
</Note>

<Card title="Get Started" icon="play" href="https://platform.bolna.ai/campaigns">
  Create your first workflow and campaign
</Card>
