# Campaign Messenger User Guide

Use this guide to prepare your contacts, set your campaign message and image, test delivery, and send messages from your Mac.

Mac only Uses Messages One contact at a time Updated June 11, 2026

## Before You Start

Campaign Messenger is a Mac app for sending campaign messages through the Messages app on your computer. You will need your contact list, your message text, and the campaign image you want to send.

Start with a test message. Use an approved test contact first. After you confirm the message and image look right, continue with the contacts who should receive the campaign message.

## 1. Your App Folder

Keep everything you receive in one folder. Do not move the app away from the other files in the folder.

Item | What It Is For
--- | ---
`CampaignMessenger.app` | The app you should open first.
`CampaignMessenger.command` | A backup way to open the app if the regular app does not open.
`contacts.csv` | Your campaign contact list.
Other included files | Support files the app needs. Leave them in the folder.

Keep the folder together. If you want to move Campaign Messenger, move the whole folder, not just the app.

## 2. Prepare Contacts

Your contact list should be a CSV file. The recommended column names are:

    first_name,last_name,phone_number
    Alex,Rivera,843-555-0101
    Jordan,Lee,843-555-0102
    Taylor,Smith,843-555-0103

- Use one person per row.
- Keep the header row at the top.
- Use mobile phone numbers only.
- Remove blank rows and anyone who should not receive the message.
- Save the file as `contacts.csv`.

You can also import contacts inside the app. Use the Import Contacts area, choose your CSV file, then confirm the contacts load correctly before sending.

## 3. Open The App

1

### Open Campaign Messenger

Double-click `CampaignMessenger.app`. It may take a few seconds for the window to appear.

2

### Use the backup launcher if needed

If the app does not open, double-click `CampaignMessenger.command`. A Terminal window will open. Keep that Terminal window open while using Campaign Messenger.

If macOS blocks the app: In System Settings, open Privacy & Security and look for a message about Campaign Messenger. Choose to allow the app if you trust the copy you received.

## 4. Set Message And Image

1. Open Edit Message & Image.
2. Type or paste your campaign message.
3. Click Choose Image....
4. Select the campaign image from your Mac.
5. Check that the preview shows the correct image.
6. Click Save.

Review before sending. Check spelling, names, dates, phone numbers, and the image before your test send.
Suggested screenshot: the Edit Message & Image area with a sample message, the selected image preview, and the Save button visible.

## 5. Allow Mac Permission

Your Mac may ask for permission so Campaign Messenger can work with Messages. This is needed for image sending.

1

### Open Accessibility settings

Go to System Settings > Privacy & Security > Accessibility.

2

### Add Campaign Messenger

Add `CampaignMessenger.app` from the folder you received and turn it on in the Accessibility list.

3

### Restart the app

Quit Campaign Messenger completely, then open it again before sending a test.

Suggested screenshot: System Settings showing Campaign Messenger turned on in Privacy & Security > Accessibility.

## 6. Send A Test

Before sending to the full list, send one test message to yourself or another approved test recipient.

- Messages is signed into the correct Apple ID on this Mac.
- The test recipient is in your contact list.
- The message text is correct.
- The campaign image preview is correct.
- Campaign Messenger is allowed in Accessibility settings.
- You are ready for the test recipient to receive a real message.

Stop after the test. Confirm the image and message both arrived correctly before sending to anyone else.

## 7. Send The Campaign

1. Use the filters to review Pending, Sent, Skipped, Invited, and Not Invited contacts.
2. Click Send only for the contact you want to message next.
3. Wait for the send to finish before clicking another contact.
4. Use Skip for anyone who should not receive the campaign message.
5. Use Undo only when you need to correct a status in the dashboard.

Do not rush. Campaign Messenger is designed for controlled one-at-a-time sending. Give each send time to complete before moving to the next contact.

## 8. Fix Common Issues

Problem | What To Try
--- | ---
The app takes a while to open. | Wait 10 seconds. If nothing opens, quit it and try again.
The app says `contacts.csv` is missing. | Put `contacts.csv` in the same folder as `CampaignMessenger.app`, then reopen the app.
Contacts do not look right. | Check the CSV columns. Use `first_name`, `last_name`, and `phone_number`.
The image does not send. | Turn on Campaign Messenger in Accessibility settings, quit the app, reopen it, and send one test again.
The message sends without the image. | Open Edit Message & Image, choose the image again, click Save, then send one test.
Old contacts show as Invited. | Use the Clear Invited History option before starting the new campaign, then review the list again.
The backup launcher opens Terminal. | That is expected. Keep the Terminal window open while using Campaign Messenger.

## Before Each New Campaign

- Use the current campaign contact list only.
- Remove contacts from old campaigns.
- Clear old invited history unless you are intentionally reusing it.
- Replace old campaign message text.
- Choose the current campaign image.
- Send one new test before starting the full list.