# Send WhatsApp Campaigns and Track Revenue in Robylon

Send an approved WhatsApp template to an audience segment, track delivery, reads and replies, and attribute Shopify orders and revenue to each campaign.

> Source: https://www.robylon.ai/docs/whatsapp/campaigns
> Section: Outbound

A campaign sends one approved WhatsApp template to many customers at once, for example an order update to everyone affected by a delay. Robylon tracks each campaign's delivery, reads, replies, cost and, with Shopify connected, the revenue it brought in.

Open campaigns from [**Outbound → Campaigns**](https://app.robylon.ai/apps/outbound/campaigns) in the left navigation. Audiences are under [**Outbound → Audiences**](https://app.robylon.ai/apps/outbound/audiences).

## The campaigns page

The top of the page totals all campaigns:

- **Revenue:** order value attributed to campaigns, and the number of attributed orders.
- **Cost:** what the messages cost.
- **ROI:** revenue divided by total cost.
- **Messages Sent:** with how many were delivered and read.

Below it, each campaign shows its **Start Date**, **Audience** size, **Revenue**, **Cost**, **ROI**, and **Sent**, **Delivered**, **Read** and **Replied**. Filter the list by **Channel** and **Status**.

A campaign has one of six statuses:

| Status | Meaning |
| --- | --- |
| **Scheduled** | Waiting for its scheduled start time. |
| **Sending** | Sending to its audience now. |
| **Retrying** | The first send has finished, and [Retry](https://www.robylon.ai/docs/whatsapp/send-retry) is still due to resend some messages WhatsApp rejected for the daily marketing limit. |
| **Completed** | Finished, with no retries left. |
| **Failed** | The campaign could not be sent. |
| **Cancelled** | Stopped before it finished. Pending retries are cancelled too. |

Campaigns with a Marketing template also show **Retry on** or **Retry off** next to the status.

## Send a campaign

<Steps>
  <Step title="Start a campaign">
    In [**Outbound → Campaigns**](https://app.robylon.ai/apps/outbound/campaigns), click **New Campaign**.
  </Step>
  <Step title="Set it up">
    Enter a **Campaign Name** and an optional **Description**. Choose the **Channel** (**WhatsApp**; Email is coming soon) and the WhatsApp number to send from in **Sending From**. Leave **Attribute Revenue To This Campaign** on to count orders it drives.
  </Step>
  <Step title="Select a template">
    Choose an approved template. Filter by category if you have many. If the template has a backup, it is used automatically when the main template is rated Red, paused or disabled. Backups are set on the template's page. See [Backup templates](https://www.robylon.ai/docs/whatsapp/backup-templates).
  </Step>
  <Step title="Select the audience">
    Choose **All marketing-opted customers** or one of your saved audience segments. **Who This Will Reach** shows how many will be sent the message after invalid numbers, duplicates and [suppressed numbers](https://www.robylon.ai/docs/whatsapp/suppression-list) are removed.
  </Step>
  <Step title="Map the variables">
    Under **Map Variables**, choose the audience field that holds the **Recipient Phone Number**, then map each template variable to a data field so every message is personalised. If the template has a backup, map the backup's variables too: map all of them, or leave them all empty. With the backup left empty, the campaign does not fall back to it.
  </Step>
  <Step title="Add UTM tracking (optional)">
    If the template has link buttons, turn on **UTM Tracking**. **UTM Source** and **UTM Medium** come from your WhatsApp outbound configuration and cannot be edited here. Enter a **UTM Campaign** name that is not already in use. The **Link Preview** shows the final link. UTM tags let you trace orders back to the campaign in your analytics.
  </Step>
  <Step title="Choose schedule and delivery">
    Under **Schedule & Delivery**, set **When To Send**: **Send Immediately** or **Schedule For Later** with a date and time. Set the **Sending Speed**: **Full Speed** sends as fast as your messaging tier allows, and **Gradual** limits sending to a **Rate Per Hour** (500, 1000, 2000 or 5000). Turn on **Sending Hours** to send only within set hours on each day of the week.
  </Step>
  <Step title="Set Retry (Marketing templates)">
    Under **Sending Hours**, **Retry If Template Marked As Spam** starts with the template's setting. Change it for this campaign only, or click **Reset to template**. See [Retry](https://www.robylon.ai/docs/whatsapp/send-retry).
  </Step>
  <Step title="Test the template">
    Use **Send A Test Message** to send the template to a phone number with example values.
  </Step>
  <Step title="Confirm and launch">
    Click **Launch**, or **Schedule** if you chose a later time. A confirmation shows how many contacts the campaign will reach and its main settings. Click **Launch to N contacts** or **Schedule campaign** to confirm, or **Go back** to change anything.
  </Step>
</Steps>

<Frame>
  <img src="/assets/docs/app-new-campaign.webp" alt="New Campaign form with campaign setup, channel, sending number and template selection" width="2160" height="1350" />
</Frame>

A campaign sent now starts sending within 2 minutes of confirming.

<Note>
WhatsApp limits how many customers you can message first each day. Check your number's **Messaging Limit** before a large send. See [Connect WhatsApp](https://www.robylon.ai/docs/whatsapp/connect#the-messaging-limit).
</Note>

## Campaign results

Open a campaign from [**Outbound → Campaigns**](https://app.robylon.ai/apps/outbound/campaigns) to see its **Delivery Funnel**, which counts contacts, not messages, through five stages: **Audience** → **Sent** → **Delivered** → **Read** → **Replied**. Each stage shows its share of the stage it is measured against: **Sent** of the audience, **Delivered** of sent, and **Read** and **Replied** of delivered.

Between the stages, four drop-offs show who did not move on. Hover over one to see its reasons.

| Drop-off | Under | Who it counts |
| --- | --- | --- |
| **Suppressed** | **Audience** | Numbers on the [suppression list](https://www.robylon.ai/docs/whatsapp/suppression-list), skipped before sending. |
| **Template unavailable** | **Audience** | Recipients held back because the template was paused or disabled with no usable backup. |
| **Failed** | **Sent** | Messages WhatsApp rejected, by failure reason. |
| **Retrying** | **Sent** | Messages rejected for the daily marketing limit (131049) that [Retry](https://www.robylon.ai/docs/whatsapp/send-retry) will resend, with the next attempt's date. |

When Retry is on, **Recovered by retry** under the funnel shows how many messages were delivered thanks to a retry.

To see individual recipients, click **View Recipients**. Filter by **Status** (**Sent**, **Delivered**, **Read**, **Failed**, **Retrying**, **Replied** or **Suppressed**) and by **Failure reason** (**Not on WhatsApp**, **Daily marketing limit**, **User blocked business** or **Template paused**).

## Build an audience

An audience, or segment, is a reusable list of customers to send campaigns to. Build it from a CSV upload of your contacts.

<Steps>
  <Step title="Start a segment">
    In [**Outbound → Audiences**](https://app.robylon.ai/apps/outbound/audiences), click **New Segment**.
  </Step>
  <Step title="Name it">
    Enter a **Name** and an optional **Description**.
  </Step>
  <Step title="Choose the source">
    Under **Audience Source**, the **Source type** is **CSV**. Upload a file of contacts; the form links to a sample CSV that shows the format. See [CSV audience file format](#csv-audience-file-format).
  </Step>
  <Step title="Save">
    Click **Save Segment**. It appears in the list with its source, number of contacts, the campaigns that used it, and when it was last matched.
  </Step>
</Steps>

<Note>
**External database** shows as **Coming Soon** and cannot be picked for a new audience. Audiences already built from a Shopify store keep that source.
</Note>

## CSV audience file format

- A `phone_number` column is required. Include the country code, for example `+919876543210`. Spaces, dashes and brackets are removed, and a `+` is added if missing.
- `name` and `email` columns are optional.
- Any other columns are kept, so you can use them to fill template variables in a campaign.

Rows with a phone number that is not valid are skipped. If no row is valid, the upload is rejected.

## Revenue attribution

Leave **Attribute Revenue To This Campaign** on in the campaign setup to credit Shopify orders to it, or turn it off to leave the campaign out of revenue reporting.

To set the lookback period and the engagement that counts, see [Revenue attribution](https://www.robylon.ai/docs/outbound/revenue-attribution).
