Team
Shared credential for production and unattended runs.
Connect Slackbot with Hookshot™ and your stack
Slackbot gives agents workspace-wide read access to a Slack workspace on behalf of the installing user — search messages and files, browse channel and thread history, and look up users and channels — while continuing to post and react as the bot. Includes direct messages and user email addresses so agents can search across DMs and resolve users by email.
Tools and triggers
What Agents can do in Slackbot
Available tools and events after Slackbot is connected.
-
Add a Remote File
This action adds a reference to an external file from a service to Slack. It requires an external ID and URL, allowing Slack users to access and share the file with others.
-
Add Call Participants
This action allows you to add users to an ongoing Slack call. You can specify multiple users by providing their Slack IDs and optionally external IDs.
-
Add Reaction to Message
This action adds an emoji reaction to an existing message in Slack. Specify the channel ID, the message timestamp, and the emoji name (like 'thumbsup' or 'tada') to react to a message. You can also use skin tone…
-
Archive a Slack Conversation
Sends a request to archive a specified Slack conversation, making it read-only and hidden. This action helps in managing inactive channels while retaining the conversation history.
-
Close Conversation Channel
This action closes a specified Slack direct message or multi-person direct message channel. It allows users to remove the channel from their sidebar view without deleting any message history.
-
Create a Reminder
Creates a Slack reminder with specified text and time; time accepts Unix timestamps, seconds from now, or natural language (e.g., 'in 15 minutes', 'every Thursday at 2pm').
-
Create a Slack User Group
Creates a User Group in Slack, allowing for better organization of users within specific teams. This action provides properties such as a name, description, and channels for the group.
-
Create Channel
This action creates a new Slack channel in the workspace. You can create either a public channel visible to all workspace members or a private channel that is invite-only. Specify the channel name and optionally target…
-
Create Slack Canvas
This action creates a new canvas in Slack with the specified title. Optionally, you can provide content and choose a channel for the canvas to appear in.
-
Create Slack List
This action creates a new Slack List. You can name it, give it a description and columns, copy an existing List's structure, or turn on task-tracking mode.
-
Create Slack List Item
This action adds a new row to a Slack List. You can set the row's starting values, copy an existing row, or create it as a subtask under another row.
-
Customize URL Unfurl
This action customizes the URL previews in Slack messages. It allows specifying custom content for unfurling certain links or removing existing previews using a URL-encoded JSON format.
-
Delete a File by ID
This action allows the permanent deletion of a specific file from a Slack workspace by its unique file ID. Once executed, the file and all associated data, such as comments and shares, are irreversibly removed.
-
Delete a Message From a Chat
This action deletes a specified message from a Slack conversation. The message to be deleted is identified by its channel ID and timestamp, and the deletion is performed by the authenticated user or bot that posted the…
-
Delete a Slack Reminder
Deletes a specific Slack reminder identified by the provided reminder ID. This action permanently removes the reminder from the user's list.
-
Delete File Comment
This action removes a specific comment from a file in Slack. It is important to note that this action cannot be undone once completed.
-
Delete Multiple Slack List Items
This action deletes multiple rows from a Slack List at once. It is all-or-nothing: either every listed row is deleted or none are, and Slack does not report which individual rows succeeded, so on failure you should…
-
Delete Scheduled Chat Message
This action allows you to delete a scheduled message in a chat. You need to specify the message ID and the channel where the message is scheduled.
-
Delete Slack Canvas
This action permanently deletes a specified Slack Canvas. You must provide the unique identifier for the canvas you wish to delete.
-
Delete Slack List Access
This action removes sharing access on a Slack List. Specify the List and either the channels or the users (not both) whose access you want to revoke.
-
Delete Slack List Item
This action permanently deletes a single row from a Slack List. Provide the List ID and the item (row) ID to remove.
-
Disable a Slack User Group
Disables a Slack User Group identified by its unique ID. This action effectively archives the group without permanently deleting it, allowing for possible re-enablement in the future.
-
Download Slack File
Tool to download Slack file content and convert it to a publicly accessible URL. Use when you need to retrieve and download files that have been shared in Slack channels or conversations.
-
Edit Slack Canvas
The EditCanvas action allows for modifications to an existing Slack canvas. Users can replace, insert, or delete content at specified locations within the canvas.
-
Enable a User Group
This action reactivates a previously disabled User Group in Slack. It allows the group to be mentioned and assigned permissions, without altering its other properties or creating new groups.
-
End a Call
This action allows you to end a call on Slack. You can specify the duration of the call in seconds and provide the unique identifier for the call that you want to end.
-
Fetch Bot User Information
Retrieves detailed information about a specified Slack bot user. This includes the bot's display name, avatar images, and other related data.
-
Fetch Conversation History
Fetches one page of conversation history from a specified channel, allowing users to filter messages based on a date range and cursor-based pagination. This action makes one Slack API call and does not internally…
-
Fetch Item Reactions
Fetches user reactions for a specified item such as a Slack message, file, or file comment. It requires either a combination of channel and timestamp or alternatively a file ID or file comment ID to retrieve the…
-
Fetch Team Info
Fetches comprehensive metadata about the current Slack team, or a specified team if the provided ID is accessible.
-
Find Channels
This action finds channels in a Slack workspace based on various criteria such as name, topic, or purpose. It searches across channel names, topics, and purposes with partial matching. Results are limited to channels…
-
Find Users
This action allows you to search for users in a Slack workspace using various criteria such as email or name. It can perform efficient searches and return detailed user information based on the query parameters provided.
-
Get Conversation Members
This action retrieves a list of members from a specified Slack conversation. It supports public channels, private channels, direct messages, and multi-person direct messages.
-
Get Reminder Information
This action retrieves detailed information about a specific Slack reminder. The reminder is identified using its unique ID, allowing users to access all associated details and statuses.
-
Get Remote File
This action retrieves details about a specific remote file uploaded to Slack using its unique identifier and file ID.
-
Get Slack List Item
This action reads one row from a Slack List. It returns the row's column values and details about the List it belongs to, and can optionally tell you whether you're subscribed to that row.
-
Get Team DND Status
This action retrieves the Do Not Disturb status for a list of specified users. It provides the current status information to help manage user availability.
-
Get Unread Messages From User
Retrieves unread direct messages from a specific user by opening their DM conversation, checking for unread messages, and fetching message history since the last read timestamp. Use this action when you need to check…
-
Invite Users to a Slack Channel
This action invites one or more users to a Slack channel by their user IDs. Use it to add team members to public or private channels for collaboration.
-
Join Conversation by Channel Id
Joins an existing Slack conversation (public channel, private channel, or multi-person direct message) by its ID, if the authenticated user has permission. Joining an already-joined channel returns a non-fatal no-op…
-
Leave Conversation Channel
This action removes the authenticated user from a Slack channel, private group, or DM conversation. Provide the channel ID to leave the conversation. Note that you cannot leave the general channel or leave as the last…
-
List All Channels
This action retrieves a list of all channels (public, private, group DMs, or direct messages) in a Slack workspace that the authenticated user has access to. You can filter by channel type, exclude archived channels…
-
List All Users
This action retrieves a full list of users from a Slack workspace. It provides detailed profile information and allows pagination for large user bases.
-
List All Users in a User Group
This action retrieves a list of all user IDs within a specified Slack user group. It allows for the inclusion of users from disabled groups if requested.
-
List Available Workspaces
List Slack workspaces where both the connection and target user have access. Returns each workspace's team_id and name. Use this when: (1) the user references a workspace by name, (2) a user-specific tool requires…
-
List Conversations
List conversations (channels/DMs) accessible to a specified user (or the authenticated user if no user ID is provided), respecting shared membership for non-public channels. Returns conversation IDs (C* for channels…
-
List Pinned Items in a Channel
Retrieves all messages and files pinned to a specified channel; the caller must have access to this channel.
-
List Reminders
This action retrieves all reminders for the authenticated user in Slack. It provides detailed information about each reminder, including its status and contents.
-
List Remote Files
This action retrieves a list of files from a specific channel in a team's remote file storage. It allows filtering by timestamp and pagination to manage large sets of data.
-
List Slack Files
This action retrieves a list of files from a Slack workspace. Users can filter the results based on user ID, channel, creation timestamps, and file types.
-
List Slack List Items
This action reads the rows from a Slack List. It supports pagination for large Lists and can optionally return archived rows instead of active ones.
-
List Team Custom Emojis
This action fetches all custom emojis available in the Slack workspace. It provides a list of image URLs or aliases associated with those custom emojis.
-
List Unread Channel Messages
Lists all unread messages in a specified Slack channel for the authenticated user. This action fetches messages that have been posted since the user's last read position in the channel. Use this action when you need to…
-
List User Groups
This action retrieves a list of user groups within a specified Slack team. It allows customization of the request to include user IDs, user counts, and the status of user groups (active/disabled).
-
List User Reactions
Lists all reactions added by a specific user to messages, files, or file comments in Slack, useful for engagement analysis when the item content itself is not required. Results are paginated; check…
-
Lookup Canvas Sections
This action retrieves section IDs within a specified Slack Canvas. These IDs are essential for performing various edit operations such as adding or removing content in the canvas.
-
Lookup Users by Email
This action looks up a Slack user by their email address and returns their complete profile information, including user ID, display name, real name, timezone, and profile details. Use this to find a specific person's…
-
Open DM
Opens or resumes a Slack direct message (DM) or multi-person direct message (MPIM) by providing either user IDs or an existing channel ID. Returns `already_open=true` when the DM exists — treat as success and reuse the…
-
Pin an Item to a Channel
Pins a message to a specified Slack channel. The user must provide both the channel ID and the timestamp of the message to be pinned.
-
Remove Call Participants
This action allows you to remove specified users from an ongoing Slack call. You need to provide the call ID and the list of users to be removed.
-
Remove Reaction From Item
This action removes a specified emoji reaction from a message, a file, or a file comment in Slack. It ensures that the reaction is deleted, allowing for updates to user interactions on the platform.
-
Remove Remote File
This action removes the reference to an external file in Slack. You must provide either the external ID or the Slack file ID to specify which file to remove from Slack without affecting the actual file.
-
Remove User From Conversation
This action removes a specified user from a Slack conversation, given that the caller has the necessary permissions. It ensures that the user is no longer part of the conversation specified by the channel ID.
-
Rename a Conversation
Renames a Slack channel based on provided parameters. The action allows users to update the name of an existing conversation while adhering to naming conventions.
-
Retrieve Call Information
This action retrieves detailed information about a specific Slack call. It uses the unique identifier of the call to fetch its current state and relevant details.
-
Retrieve Conversation Information
Retrieves metadata for a Slack conversation by ID (e.g., name, purpose, creation date, with options for member count/locale), excluding message content. The `channel` parameter is effectively required. Private…
-
Retrieve Conversation Replies
This action fetches the message thread for a specific parent message in a conversation. It retrieves replies and other related messages based on the given channel and timestamp. Important: The parent message includes…
-
Retrieve Detailed File Information
This action retrieves detailed metadata about a specific file in Slack, including any associated comments. The action supports pagination for handling multiple comments efficiently.
-
Retrieve Detailed User Information
Retrieves detailed information about a specific user in the system, including their profile and team associations. This action allows retrieving various attributes of the user based on their unique ID.
-
Retrieve Team Profile Details
This action retrieves the profile field definitions for a Slack team. It allows filtering based on visibility to expose certain fields as needed.
-
Retrieve User DND Status
This action retrieves the current Do Not Disturb (DND) status for a specified Slack user. If no user ID is provided, it defaults to the authenticated user's DND status.
-
Retrieve User Presence
This action retrieves the current real-time presence status of a Slack user. It can return 'active' or 'away' based on the user's current availability.
-
Retrieve User Profile Information
Retrieves the profile information of a specified Slack user, defaulting to the authenticated user if no user ID is provided. This action allows you to include human-readable labels for custom profile fields if desired.
-
Revoke a File's Public Url
Revokes public access to a specific Slack file. This action ensures that the file is no longer accessible via a public URL, helping to secure the file's content.
-
Schedule Message
This action schedules a message to be sent to a Slack channel, DM, or private group at a future time. Write your message in markdown for rich formatting, specify when it should be posted using a Unix timestamp, and…
-
Search All Content
Tool to search all messages and files. Use when you need unified content search across channels and files in one call. Results are scoped to content visible to the authenticated token; missing hits in private or…
-
Search Messages
This action allows you to search for messages across a Slack workspace. You can filter results using various criteria and retrieve them in a paginated format.
-
Send Ephemeral Message
This action sends a temporary message to a specific user within a designated channel. It allows customization options such as user icon and message format.
-
Send Message
This action sends a message to a Slack channel, direct message, or private group. Use markdown_text for normal Markdown messages, or blocks for raw Slack Block Kit layouts with interactive or structured controls.
-
Set a Conversation's Purpose
Sets the purpose (a short description of its topic/goal, displayed in the header) for a Slack conversation; the calling user must be a member.
-
Set Conversation Read Cursor
Marks a specified message as read for the authenticated user in a given channel. This action updates the read cursor to the timestamp of the message.
-
Set Conversation Topic
This action allows users to set or update the topic of a specified Slack conversation. It takes the conversation channel ID and the new topic text to make the update.
-
Set Slack List Access
This action shares a Slack List with channels or users at a chosen access level (read, write, or owner).
-
Set User Presence
This action manually sets your Slack presence status to either 'auto' (let Slack detect your activity) or 'away' (appear as away). The setting persists across connections but can be overridden by user activity or…
-
Share a Me Message in a Channel
Sends a 'me message' to a specified Slack channel. The message is displayed as an action performed by the user in the channel context, enhancing user interaction with real-time updates.
-
Share a Remote File in Channels
This action shares a specified remote file into designated Slack channels. It requires either a file ID or an external ID to locate the file and ensures that the intended channels for sharing are specified.
-
Share File Public Url
This action enables public sharing of an existing Slack file. It generates a publicly accessible URL for the specified file.
-
Start Call
This action registers a new call in Slack, integrating with third-party call applications. It allows you to specify the call details, including participants, start time, and join links.
-
Unarchive Channel
This action unarchives a previously archived conversation making it active again, allowing participation in the conversation once more.
-
Unpin Message From Channel
This action unpins a previously pinned message from a channel. It requires the message's timestamp and the channel ID to identify which message to unpin.
-
Update a Slack Message
This action updates a Slack message. Use markdown_text for normal Markdown updates, or blocks for raw Slack Block Kit layouts with interactive or structured controls.
-
Update an Existing Remote File
This action allows you to update the metadata or content of an existing remote file in Slack. You can change attributes like the title, URL, or file contents without uploading a new file.
-
Update Call Information
This action updates the details of an existing Slack call. It allows you to change the call's title, join URL, and desktop app join URL based on the provided call ID.
-
Update Slack List
This action edits a Slack List's metadata, such as its name, description, or to-do mode. Identify the List by its `id`.
-
Update Slack List Item
This action updates the cell values of an existing row in a Slack List. (To add a brand-new row, use the create Slack List item action instead.)
-
Update Slack User Group
Updates an existing Slack User Group by modifying its properties such as name, description, and default channels. This action requires the ID of the user group to update.
-
Update User Group Members
This action updates the members of a specified Slack User Group. It requires the User Group ID and a complete list of user IDs to replace the current members.
-
Upload or Create a File in Slack
Upload files, images, screenshots, documents, or any media to Slack. Supports all file types including photos (PNG, JPG), documents (PDF, DOCX), code files, and more. Share files in channels, send as thread replies, or…
-
Channel Message Received
Triggered when a message is posted in a Slack channel (public, private, or multi-party IM). Does NOT match direct messages.
-
Direct Message Received
Triggered when a new direct message (DM) is sent to a user in Slack. Catches all DMs across all DM channels.
-
Message Reaction Added
Triggered when a reaction is added to a message in Slack. Supports optional filtering by channel and emoji name.
-
Message Reaction Removed
Triggered when a reaction is removed from a message in Slack. Supports optional filtering by channel and emoji name.
-
New Bot Message Received Trigger
DEPRECATED: use `SLACK_CHANNEL_MESSAGE_RECEIVED` with `is_bot_message=true` instead. Triggered when a new bot message is posted to a Slack channel.
-
New Channel Created Trigger
Triggered when a new channel is created in Slack.
-
New Message Received Trigger
DEPRECATED: use `SLACK_CHANNEL_MESSAGE_RECEIVED` instead. Triggered when a new message is posted to a Slack channel.
-
Reaction Added Trigger
DEPRECATED: use `SLACK_MESSAGE_REACTION_ADDED` instead. Triggered when a reaction is added to a message in Slack.
-
Reaction Removed Trigger
DEPRECATED: use `SLACK_MESSAGE_REACTION_REMOVED` instead. Triggered when a reaction is removed from a message.
Setup
Connect Slackbot in Hookshot™
Pick a scope, then confirm what can start a Protege and what it can do.
Trigger Access
What can start a Protege from this app.
Tool Access
What a Protege can do after it starts.
Connection scope
Prefer team for production.
Personal
Tied to one user—only when the workflow needs their account.
Chat
Team-scoped for supported chat surfaces.
Build with us
See Hookshot™ in your stack.
Request early access or book a live walkthrough with the team.
