Slack

Overview

The Slack server enables AI assistants to interact with your Slack workspaces, allowing seamless communication, channel management, and team collaboration through conversational AI.

How to Add Slack

1. 1
   Create Slack App

   1. Go to https://api.slack.com/apps
   2. Click Create New App
   3. Select From scratch
   4. Name your app and select your workspace
2. 2
   Configure OAuth Permissions

   1. In your app settings, click OAuth & Permissions in the left menu
   2. Under Scopes > Bot Token Scopes, add the required access permissions

   info

   Required OAuth Scopes

   For the test commands below to work, add these minimum Bot Token Scopes:

   • channels:read - List and view basic channel information
   • channels:history - Read message history from public channels

   Depending on your use case, you may also want to add:

   • chat:write - Post messages to channels
   • users:read - View basic user information
   • reactions:read - View emoji reactions
   • reactions:write - Add emoji reactions to messages
   • files:read - Access file content

   You can always add more scopes later by returning to the OAuth & Permissions page in your Slack app settings.

   3. Scroll up and click Install to [workspace]
   4. Invite the bot to the requisite channels:
      • Open the Slack channel where you want the bot to work
      • Click on the channel name at the top to open channel details
      • Go to the Integrations tab
      • Click Add apps and select your bot
      • Alternatively, you can type /invite @YourBotName in any channel to add it
   5. Restart Slack to ensure the changes take effect
   6. Copy the Bot User OAuth Token that appears in the OAuth & Permissions section in the left menu
3. 3
   Connect to Civic

   1. Add the Slack server to your Civic environment through the server directory
4. 4
   Test Connection

   1. Start with a simple command like list channels or get recent messages from #general to verify the connection works properly.
   2. You will be prompted to authorize the connection with Slack using the bot token that you copied from step 2.6.

tip

If you have difficulty prompting the bot to update OAuth token, go to Civic > Org & Toolkit > Account, delete Slack, then re-add the Slack server to get the prompt again.

What You Can Do

Team Communication

Send messages, reply to threads, and interact with team members across channels

Channel Management

List channels, browse conversations, and access channel history

User Interactions

Get user profiles, add reactions, and engage with workspace members

Thread Management

Reply to message threads and retrieve threaded conversations

Available Tools (8)

Communication Tools

slack_post_message

slack_post_message — Post a new message to a Slack channel

slack_reply_to_thread

slack_reply_to_thread — Reply to a specific message thread in Slack

slack_add_reaction

slack_add_reaction — Add a reaction emoji to a message

Channel Management

slack_list_channels

slack_list_channels — List public or pre-defined channels in the workspace with pagination

slack_get_channel_history

slack_get_channel_history — Get recent messages from a channel

slack_get_thread_replies

slack_get_thread_replies — Get all replies in a message thread

User Management

slack_get_users

slack_get_users — Get a list of all users in the workspace with their basic profile information

slack_get_user_profile

slack_get_user_profile — Get detailed profile information for a specific user

Use Cases

Team Collaboration

• Daily Standups: "Post our team standup summary to #engineering"
• Project Updates: "Reply to the latest message in #project-alpha with our status update"
• Announcements: "Send a message to #general about the deployment completion"

Communication Management

• Message Monitoring: "Show me the last 20 messages from #support"
• Thread Following: "Get all replies in the thread about the database issue"
• Team Engagement: "Add a ✅ reaction to the latest message in #deployment"

Team Insights

• User Discovery: "List all users in the workspace"
• Profile Lookup: "Get John's profile information"
• Channel Overview: "Show me all available channels"

note

The Slack server requires appropriate workspace permissions and bot token configuration to access channels and send messages. Remember to invite your bot to any channels you want it to access.

---

Guardrails

In addition to the 14 universal guardrails, this server has 3 server-specific guardrails across all operations.

note

Slack's server-specific guardrails are scoped versions of the universal guardrails — the same rules applied explicitly at the Slack server level, covering all operations rather than individual tools.

Guardrail	Operation	Timing	Description
Block PII in Requests	(all operations)	Request	Prevents sending PII in request parameters — Slack-scoped version
Redact Credit Card Numbers	(all operations)	Response	Redacts credit card numbers from Slack responses
Redact Email Addresses	(all operations)	Response	Redacts email addresses from Slack responses

tip

Configure guardrails via the Civic UI or ask the Configurator Agent: "Add guardrails to my Slack server."