Search documentation

Search for a topic, a control, or an event type.

    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.