Skip to main content
The Setup tab defines who makes the calls and how the dialer behaves. Everything on this tab autosaves as you edit — there is no Save button.

Create a Campaign

  1. Open Studio → Manage → Campaigns. If it isn’t in your sidebar, see Navigating Studio to add it with Customize sidebar or find it with Cmd/Ctrl+K.
  2. Click New Campaign. A campaign named “Untitled Campaign” is created and its detail page opens.
  3. Rename it with the pencil icon next to the title (Enter saves, Escape cancels). The pencil is shown while the campaign is in Draft, Stopped, Completed or Failed status.
  4. On the Setup tab, choose an AI agent and set Channel to Voice. The caller ID and dialing controls appear once a channel is chosen.
From the campaigns list you can also Duplicate or Delete a campaign, using the icons at the right of its row.
  • Duplicate (the copy icon) makes a new Draft named Copy of followed by the original name, and Studio confirms with “Campaign duplicated successfully”. The copy keeps the original’s AI agent, channel, schedule, dialing settings, custom fields and contacts. Every contact starts again as pending, with its attempts and retry timers cleared. You can duplicate a campaign in any status.
  • Delete (the trash icon) is offered for campaigns in Draft, Stopped, Completed or Failed status. A Launched, Running, Window Closed or Paused campaign has to be stopped first. Studio asks you to confirm in a Delete Campaign? dialog, and a deleted campaign can’t be brought back.
A campaign that still has an AI agent assigned can’t be deleted. Studio shows “Cannot delete this campaign — an agent is still assigned. Remove the agent assignment first.” Open the campaign, open the AI Agent field on the Setup tab and choose Clear assistant, then delete it from the list. A duplicate keeps the original’s agent, so the same applies to deleting a copy.

1 · AI Agent

Choose which agent handles each outbound call. Voice, guidelines, knowledge, and actions all follow that agent’s configuration — the campaign only controls dialing. Once the agent has been published, the campaign’s calls use its published version, so later edits reach them at your next Publish; until then they use its latest saved edits. See Publishing Your Agent. An agent that a campaign still uses can’t be deleted; see Delete an Agent.
If the agent references campaign variables (the contact-list fields you pick in the variable picker, such as {{Summer Outreach / First Name}}) and you remove the agent assignment, those variables stop resolving. The Studio warns you before removing an agent that is still referenced. See Custom Fields → Agent Variables.

2 · Channel

Choose how the campaign reaches contacts. For your account that is Voice. A new campaign starts with no channel chosen, so pick Voice here first. Until you do, the Caller ID and Controls sections below stay hidden and the launch checklist shows Campaign channel selected as not done. The channel is fixed once the campaign has launched. After that the field is read-only.

3 · Caller ID

A voice campaign calls from the phone numbers assigned to its AI agent that can place campaign calls, which are numbers bought in the Studio and BYO numbers on a Verified SIP trunk. It rotates across them least recently used first. Rotating numbers reduces per-number call volume and protects your numbers’ reputation. The Caller ID section is read-only. It shows the numbers the agent you picked above will call from:
  • With no agent selected, it reads “Select an AI agent above to see the numbers it will call from.”
  • When the agent has numbers that can place campaign calls, it lists them under “N numbers assigned to this agent:”. A BYO number that isn’t on a Verified SIP trunk is left off the list, so the count can be lower than the number of numbers the agent has on Manage → Phone Numbers.
  • When the agent has none, it warns “This agent has no phone numbers assigned. Assign one before launching, or the campaign won’t be able to dial.” If the agent’s only numbers are BYO numbers that aren’t on a Verified SIP trunk, it warns “This agent’s BYO numbers are not on a verified SIP trunk. Verify the trunk or assign another number before launching, or the campaign won’t be able to dial.” instead. The launch checklist keeps Launch disabled until the agent has a number that can place campaign calls.
To change the numbers a campaign calls from, change the agent’s numbers: on Build → AI Agents, open More actions on the agent’s row and choose Assign phone number (Assign another number if it already has some), or use Assign on Manage → Phone Numbers. See Numbers as campaign caller IDs.
  • A number answers for one agent at a time. Assigning a number to a campaign’s agent also moves that number’s inbound calls to the agent, and any number the agent already answers on is one of its campaign caller IDs too, unless it is a BYO number that isn’t on a Verified SIP trunk. A contact who calls back reaches the agent that called them.
  • Campaigns that share an agent share its numbers, and the same rotation.
  • Changes apply on the next dial. The agent’s numbers are read on every dial, so adding or removing one takes effect straight away, even during a run. Setup is locked while a run is active; the agent’s phone numbers are not.
  • If the agent is left with no usable number mid-run, dialing stops silently. The run stays active but places no calls, and nothing on screen says why. This includes an agent whose only numbers left are BYO numbers that aren’t on a Verified SIP trunk.
  • Numbers pending release for non-payment are skipped. If every number the agent has is in that state, the campaign can’t launch.
A BYO number can place campaign calls only through a Verified SIP trunk. That includes the existing number you set up with Forward an existing number during onboarding. A BYO number with no trunk, or on a Pending or Disabled one, is skipped by the dialer and left off the Caller ID list. If those are all the agent has, Launch stays disabled and the campaign can’t dial. Your provider sets up and verifies SIP trunks, so ask them to verify a trunk for the number (see Adding a Number You Already Own), or give campaigns an agent with a number bought in the Studio.
The campaign’s on-demand calls use this agent’s numbers and these dialing settings too. Unlike a CSV run, on-demand calling reads the dialing settings live, so editing them changes on-demand calls immediately. Changing the campaign’s agent hands on-demand calls to the new agent but doesn’t move them onto its numbers, though — see On-Demand Calls.

4 · Controls (dialing settings)

The Controls section sets how many calls go out at once and what happens when a dial doesn’t connect.

Max concurrent calls

Caps how many outbound calls the campaign places at once while active. Higher values finish the contact list faster but add telephony load and cost.

Retries

Busy and no-answer retries are counted as extra attempts after the first dial — with “Extra attempts after first busy” set to 2, a contact is dialed at most 3 times for busy outcomes. Each retry waits the delay you pick under Wait before each retry before the contact re-enters the queue. That list is fixed: 5, 10, 15, 30, 60, 120 or 240 minutes. Voicemail Retry later offers the same choices but counts attempts differently; see below.

Voicemail handling

When the AI agent detects an answering machine during the call, the campaign applies your On voicemail choice:
  • Retry later — hang up and schedule another attempt after the wait you choose (default 30 minutes). Voicemail keeps its own count, and unlike busy and no answer it includes the first voicemail: the value in Extra attempts after first voicemail is the total number of voicemails a contact can reach before it ends as Voicemail. With the default of 2, a contact who reaches voicemail is retried once. With 1 it isn’t retried, and with 5 it is retried up to four times.
  • Leave a message — the agent speaks your configured voicemail message in its own voice, then hangs up. A new campaign’s message starts as “Hi, we tried reaching you but weren’t able to connect. We’ll try reaching you again soon. Thank you for your time!”, which you can edit. It supports {{variables}} from your contact list, and is required while this mode is selected.
  • Do nothing — hang up silently and mark the contact’s outcome as Voicemail.
Voicemail detection is performed by the AI agent in real time from what it hears on the line — there is no carrier-side answering machine detection. A post-call transcript check also catches voicemails the agent missed, so the outcome and retry policy still apply.

DNC Request message

If a contact asks not to be called again, the agent speaks this message, ends the call with the disposition DNC Request, and the number is added to your internal Do-Not-Call list immediately. Leaving the field empty restores the built-in default: “Okay — I’ll take you off our call list. You won’t receive further calls.” Like the voicemail message, it supports {{variables}} from your contact list.

DNC scrubbing

DNC scrubbing is on for every voice campaign, so there is no switch for it. When you launch a run, the platform checks the contacts’ numbers against the Do-Not-Call registries, litigator lists and your internal DNC list, and each dial then uses that result. Of those results, only a match on your internal DNC list stops a dial. The Reassigned-Number check isn’t active at the moment. Scrubbing requires a SAN on your account and is billed per contact per run. Full details, pricing, and SAN setup are covered in Compliance & DNC. The Co-pilot can save the SAN for you if you give it the number.

Autosave

Setup and Schedule changes save automatically a moment after you stop editing — a “Setup saved” / “Schedule saved” toast confirms each sync. While a save is in flight the Launch button shows “Saving…” and stays disabled, so you can never launch stale settings.

Test Calls

Place a real phone call with the campaign’s agent before launching to anyone on your list. Because it is a real phone call, it reaches the agent’s published version once the agent has one, unlike Talk on the agent’s page, which uses your latest saved edits. If you’ve changed the agent since you published it, Publish first to hear the change. An agent that has never been published uses its latest saved edits. See Publishing Your Agent.
  1. Click Test Call in the campaign header (an agent must be assigned first).
  2. Fill in the Place Test Call dialog:
    • Phone number (E.164) — e.g. +14155550100
    • Zip Code and one field per configured custom field — sample contact data to test variable injection
  3. Optionally check Enforce dialing rules to run the campaign’s compliance checks before the call is placed: your consent details, plus DNC scrubbing. It doesn’t check the campaign’s calling hours. This reveals the consent fields: PEWC obtained, PEWC date (it appears once PEWC obtained is ticked), and Consent to voice calls (OK).
  4. Click Dial.
The dialog starts from the last test call placed for this campaign: the phone number, zip code, custom-field values and consent details are filled in again. Enforce dialing rules starts unchecked each time you open it. DNC scrubbing is on for your voice campaigns, so with Enforce dialing rules checked, Dial stays disabled until the consent details are complete. Hover Dial to see what’s missing:
  • PEWC obtained is ticked.
  • A PEWC date is entered, and it isn’t in the future.
  • Consent to voice calls (OK) is ticked. It’s ticked by default.
With the checks on, the call is also refused until a SAN is saved on your account. If the checks find the number on your internal Do-Not-Call list, no call is placed and Studio tells you why. The same happens if the check service can’t be reached. The checks follow the same rules as campaign dials; see Compliance & DNC. The test call comes from one of the agent’s numbers: the one next in its rotation. A test call doesn’t move the rotation along, so testing doesn’t change which number your contacts see next. A test call may also use a BYO number on a Pending SIP trunk, which campaign dials don’t. The agent needs at least one number that can place the call: without one, the call is refused with “This agent has no assigned phone numbers to call from — assign a number to the agent first.” If all of its numbers are pending release for non-payment, you see “No eligible caller numbers available — check the payment status of this agent’s assigned numbers.” If it holds a BYO number with no usable SIP trunk (none, or a Disabled one) and nothing else can place the call, you see “This agent’s BYO numbers have no usable SIP trunk — attach an enabled SIP trunk to the number first.” That message takes the place of the payment one when both apply. If the balance can’t cover the call and auto top-up can’t add funds, Studio refuses it with “Insufficient wallet balance to place a test call. Add funds or enable auto top-up to continue.” See Manage → Billing. A full-screen overlay shows the live call status (Placing call… → Ringing… → Connected), a timer, the live transcript, and an End test call button.
Test calls run the full conversation experience but never touch campaign state — no DNC marks, callbacks, or voicemail retries are recorded. When DNC scrubbing is enabled and dialing rules are enforced, each test call to a US or Canadian number is charged the compliance-check fee ($0.10 by default) once the checks have run, including when they find the number can’t be called and no call is placed. A number outside the US and Canada isn’t checked or charged, and nothing is charged if the check service can’t be reached.

Editing Rules

  • Setup, Schedule, and Contacts can be edited while the campaign is in Draft, Stopped, Completed, or Failed status.
  • While a run is active, Setup and Schedule show a notice (“Setup cannot be edited while the campaign is actively running.” and “Schedule cannot be edited while the campaign is actively running.”), and the Contacts tab hides its upload and edit controls without showing one. The agent’s phone numbers stay editable, and changes to them apply on the next dial (see Caller ID above).
  • Relaunching a stopped, completed or failed campaign creates a new run with the current settings.

Where to go next

Contact Lists

Upload contacts with consent fields and custom variables.

Scheduling

Set the timezone and weekly calling windows.