Campaigns
A campaign sends one message to many contacts: everyone in the groups and tags you pick, at a pace your phones can carry, outside each recipient’s quiet hours. Nothing is sent until you start it on the last step of the builder. Opted-out and blacklisted contacts are always left out, and a STOP reply takes effect while the campaign runs.
Build a campaign
Section titled “Build a campaign”-
On Campaigns, click New campaign.
Click New campaign. -
Audience. Enter a Campaign name, tick one or more Groups, and type any Tags (press Enter after each). The audience is the members of the groups plus everyone with at least one of the tags; a contact in several gets one message. Click Next.
Name the campaign and choose groups and tags. -
Message. Under Text from, choose Write it here to write the message with variables, or A template and pick one from Template. A template’s text is copied when the campaign starts. The phone on the right previews the message for a sample contact. Click Next.
Write the message or pick a template. -
Route & pacing. Under Phones, choose Automatic to spread messages over every online phone, A pool to use one pool with failover, or One phone to send everything from one SIM. Set Messages a minute, across all phones (1 to 6,000).
Choose the phones and the pace. -
Keep Quiet hours on to hold messages between From and Until in each recipient’s own time zone. Fallback time zone is used for numbers with no country. Turn on Start later and pick Start at to schedule the campaign. Click Save draft and review.
Set quiet hours and, if you want, a start time. -
Review. Before it goes out counts the real audience now: recipients (after opt-outs and the blacklist), segments, how long it will take, and how many recipients are inside quiet hours. Read any warning, then click Start sending to with the count, or Schedule for a scheduled campaign. To start later, click Keep as draft.
Check the estimate and start.
Warnings on the review step
Section titled “Warnings on the review step”| Warning | What it means |
|---|---|
| The phones can’t keep this pace with their cooldown | The duration is based on the slower pace the phones can carry. Add phones or lower the cooldown. |
| No contact in these groups and tags can receive it | Everyone is opted out, blacklisted or missing. Change the audience. |
| No usable phone on this route | Messages would fail until a phone on the route comes online. |
| Some recipients are always inside quiet hours | Narrow the quiet hours window. |
| Some numbers are in countries with several time zones | Quiet hours there cover all of the country’s zones. Set a time zone on those contacts to be exact. |
Follow a running campaign
Section titled “Follow a running campaign”Open a campaign from the list to see it live. The bar and the counters show sent, delivered, failed and skipped messages, the current rate and when it should finish. Recipients inside quiet hours wait in their own time zone.
-
To stop sending for a while, click Pause. Messages a phone already has still go out.
Watch progress, or click Pause. -
Click Resume to continue. The pace restarts from that moment, without a burst.
Resume, or cancel the campaign. -
To stop for good, click Cancel campaign, type the confirmation word and click Cancel campaign again. Recipients not reached yet are skipped. This cannot be undone.
Type the word to confirm.
A draft shows Edit and Delete instead. A scheduled campaign shows when it starts, and can be canceled before then.
Read the report
Section titled “Read the report”When a campaign completes or is canceled, How it went replaces the live panel. It shows how long the campaign took against its estimate, messages by phone and SIM, skipped recipients by reason (such as opted out or blacklisted) and failures by error.
Campaign states
Section titled “Campaign states”| State | Meaning |
|---|---|
| Draft | Saved, not started. You can edit or delete it. |
| Scheduled | Starts at the time you picked. |
| Running | Sending now. |
| Paused | No new recipients are taken until you resume. |
| Completed | Every recipient was sent to or skipped. |
| Canceled | Stopped for good. |
Permissions
Section titled “Permissions”| To | You need |
|---|---|
| See campaigns and reports | campaigns:read |
| Create, edit, pause, resume and cancel campaigns | campaigns:manage (Owner, Admin, Developer, Campaign manager) |
| Start a campaign | campaigns:manage and messages:send |
To run campaigns from your own code, see Run a campaign and the campaigns reference.