Docs / Workflows / Integrations / Slack
Slack
Read conversations and send messages, replies, reactions and files in a Slack workspace.
What you can do
Each Slack integration’s page in OAIZ shows these uses, with its events and its read and write actions, under What you can do with Slack.
- Order alerts
- Post to a channel when an order fails.
- App mentions
- Answer questions when someone mentions your app.
- Thread summaries
- Summarise a long thread and reply with the key points.
Connection scope
The connection uses the OAIZ Slack app’s account. Public channels allow posting without membership. Reading history, reading threads and adding reactions require membership. Private channels are available only after someone invites the app in Slack. By default, a new connection gives each OAIZ member access to the channels they are in on Slack, when their verified OAIZ email address matches their Slack email.
Connecting
Authorize the OAIZ Slack app in the workspace you want to connect and approve its permissions. Invite the app to private channels it should read. It can join public channels through Join Channel.
- Messages and conversations
- channels:history, channels:read, channels:manage, channels:join, groups:history, groups:read, chat:write, chat:write.public, im:history, im:read, im:write, mpim:history, mpim:read and mpim:write.
- People, reactions and files
- users:read, users:read.email, users.profile:read, team:read, reactions:read, reactions:write, files:read and files:write.
- Mentions
- app_mentions:read, to receive messages mentioning the app.
Read actions
- Get Thread Messages
- Read a thread’s parent message and replies, oldest first. The app must belong to the conversation.
- Get Channel Info
- Read one channel's name, topic, privacy and archived state.
- Get User Info
- Read one workspace member's profile, including email, timezone and admin flags, from their user ID.
- Get User Presence
- Read whether a workspace user is active or away.
- List Channels
- List public channels and private channels the app belongs to. By default, results include only channels it has joined.
- List Users
- List active human workspace members with their user IDs. Email addresses are available through Get User Info.
- Get Channel Messages
- Read a channel's message history, newest first, optionally by oldest/latest timestamps.
Write actions
- Send Message
- Post a message to a channel or direct conversation, optionally within a thread.
- Update Message
- Edit a message posted by the connected app.
- Delete Message
- Delete a message posted by the connected app.
- Reply to Thread
- Reply to a thread identified by its parent message timestamp. The app must belong to the conversation.
- Add Reaction
- Add an emoji reaction to a message.
- Remove Reaction
- Remove an emoji reaction this app previously added to a message.
- Join Channel
- Add the app to a public channel so it can read messages and threads there.
- Leave Channel
- Remove the app from a channel, ending its access to that channel’s history and threads.
- Invite to Channel
- Invite workspace users into a channel the app belongs to.
- Create Channel
- Create a channel with the app as its first member.
- Archive Channel
- Archive a channel, preventing later messages, replies, reactions and uploads.
- Upload File
- Share supplied file content or selected event attachments in a channel or thread.
Events
Messages, thread replies, app mentions, reactions and channel membership changes arrive as events. The connection also receives channel and workspace changes. An event carries Slack IDs and timestamps that actions use to target the same conversation or message.