Slack
What Paperbeam reads from Slack, the read-only access it asks for and why, filters, and the beats it feeds.
Chat
Read-only OAuth
Posts from channels you choose (#wins, #shoutouts…). Reading requires Slack Marketplace approval; until then Slack is a delivery channel plus /tip. We keep only short excerpts for at most 30 days.
What we read
- Messages in the public channels you select (e.g. #wins, #shoutouts, #launches), with the author's name.
Only the reporting window of each edition is read. Paperbeam stores derived facts and short excerpts, not copies of your Slack data, and keeps raw evidence only for your retention period.
Access we ask for, and why
| Scope | Why |
|---|---|
channels:history | Read messages in the public channels you select |
channels:read | List channels so you can choose them |
users:read | Show who posted |
chat:write | Deliver the paper to a channel |
All access is read-only. You can revoke it from Slack at any time, or disconnect the source in Paperbeam.
Connect Slack
- Go to Sources and choose Slack.
- Click Continue to Slack and approve the read-only access in the window that opens.
- The credential is encrypted before it is stored and never shown again. Use Sync now on the source’s page to see what it collects from the last 24 hours, and set filters there.
You need the admin or owner role in Paperbeam, and enough permission in Slack to grant read access to the data listed above.
Filters
Set on the source’s page at Sources›Slack. Filtered-out data is never collected.
| Filter | Effect |
|---|---|
| Channels | The channels to read. Nothing else is read. |
| Private channels | Off by default. When on, only private channels the Paperbeam app was invited to. |
To keep specific people, channels or topics out of the paper across all sources, use exclusion rules and the never-mention list in House style.
Beats
Slack is a source for:
Stories land in whichever of your sections fits them best.
Good to know
- Slack's terms limit how long third parties may keep messages. We keep only short excerpts (up to 600 characters) for at most 30 days, and link back to the original message.
- Reading Slack requires our Slack Marketplace approval, which is in progress. Until then Slack works fully as a delivery channel, and reading is limited to the most recent messages per channel.