Skip to content

Launch a Campaign ​

Campaigns let you launch automated calls to a list of contacts, with advanced scheduling and retry rules.

WARNING

Campaigns require an active subscription. Check your plan in Settings → Subscription.

Access campaigns ​

From the dashboard, click Campaigns in the sidebar. Here you'll see the list of existing campaigns with their status:

StatusMeaning
DraftNot yet started
ScheduledScheduled for a future date
RunningCurrently executing
PausedPaused
CompletedFinished
CancelledCancelled

Create a campaign ​

Campaign creation follows a guided 5-step process.

Step 1: Agent and source number ​

  1. Click Create campaign.
  2. Select the AI agent that will handle the calls.
  3. Select the source phone number the calls will originate from.

Step 2: Number list ​

Enter the numbers to call in one of two ways:

  • Manual entry — Add numbers one by one in the table, filling in any additional variables for each contact.
  • CSV upload — Upload a CSV file with numbers and variables. The table will be populated automatically.

TIP

If the agent uses dynamic variables in the prompt (e.g. ), you can add corresponding columns in the table to personalize each call.

Alternate numbers per contact (optional) ​

When a contact has more than one person or number to try (for example a manager and an assistant at the same company), you can add alternate numbers for that row:

  • In the table UI, enable alternate numbers and add one or more extra phone numbers (and optional variables) per contact.
  • In a CSV, use column suffixes _2, _3, … for attempt 2, 3, etc. For example: phone_number, name, phone_number_2, name_2.

On retries, the worker picks the destination number for that dial attempt from the primary number (attempt 1) or from the alternates (attempt 2+). Choose an alternate number strategy in Advanced rules when you have fewer alternates than total dial attempts (1 + max retries):

StrategyBehavior
RollingCycles through the defined alternates
ClampUses each alternate in order, then keeps using the last one
CustomUses each alternate once, then falls back to the primary number

Step 3: Variable mapping ​

If you've added extra columns in the table or CSV, map each column to the correct agent variable:

  • Select the target variable for each column
  • Available variables are automatically extracted from the agent's prompt

Step 4: Advanced rules ​

Configure the campaign's behavior:

ParameterDescriptionDefault
Campaign nameIdentifying name—
DescriptionOptional description—
Max retriesHow many times to retry a failed call0
Retry delayMinutes to wait between retries—
Calling daysDays of the week to make callsMon–Fri
Calling windowStart and end time for calls09:00–19:00
TimezoneReference timezone—
Concurrent callsMaximum number of parallel calls—
Free slots for inboundReserve capacity for incoming calls—

When max retries is greater than zero, two more options appear:

Caller ID per dial attempt ​

Use different outbound numbers for each dial attempt (initial call plus each retry). Add one or more numbers and choose a rotation strategy:

StrategyBehavior
RollingCycles through your numbers (A, B, A, B…) when you have fewer numbers than attempts
ClampUses each number in order, then repeats the last number
CustomAssigns one specific number per attempt slot

The engine campaign tick resolves the caller ID for each dial attempt when placing outbound calls.

Alternate number strategy ​

Controls how contact alternate numbers (from step 2) are used when there are fewer alternates than total dial attempts. Same three strategies as in the table above (rolling, clamp, custom).

Step 5: Summary and confirmation ​

  1. Review the campaign summary: contact list, mapped variables, configured rules.
  2. Click Create campaign to save it.

The campaign will be created in Draft status. You can start it manually or schedule it.

Manage an active campaign ​

From the campaign list you can:

  • Start a draft campaign
  • Pause a running campaign
  • Resume a paused campaign
  • Cancel a campaign

Next step ​

To monitor the progress of your calls and campaigns, check the analytics guide.

Replicer API Documentation