> ## Documentation Index > Fetch the complete documentation index at: https://docs.alysio.ai/llms.txt > Use this file to discover all available pages before exploring further. # Slack > Connect Alysio to Slack using OAuth 2.0 ## Overview The Slack integration allows Alysio to connect directly to a user’s Slack workspace so messages, conversations, files, and collaboration tools can be accessed and managed through natural language. Once connected, Alysio can interact with Slack channels, direct messages, and collaborative documents. Users can send or schedule messages, search conversations, read threads, retrieve user profiles, and create or view Canvas documents without leaving Alysio. Common examples include Posting updates to a Slack channel\ Sending a direct message to a teammate\ Scheduling reminders for later\ Searching conversations across the workspace\ Reading a thread or reviewing a discussion\ Creating a Canvas document for meeting notes or project documentation All actions occur through the authenticated Slack account connected by the user and respect the permissions defined within the Slack workspace. *** ## Supported Data and Capabilities ### Messaging Alysio can send, schedule, or draft Slack messages. Supported actions include Posting messages to channels\ Sending direct messages to users\ Scheduling messages for a future time\ Creating draft messages for later review or sending This allows users to coordinate updates, reminders, and notifications directly through Alysio. *** ### Search and Discovery Alysio can search Slack conversations and files across the workspace. Supported actions include Searching messages and files in public channels\ Searching across public channels, private channels, direct messages, and group conversations\ Finding channels by name or description\ Finding users by name, email, or profile attributes These capabilities allow users to quickly retrieve historical conversations and project discussions. *** ### Reading and Viewing Content Alysio can retrieve and display Slack content such as channel messages or thread conversations. Supported actions include Reading recent channel message history\ Viewing all messages within a thread\ Viewing Slack Canvas documents\ Retrieving detailed Slack user profiles *** ### Canvas Documents Slack Canvas documents can be created and viewed through Alysio. Supported actions include Creating new Canvas documents\ Viewing Canvas content within Slack Canvas documents are often used for meeting notes, project briefs, and team documentation. *** ## Authentication ### Method OAuth 2.0 with Slack ### API Provider Slack Web API and Slack Canvas APIs ### Redirect URI Configured during Slack integration setup in Alysio.\ The Slack application must include this URI in its OAuth configuration. *** ## Token Handling OAuth tokens are securely stored and automatically refreshed. Each user connects their own Slack account, ensuring that API calls operate within the context of the correct workspace and user identity. If a user disconnects Slack or revokes access, Slack tools will stop working until the integration is reauthorized. *** ## Required OAuth Scopes The Slack integration requires both bot token scopes and user token scopes to support messaging, search, and workspace discovery. ### Bot Token Scopes team:read\ chat:write.public\ users:read\ im:write\ chat:write\ channels:read\ app\_mentions:read\ commands\ assistant:write\ im:history\ groups:read\ users:read.email *** ### User Token Scopes search:read.public\ search:read.private\ search:read.mpim\ search:read.im\ search:read.files\ search:read.users\ chat:write\ channels:history\ groups:history\ mpim:history\ im:history\ canvases:read\ canvases:write\ users:read\ users:read.email\ team:read Some features require additional permissions depending on workspace configuration. Private channel access requires groups:read and groups:history scopes.\ Canvas features require Slack workspaces that support Canvas. *** ## MCP Tools The Slack MCP provides tools that allow Alysio to interact with Slack conversations, users, and documents using natural language. *** ## Messaging Tools ### slack\_send\_message Sends a message to a Slack channel or direct message conversation. Example prompts Post this update to #general\ Send a DM to John with the meeting summary *** ### slack\_schedule\_message Schedules a Slack message to be sent at a future time. Example prompts Schedule a reminder tomorrow at 9am\ Post this update Friday at noon *** ### slack\_send\_message\_draft Creates a draft Slack message that can be reviewed or sent later. Example prompts Draft a message to #sales\ Create a draft for the weekly team update *** ## Search and Discovery Tools ### slack\_search\_public Searches Slack messages and files within public channels. Example prompts Search public channels for launch timeline\ Find messages about the roadmap *** ### slack\_search\_public\_and\_private Searches messages across the entire workspace including private channels and direct messages. Example prompts Search all Slack messages for client feedback\ Find any conversation mentioning the budget *** ### slack\_search\_channels Finds Slack channels by name or description. Example prompts Find channels related to engineering\ List channels with support in the name *** ### slack\_search\_users Finds Slack users by name, email, or profile information. Example prompts Find user [john@company.com](mailto:john@company.com)\ Search for users named Sarah *** ## Reading and Viewing Tools ### slack\_read\_channel Retrieves recent message history from a Slack channel. Example prompts Show the last messages in #general\ Read channel history for #engineering *** ### slack\_read\_thread Retrieves the full conversation from a Slack thread. Example prompts Show all replies in this thread\ Read the full discussion *** ### slack\_read\_canvas Displays the content of a Slack Canvas document. Example prompts Show the Canvas document for the product brief\ Read the Canvas content *** ### slack\_read\_user\_profile Retrieves detailed Slack user profile information. Example prompts Show John’s Slack profile\ Get profile information for Jane *** ## Canvas Tools ### slack\_create\_canvas Creates a new Slack Canvas document with formatted content. Example prompts Create a Canvas with meeting notes\ Create a Canvas for the Q1 planning session *** ## App Behavior Slack API calls are executed only when a user asks Alysio to perform an action or retrieve information. There is no background synchronization. Each request triggers the appropriate Slack API endpoint using the authenticated user’s OAuth credential. When needed, Alysio may first retrieve channel or user identifiers using search tools before performing messaging or reading operations. *** ## Example Workflow User asks Search Slack for Q4 roadmap discussions and post a summary to #product. Alysio routes the request to the Slack MCP. The MCP searches Slack conversations using the workspace search tool. The MCP identifies the #product channel using the channel search tool. A summary of the results is generated. The MCP posts the summary to the channel using the send message tool. Slack confirms the message delivery and Alysio returns the result to the user. *** ## Troubleshooting ### Missing or Expired Connection Slack has not been authorized or the connection has expired. Solution\ Reconnect Slack under Settings → Integrations and complete the OAuth authorization flow. *** ### 401 Unauthorized The Slack OAuth token is invalid or expired. Solution\ Reauthorize the Slack integration to generate a new token. *** ### 403 Forbidden or Missing Scope The Slack application does not have the required OAuth permissions. Solution\ Update the Slack app configuration to include the required scopes and reinstall or reauthorize the integration. *** ### Channel or User Not Found Slack messaging and reading tools require valid identifiers. Solution\ Use the search tools to retrieve the correct channel or user ID before sending or reading messages. *** ### Limited Search Results Private channel or direct message searches require additional scopes and channel access. Solution\ Ensure the Slack application has the appropriate scopes and has been added to the channel. *** ### Canvas Features Not Available Canvas functionality may not be enabled in the workspace. Solution\ Confirm that the Slack workspace supports Canvas and that the integration has the required Canvas scopes. *** ## Support For assistance configuring or troubleshooting the Slack integration contact [support@alysio.ai](mailto:support@alysio.ai) For Slack API documentation see the official Slack API documentation.