Skip to content
API Reference

Slack

Version: unreleased · Docs: 3c6ab9f2Download Markdown

Use Slack to search accessible discussions, discover channels or people, and read messages and complete threads for context.

Open Customize → Plugins and select this plugin. Add installs an available package; Uninstall means it is already installed. An offered Update refreshes its package version. Your deployment and administrator policy determine availability.

When Add Account is offered, follow its connection instructions using an authorized account that owns or can access the intended resource. If several accounts are connected, check the selected account and Default before the task. Reconnect refreshes an expired connection; an administrator setup notice needs administrator configuration.

Enable the plugin for the selected agent or task. On an installed plugin’s Tools table, check Enabled and the Approval setting for the operations you intend to use. New tasks use these settings; a pending approval still needs a decision. See agent setup and action approvals.

Use Slack plugin in Redbelt

Plugin details under Customize → Plugins. The button shows the current installation state.

  1. Ask Redbelt to find the channel you want to review and confirm its channel ID.
  2. Search for discussions about the project topic you provide and read matching threads.
  3. Ask for decisions, remaining questions, and owners, with links or message references for each finding.
  4. Read the relevant channel history when the search result lacks context.
  5. Review the source references before using the summary in another document.

Search the Slack channel I select for project discussions from the last two weeks. Read the relevant threads and summarize approved milestones, unresolved decisions, and assigned owners. Include references and say when an owner was not named.

Public search and public-and-private search have different visibility. Access still follows the connected account and Slack’s permissions. Channel search discovers destinations; user search and profile reads resolve people. Neither grants additional channel access.

Thread reading uses the channel ID and parent message timestamp. A single search hit can omit replies, so read the thread before concluding that a discussion has no resolution. Keep date and channel filters narrow, then expand them deliberately when needed.

The current catalog exposes read and search tools only. It does not expose message sending, even if a package description mentions sending. You can ask Redbelt to draft an update in the thread and post the reviewed text yourself.

Thread and workflow availability are listed separately. A tool must also be enabled for your task and allowed by its account and administrator policy. Configure workflow app actions using only actions offered by the current picker.

Tool Required Fields Thread Workflow
slack.read_channel channel_id Yes Yes
slack.read_thread channel_id, message_ts Yes No
slack.read_user_profile No mandatory top-level fields Yes No
slack.search_channels query Yes Yes
slack.search_public query Yes Yes
slack.search_public_and_private query Yes Yes
slack.search_users query Yes Yes

Required fields above are the schema minimum. The target, selected operation, or account can impose additional requirements.

slack.read_channel — Read messages from a Slack channel in reverse chronological order. Optional fields: latest, limit, oldest, response_format.

slack.read_thread — Read messages from a specific Slack thread thread. Optional fields: latest, limit, oldest, response_format.

slack.read_user_profile — Get detailed profile information for a Slack user. Optional fields: include_locale, response_format, user_id.

slack.search_channels — Find Slack channels by name or description. Optional fields: channel_types, include_archived, limit, response_format.

slack.search_public — Search for messages and files in public Slack channels. Optional fields: after, before, content_types, include_bots, limit, response_format, sort, sort_dir.

slack.search_public_and_private — Search for messages and files across all Slack channels including private, DMs, and group DMs. Optional fields: after, before, channel_types, content_types, include_bots, limit, response_format, sort, sort_dir.

slack.search_users — Find Slack users by name, email, or profile attributes. Optional fields: limit, response_format.

If private content is absent, confirm the connected account belongs to that channel. If a thread cannot be read, verify the channel ID and parent timestamp from a fresh result.

Provider details: Slack channel access documentation.