Settings > Campaigns lets you write to a group of customers at once. Pick a segment, check the wording in the customer's language, send yourself a test, then send now or on a date. The report afterwards shows how many were sent, opened, clicked and booked.

Before you start #
- You need the owner or manager role.
- Set the public address under Settings > Business and the mail server under Settings > Mail. Campaign email goes through your own mail server, the same one that sends automatic customer messages. See "Customer messages".
- For text campaigns, switch on your own Twilio or Telnyx account under Settings > Connections. Dispatch never sends text on an account of its own. See "Connect Twilio" and "Connect Telnyx".
- Customers receive a campaign only after they agreed to marketing. See "Marketing consent: opt-ins and opt-outs".
The five segments #
| Segment | Who it picks | The number you set |
|---|---|---|
| Service due | Customers with an open service reminder due within the days you set | Days ahead (30 to start) |
| Declined work | Customers who declined a line on a repair order within the months you set | Months back (6 to start) |
| Win-back | Customers whose last job is older than the months you set, with nothing newer | Months since the last job (12 to start) |
| New customers | Customers added within the days you set | Days since they were added (30 to start) |
| Taxi account holders | Customers linked to an active taxi billing account | None |
Months count as 30 days.
Send a campaign #
- Open Settings > Campaigns. The Segments table shows how many customers each segment holds and how many can be reached by email and by text.
- Under "New campaign", type a name, pick the segment, choose email, text or both, and paste the link customers should open. It is usually your booking page. Select "Create campaign".
- Pick a language and read the wording. Each campaign starts with wording in English, Spanish, Punjabi, Gujarati, Hindi, Arabic, French, German, Portuguese (Brazil) and Italian. Change any of it and select "Save wording". Put
{business},{name}and{link}where the details go. - Select "Preview". The preview shows the message as the customer reads it, right to left for Arabic, and says how many customers it reaches and how many are left out and why.
- Type your own email address under "Send a test" and select "Send test". The copy is marked Test and stays out of the report.
- To send at once, leave "Send at" empty and select "Send now". To send later, pick a date and time and select "Schedule". Times are in your shop's time zone.
- Open the campaign from the list at any time to read its report.
Who is left out #
A customer is left out of a campaign when any of these holds:
- no marketing opt-in is on record, or an opt-out is newer than the opt-in (including opt-outs made with "Opt customers out of marketing");
- they used the stop link in an earlier message;
- their record is set to no contact;
- they have no usable email address or phone number for the channel.
The check runs when you send and again just before each message leaves, so an opt-out recorded after you pressed Send still holds. The stop link at the bottom of every campaign message ends marketing for that customer on that channel.
The report #
- Customers reached is how many messages were written for the segment.
- Sent counts messages the mail server or text service accepted.
- Opened counts messages whose tiny image loaded. It appears only when "Count opens with a tiny image in each email" was on when you sent. Many mail programs block images, so the count is a floor.
- Clicked counts customers who followed the link in the message.
- Booked counts customers who had a new job within 30 days after the message went out.
- Gave up and Not sent list messages that failed or were held back, for example because the customer opted out in the meantime.
Technical details
- A campaign writes one row per customer and channel into the same message outbox as automatic customer messages. Retries (1 minute, 5 minutes, 30 minutes, 2 hours, 12 hours), the circuit breaker per channel and the stop link are the ones described under "Customer messages". There is no second sender.
- The link in each message goes through your server at
/api/v1/marketing/c/<token>and forwards the customer to your link, so a click can be counted. The open image is/api/v1/marketing/o/<token>. - Each recipient has one random token. The report shows contacts masked.
- Campaign email carries a plain text part and a branded HTML part with your shop name, colors and logo. Email includes
List-Unsubscribeheaders for one-click opt-out and your shop postal address in the footer when it is on file. - A campaign cannot send when its subject or body would be empty for a language (for example a segment with no built-in wording and no saved template).
If something goes wrong #
- The message "Email needs the public address": add the public address under Settings > Business, the mail server under Settings > Mail, and keep the email connection on under Settings > Connections.
- The message "Text messages need Twilio or Telnyx": switch on one of them under Settings > Connections.
- "Add the link customers should open": paste a link, or take
{link}out of the wording. - Fewer customers than expected: Preview lists how many were left out for no contact details, no marketing opt-in, or a stop.
- A scheduled campaign shows Canceled with a note: the mail server or text service was switched off when its time came. Fix it and create the campaign again.