Before you start
You need:- Plain’s Slack integration connected, with the channels you want to reach set up as customer channels.
- A Slack channel per customer. Broadcasts reach customers through their connected Slack channels, so a customer with no enabled channel cannot be reached.
- The Owner, Admin, or Support role, if you want the broadcast to send under your own name.
Sending a broadcast
Follow these steps to send a broadcast:- Write a broadcast: the name, notification title, content, and sender
- Choose who receives it: filter customers into a list of Slack channels
- Send and schedule: review it, post a test, then send now or schedule it
- Read the report: delivery counts, per-channel statuses, reactions, and reply threads
The broadcast lifecycle
A broadcast has four states, and the Broadcasts list has a tab for each:
A broadcast can only be sent once. After it sends, the message becomes read-only and the page turns into a report on how the send went. To send the same message again, duplicate the content into a new broadcast, or filter on the threads the first one created and follow up there.
Using the API
You can create and update broadcasts through the GraphQL API. The API key needs all four of the following permissions:broadcasts:createbroadcasts:sendbroadcasts:readworkspaceSlackIntegration:read
workspaceSlackIntegration:read is required because a broadcast resolves its audience into Slack channels, which means reading your Slack integration.
Resources
- Broadcast audiences: build and reuse the filter that decides who a broadcast reaches
- Slack: connect the integration and set up customer channels
- Tenants: the customer accounts and tenant fields you filter on
- Tiers: the service levels you filter on
- GraphQL API: the data model behind the API permissions above