Skip to content

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.

  1. On Campaigns, click New campaign.

    Click New campaign.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
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.

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.

  1. To stop sending for a while, click Pause. Messages a phone already has still go out.

    Watch progress, or click Pause.
  2. Click Resume to continue. The pace restarts from that moment, without a burst.

    Resume, or cancel the campaign.
  3. 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.

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.

The report of a finished campaign.
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.
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.