Draft Documentation

This guide is currently in development. Content may be incomplete or subject to change.

~15 minutes

Building AI Flows

Create multichannel campaigns using the visual flow builder. Learn to configure Voice and WhatsApp channels, upload datasets, and run automated outreach.

WhatsApp Voice

Understanding Flow Campaigns

A flow campaign combines a visual workflow (the "flow") with communication channels and a dataset of contacts. Campaigns can use multiple channels simultaneously for true multichannel outreach.

Draft

Building and configuring. Not yet ready to execute.

Active

Ready to run. Channels and datasets configured.

Completed

All executions finished. View results in reports.

Multichannel Support

WhatsApp

Send messages, templates, and wait for responses via WhatsApp Business API.

Voice

AI-powered voice calls with natural conversation, recording, and call transfers.

Creating a New Campaign

AI Flows dashboard with campaign list

Steps:

  1. Navigate to AI Flows from the sidebar
  2. Click "Create Campaign" button
  3. Enter a campaign name and description
  4. Set the start and end dates (optional)
  5. Click "Create" to save and open the campaign

New campaign creation form

Screenshot coming soon

Tip: Use descriptive names like "Q1 Customer Feedback - Voice" or "Appointment Reminders - WhatsApp" to easily identify campaigns later.

Building the Flow

The flow builder provides a visual canvas where you drag and connect steps to define your campaign logic.

Flow builder interface with sample steps

Available Step Types

WhatsApp Steps

SendMessage

Send a custom text message via WhatsApp

SendTemplate

Send a pre-approved WhatsApp template with variables

WaitForResponse

Wait for and capture customer's WhatsApp reply

Voice Steps

VoiceCall

Initiate an AI-powered outbound voice call

WaitInboundCall

Wait for an inbound call on assigned DID

VoiceTransfer

Transfer active call to agent or external number

Connecting Steps

  1. Drag a step from the palette onto the canvas
  2. Click the output port (circle) of one step
  3. Drag to the input port of the next step
  4. Configure each step by clicking on it

Configuring WhatsApp Channel

To use WhatsApp in your campaign, you need to assign a WhatsApp channel and configure your message templates.

Assigning the Channel:

  1. Open your campaign and go to the Channels tab
  2. Click "Add Channel"
  3. Select WhatsApp as the channel type
  4. Choose an available WhatsApp Business number
  5. Save the channel assignment

WhatsApp channel assignment panel

Screenshot coming soon

Configuring a SendMessage Step:

  • Channel: Select your assigned WhatsApp channel
  • Message: Write your message text
  • Variables: Use {{column_name}} to insert data from your dataset
WhatsApp SendMessage step configuration

Note: For sending the first message to a new contact, you must use a pre-approved SendTemplate step. Custom messages are only allowed in active conversation windows.

Configuring Voice Channel

Voice campaigns use AI-powered calls with natural language conversation capabilities. Configure your voice channel and customize the AI behavior.

Assigning the Channel:

  1. Open your campaign and go to the Channels tab
  2. Click "Add Channel"
  3. Select Voice as the channel type
  4. Choose an available DID (phone number)
  5. Save the channel assignment

Voice/DID channel assignment panel

Screenshot coming soon

Configuring a VoiceCall Step:

System Prompt

Instructions for the AI agent (e.g., "You are a friendly customer service rep...")

Voice Selection

Choose the AI voice: alloy, echo, fable, onyx, nova, or shimmer

Initial Greeting

The first message spoken when the call connects

Recording

Enable call recording for quality assurance and auditing

Max Duration

Maximum call length in seconds (prevents runaway calls)

VoiceCall step configuration panel

Uploading Your Dataset

The dataset contains your contact list and any data you want to use in your messages or as context for AI conversations.

Required: Your dataset must include a phone number column. This is used to reach contacts via WhatsApp or Voice.

Steps:

  1. Go to the Datasets tab in your campaign
  2. Click "Upload Dataset"
  3. Select a CSV file from your computer
  4. Map the Phone Number column (required)
  5. Optionally map identifier, name, and email columns
  6. Set the default country code if phone numbers don't include it
  7. Click "Process" to upload
Dataset upload interface with schema configuration

CSV Format Example:

phone,name,company,appointment_date
+56912345678,Juan Garcia,Acme Corp,2024-03-15
+56987654321,Maria Lopez,Tech Inc,2024-03-16

Running the Campaign

Once your flow, channels, and dataset are configured, you can execute the campaign.

Pre-Execution Checklist:

  • Flow has all required steps configured
  • At least one channel is assigned
  • Dataset is uploaded and processed
  • Campaign status is "Active"

To Execute:

  1. Go to the Execution tab
  2. Select the dataset to process
  3. Review execution settings (batch size, delays)
  4. Click "Start Execution"
  5. Monitor progress in real-time
Campaign execution monitoring view

Important: You can pause or stop execution at any time. Rows that haven't been processed yet will remain in queue.

Viewing Reports

After execution, access detailed reports to analyze campaign performance by channel.

WhatsApp Metrics

  • Messages sent / delivered / read
  • Response rate
  • Template performance
  • Conversation outcomes

Voice Metrics

  • Calls completed / failed
  • Average call duration
  • Transfer rate
  • Outcome classification

Campaign report dashboard with metrics

Screenshot coming soon

Deep Dive Guides

Explore detailed documentation for each aspect of AI Flows: