Outreach

WhatsApp Campaigns

7 min readwhatsapp-campaigns

Broadcast personalised WhatsApp messages to a filtered list of leads — with delivery tracking, reply detection, and stop-on-reply logic.

WhatsApp Campaigns

WhatsApp Campaigns let you send a personalised message to many leads at once. Unlike email sequences (which are drip-based), a campaign fires a single message immediately and tracks per-contact delivery and read status.

> Requires: A linked WhatsApp account (QR-paired at /whatsapp) and at least 1 credit per recipient.

---

Creating a campaign
  1. Open WhatsApp → Campaigns (or navigate to /whatsapp/campaigns)
  2. Click New Campaign
  3. Fill in:
FieldDescription
NameInternal label — not shown to recipients
MessageYour message text. Supports {{lead.firstName}}, {{lead.businessName}}, {{lead.city}}, and any other lead field in double-braces
TargetChoose All leads, Leads from a specific job, or Leads with a specific tag
Stop on replyWhen enabled, if a contact replies the system marks them as replied and won't send further messages
  1. Click Save & Launch

The campaign enters a processing queue. A background worker sends one message at a time, respecting WhatsApp's rate limits, and updates the delivery status as messages are sent.

---

Personalisation variables

Any lead field can be used in the message body:

Hi {{lead.firstName}}, I noticed {{lead.businessName}} on Google Maps and wanted to reach out...

Available variables:

VariableExample value
{{lead.firstName}}Sarah
{{lead.businessName}}Bloom Florist
{{lead.city}}Manchester
{{lead.category}}Florist
{{lead.website}}bloomflorist.co.uk
{{lead.phone}}+447911123456

---

Targeting options
OptionDescription
All leadsEvery lead in your workspace with a phone number
From jobOnly leads from a specific search job (e.g. "Manchester plumbers 2026-05")
By tagOnly leads with a specific tag (e.g. "hot-lead")

Leads without a phone number are automatically skipped.

---

Delivery tracking

The campaign list view shows per-campaign counters:

StatusMeaning
QueuedNot yet sent
SentHanded off to WhatsApp
DeliveredWhatsApp confirmed delivery to the device
ReadContact opened the message (blue double-tick)
RepliedContact sent a reply
FailedWhatsApp rejected the message (invalid number, blocked, etc.)

---

Reply detection

When a campaign contact replies, FlowMaticX:

  1. Marks the send status as Replied
  2. If Stop on reply is enabled, removes them from further sends
  3. Creates or updates the conversation in your WhatsApp Inbox
  4. Advances the lead's pipeline stage to REPLIED

---

Credits

Each message sent costs 1 credit. Credits are reserved at launch time. If a message fails, the credit is refunded automatically. Check your balance at /account/billing.

---

Limits and best practices
  • Send in batches of ≤500 leads/day to stay well within WhatsApp's anti-spam thresholds
  • Always personalise the opening line — generic broadcast messages have higher block rates
  • Test with yourself first: add your own number as a test lead before launching to real contacts
  • Unlinked devices (phone offline) will hold messages in queue — reconnect your phone within 24 h
  • WhatsApp permits business-style messages to opted-in or consenting contacts. Ensure you have a lawful basis before sending.