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

# Broadcasts

> Send announcements from Ravenna to Slack channels, people, and groups, schedule them for later, track delivery, and turn replies into tickets.

Broadcasts let your team send one update to many places in Slack at once: maintenance notices, policy changes, onboarding reminders, or anything else people need to see. You write the message in Ravenna, choose who it comes from, pick the Slack channels, people, and groups (Collections of users you can manage manually or sync from an identity provider) that should get it, then send it right away or schedule it. Afterwards, you can see who received it and which replies turned into tickets.

Broadcasts is in beta and available to selected organizations. To request access, contact your Ravenna representative, or reach out to the Ravenna team on Slack or through the in-app chat. Testing it? See the [Broadcasts tester guide](https://docs.ravenna.ai/documentation/platform/broadcasts-beta).

> [!NOTE]
>
> Workspace members and admins open Broadcasts from **Broadcasts** in the workspace sidebar.

***

## Broadcast list

The **Broadcasts** page lists every broadcast in your workspace, with its status, who created it, how many recipients it has, and when it was sent or is scheduled to send. Cards above the list count your broadcasts that are In progress, Scheduled, Sent, Failed, and Partially sent.

* **Filter** by status, creator, or send date, or search by name.
* **Sort** by last edited, created, name, scheduled, or sent date.
* Click a broadcast to open it.

### Manage broadcasts

Open a broadcast's row menu to **View**, **Duplicate**, **Cancel** a scheduled broadcast, or **Delete** a draft. A duplicate opens as a new Draft with **(copy)** added to its title.

To act on several broadcasts at once, select their checkboxes and choose **Delete** or **Cancel**. Ravenna deletes the selected drafts or cancels the selected schedules, and skips any selected broadcast in another status.

> [!WARNING]
>
> Deleting a draft permanently removes it and its attachments.

***

## Create a broadcast

**1. Start a new broadcast**

On the **Broadcasts** page, click **New**.

**2. Write the message**

Enter a **Notification title** and write the message. Type `/` to add headings, bulleted, numbered, or to-do lists, quotes, code blocks, and dividers. The editor also accepts Markdown.

**3. Add attachments**

Click the paperclip, or drag files onto the message, to attach up to five files of up to 10 MB each.

**4. Configure delivery**

In the **Configure broadcast** panel, choose the sender, the audience, and when to send. See [Choose the sender and audience](#choose-the-sender-and-audience) and [Send or schedule](#send-or-schedule).

> [!TIP]
>
> Ravenna saves the draft automatically as you edit. If you leave a new broadcast without changing anything, Ravenna discards it.

To remove a draft you no longer need, open the **...** menu at the top of the page, click **Delete draft**, and confirm.

In Slack, the notification title appears as the heading of the message and as the notification preview.

***

## Choose the sender and audience

### Sender

**Sender** sets the Slack identity the broadcast is posted under. Choose the Ravenna app, or any active member of your workspace. The message preview above the editor shows the name and photo recipients will see.

When you send as a person, Ravenna posts the message with that person's name and photo, and posts any attachments as a reply in the message's thread.

### Audience

Use the **Audience** list to choose who receives the broadcast. Switch the list between **Channels**, **Users**, and **Groups**, then select the checkboxes for everyone who should get it. Your selections carry across all three, so one broadcast can go to channels, people, and groups together. Search the list, or filter it by **Selected** or **Not selected**.

| Audience | How it arrives |
| - | - |
| **Channels** | A message in the Slack channel |
| **Users** | A direct message |
| **Groups** | A direct message to each member of the group |

> [!WARNING]
>
> The **Channels** list shows only the Slack channels the Ravenna app is a member of. To broadcast to another channel, add the Ravenna app to it in Slack first.

***

## Send or schedule

Under **Delivery timing** in the **Configure broadcast** panel, choose when the broadcast goes out. The footer summarizes who it goes to.

* **Send immediately**: click **Send now** and confirm. Ravenna starts delivering right away.
* **Schedule for later**: pick a date and time, click **Schedule**, and confirm. Scheduled times use your local time zone. The broadcast becomes Scheduled.

> [!TIP]
>
> Before you send, click **Send test** to receive the broadcast in your own Slack direct messages exactly as recipients will see it.

### Change a scheduled broadcast

A Scheduled broadcast is locked for editing. To change its send time, pick a new date and time and click **Reschedule**. To stop it or edit it, open the menu next to **Reschedule** and click **Cancel schedule**. The broadcast returns to Draft.

***

## Track delivery

Each broadcast shows its status in the list and on its page:

| Status | Meaning |
| - | - |
| Draft | Being written |
| Scheduled | Waiting for its send time |
| Sending | Ravenna is delivering it |
| Sent | Every recipient received it |
| Partially sent | Some deliveries succeeded and some failed |
| Failed | No recipient could be reached |

After a broadcast goes out, its **Delivery details** panel shows how many recipients received it, how many deliveries failed, and **Tickets from replies**. Below that, the **Recipients** table lists each person and channel with:

* **Status**: Pending, Delivered, or Failed. Hover over a status to see the reason when a delivery failed or had a problem, such as an attachment that failed to upload.
* **Ticket**: the ticket created from replies, if any.
* **Reactions**: the total number of emoji reactions on that message. Hover over it to see the count for each emoji.

Search the table, or filter it by **Status** or by **Ticket** (**Has a ticket** or **No ticket**).

***

## Replies become tickets

When someone replies in a broadcast's Slack thread, Ravenna opens one ticket for that thread, titled **Re:** followed by the broadcast title. The person who replied is the requester, and the broadcast message is copied into the ticket for context. Later replies in the same thread are added to the same ticket.

> [!NOTE]
>
> The ticket stays unpublished until a reply reads as a request. Once a reply asks for something, Ravenna publishes the ticket and it counts toward **Tickets from replies**.

Where the ticket lands depends on where the reply was posted:

* **A Slack channel connected to a Ravenna channel in the same workspace**: the ticket goes to that Ravenna channel, like any other request posted there.
* **A direct message or any other Slack channel**: the ticket goes to the workspace's **Slack** system channel (Built-in channels that hold requests from a source, such as Slack direct messages) as a private ticket (Tickets visible only to the requester and people with access), and the requester follows it in their direct messages with Ravenna.

Learn more about [direct messages in Slack](https://docs.ravenna.ai/integrations/slack/direct-messages.md)


## Related topics

- [List broadcasts](https://docs.ravenna.ai/api/broadcasts/list-broadcasts.md)
- [Broadcast statistics](https://docs.ravenna.ai/api/broadcasts/broadcast-statistics.md)
- [Get a broadcast](https://docs.ravenna.ai/api/broadcasts/get-a-broadcast.md)
- [Cancel a scheduled broadcast](https://docs.ravenna.ai/api/broadcasts/cancel-a-scheduled-broadcast.md)
- [Create a draft broadcast](https://docs.ravenna.ai/api/broadcasts/create-a-draft-broadcast.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.