> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tedro.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Broadcasts and Campaigns

> Create, schedule, and track outbound message campaigns to contact groups in Tedro.

# Broadcasts and Campaigns

Broadcasts let you send outbound messages to groups of contacts at once. Use them for promotions, announcements, appointment reminders, or re-engagement campaigns. You can target specific contact groups, schedule sends for optimal timing, and track delivery and response analytics.

## Prerequisites

* A Tedro workspace with **Admin** role
* At least one connected channel
* Contacts organized into groups or tagged for targeting (see [Contacts and Groups](/platform/contacts-groups))
* For WhatsApp broadcasts: approved message templates (see [WhatsApp Templates](/outbound/whatsapp-templates))

## Create a Broadcast

<Steps>
  ### Open the Broadcasts Page

  Navigate to **Outbound > Broadcasts** in the sidebar. Click **Create Broadcast**.

  ### Configure the Campaign

  Enter a **name** for the broadcast (for internal tracking). Select the **channel** you want to send through.

  ### Select Your Audience

  Choose the target audience for the broadcast:

  * **Contact group** -- Send to all contacts in a specific group
  * **Tag filter** -- Send to contacts matching specific tags
  * **All contacts** -- Send to every contact on the selected channel

  <Note>
    Only contacts who have not opted out will receive the broadcast. Tedro automatically excludes contacts with `opted_out = true`.
  </Note>

  ### Compose Your Message

  For **WhatsApp** broadcasts, select an approved template from your template library. Fill in any dynamic parameter values.

  For **other channels** (Instagram, Messenger, Live Chat), compose your message directly in the editor.

  <Warning>
    WhatsApp broadcasts **require** an approved template. You cannot send free-form messages as broadcasts on WhatsApp -- this is enforced by Meta's policy. See [WhatsApp Templates](/outbound/whatsapp-templates) for details.
  </Warning>

  ### Schedule or Send

  Choose when to send:

  * **Send now** -- The broadcast begins delivering immediately
  * **Schedule** -- Pick a date and time for the broadcast to go out. Useful for time-zone-aware campaigns.

  ### Review and Confirm

  Review the audience count, message preview, and schedule. Click **Send** or **Schedule** to launch the broadcast.
</Steps>

## Broadcast Analytics

After a broadcast is sent, the campaign detail page shows delivery performance:

| Metric        | Description                                                            |
| ------------- | ---------------------------------------------------------------------- |
| **Sent**      | Total messages dispatched                                              |
| **Delivered** | Messages confirmed delivered to the recipient's device                 |
| **Read**      | Messages the recipient opened (WhatsApp read receipts)                 |
| **Failed**    | Messages that could not be delivered (invalid number, opted out, etc.) |
| **Replies**   | Contacts who replied to the broadcast message                          |

<Tip>
  Use the **Broadcast Reply** trigger node in your workflows to automatically handle responses to specific campaigns. See the [Trigger Nodes](/nodes/trigger-nodes) reference for details on `trigger.broadcast_reply`.
</Tip>

## Best Practices

* **Segment your audience** with tags and groups before broadcasting. Targeted messages get higher engagement than blanket sends.
* **Test first** by sending to a small test group before launching to your full audience.
* **Schedule for business hours** in your audience's time zone for better open rates.
* **Monitor opt-outs** after each campaign. A spike in opt-outs signals your messaging frequency or content needs adjustment.

## What's Next

<CardGroup cols={2}>
  <Card title="WhatsApp Templates" icon="file-text" href="/outbound/whatsapp-templates">
    Create and manage pre-approved templates required for WhatsApp broadcasts.
  </Card>

  <Card title="Contacts and Groups" icon="users" href="/platform/contacts-groups">
    Organize contacts into groups for targeted broadcast campaigns.
  </Card>
</CardGroup>
