feat(slack): add better error messages, reminder to add bot to app

[waleedlatif1]

Summary

• add better error messages, reminder to add bot to app

Type of Change

• New feature

Testing

Tested manually

Checklist

• Code follows project style guidelines
• Self-reviewed my changes
• Tests added/updated and passing
• No new warnings introduced
• I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Preview	Comments	Updated (UTC)
docs	Skipped			Nov 14, 2025 10:18am

[greptile-apps]

Greptile Overview

Greptile Summary

Enhanced error handling in the Slack message reader tool by adding specific error messages for common API failures.

• Added user-friendly error messages for not_in_channel, channel_not_found, and missing_scope errors
• Provided actionable instructions (e.g., inviting bot with /invite @Sim Studio, reconnecting with proper scopes)
• Improved user experience by replacing generic error messages with context-specific guidance

Confidence Score: 5/5

• This PR is safe to merge with minimal risk
• The changes are focused, well-structured, and improve error handling without altering core functionality. Error messages provide clear, actionable guidance to users.
• No files require special attention

Important Files Changed

File Analysis

Filename	Score	Overview
apps/sim/tools/slack/message_reader.ts	5/5	Added error handling with user-friendly messages for common Slack API errors

Sequence Diagram

sequenceDiagram
    participant User
    participant SlackMessageReader
    participant SlackAPI
    
    User->>SlackMessageReader: Read messages from channel
    SlackMessageReader->>SlackAPI: GET conversations.history
    
    alt Success (data.ok = true)
        SlackAPI-->>SlackMessageReader: Return messages
        SlackMessageReader-->>User: Return formatted messages
    else Error: not_in_channel
        SlackAPI-->>SlackMessageReader: Error: not_in_channel
        SlackMessageReader-->>User: Throw: "Bot is not in the channel. Please invite the Sim bot..."
    else Error: channel_not_found
        SlackAPI-->>SlackMessageReader: Error: channel_not_found
        SlackMessageReader-->>User: Throw: "Channel not found. Please check the channel ID..."
    else Error: missing_scope
        SlackAPI-->>SlackMessageReader: Error: missing_scope
        SlackMessageReader-->>User: Throw: "Missing required permissions. Please reconnect..."
    else Other Error
        SlackAPI-->>SlackMessageReader: Error: other
        SlackMessageReader-->>User: Throw: Generic error message
    end

Loading

[greptile-apps]

_{1 file reviewed, no comments}

_{Edit Code Review Agent Settings | Greptile}