Slack Integration

Deploy your Chipp AI to Slack so team members can interact with your AI assistant directly in Slack channels and direct messages.

How It Works

Once connected, your AI becomes a Slack bot that:

• Responds to mentions: @YourBot how do I reset my password?
• Uses threads: Replies in threads to keep channels organized
• Maintains context: Remembers conversation history within each thread
• Works everywhere: Public channels, private channels, and DMs

Key Features

Setting Up Slack Integration

The Slack integration requires creating your own Slack app. Chipp provides a pre-configured manifest to make this easy.

/invite @YourBotName

Using the Slack Bot

Basic Usage

Mention the bot followed by your question:

@YourBot How do I process a return?

The bot replies in a thread so the main channel stays clean.

Following Up

Continue the conversation in the same thread - the bot remembers context:

@YourBot How do I process a return?
└── Bot: To process a return, go to Orders > Returns and...
    └── You: What if the customer doesn't have a receipt?
        └── Bot: Without a receipt, you can still process...

Multiple Users

Team members can jump into threads. The bot considers all messages:

@YourBot Draft a response to this customer complaint
└── Bot: Here's a draft response...
    └── Alice: Make it more empathetic
    └── Bob: And mention our 30-day guarantee
        └── Bot: Here's the revised version incorporating both suggestions...

Direct Messages

DM the bot for private conversations:

1. Find the bot in your Apps or search for it
2. Send a direct message
3. No need to @mention in DMs

Best Practices

Channel Organization

• Create dedicated channels for AI assistance (e.g., #ask-ai, #sales-bot)
• Use private channels for sensitive topics
• Set channel topics explaining what the bot can help with

Prompt Engineering for Slack

Optimize your system prompt for team use:

You are a helpful assistant for the Acme Corp team in Slack.

When responding:
- Keep answers concise (Slack conversations should be quick)
- Use bullet points for lists
- If you need more context, ask clarifying questions
- For sensitive topics, suggest moving to a private channel

Thread Management

• One topic per thread: Start a new message for different questions
• Don’t resurrect old threads: Context has limits; start fresh for new topics
• Use reactions: Thumbs up or check to indicate resolved questions

Managing Your Integration

Editing Credentials

If you need to update your Slack app credentials:

1. Go to Share > Deploy > Deploy to Slack
2. Click Manage Deployment
3. Click Edit Credentials
4. Enter the new values and save

Reinstalling

If you need to reinstall to a different workspace or fix permission issues:

1. Open the Slack deployment dialog
2. Click Install to Slack
3. Select the workspace and authorize

Troubleshooting

Bot Not Responding

1. Make sure the bot is invited to the channel (/invite @YourBotName)
2. Check that you’re @mentioning the bot correctly
3. Verify your Chipp app is active and published

”I don’t have permission” Error

The bot needs to be installed by a workspace admin. Contact your Slack administrator to install the app.

Bot Responding Slowly

1. Check your AI model - faster models respond quicker
2. Complex queries with custom actions take longer
3. High workspace usage can cause brief delays

Installation Failed

1. Verify all three credentials are entered correctly
2. Make sure the Slack app was created with the correct manifest
3. Check that your Slack app is not restricted by workspace policies

Security & Permissions

What the Bot Can Access

• Messages where it’s mentioned
• Messages in threads it’s participating in
• DMs sent directly to the bot

What the Bot Cannot Access

• Messages in channels where it’s not invited
• Private messages between other users
• Files or messages it wasn’t mentioned in

Data Handling

• Conversations are processed through Chipp’s secure infrastructure
• Messages are not stored beyond what’s needed for context
• You can view conversation logs in your Chipp dashboard under Chats

Using with MCP

You can manage Slack deployments programmatically using the Chipp MCP Server.

Available Tools

Example Prompts

"Show me all Slack deployments for my support bot"
"Which Slack workspaces is my app connected to?"
"Disconnect the Slack deployment for my test workspace"

Workflow: Deployment Overview

You: Show me all Slack deployments for my apps

AI: [Calls list_slack_deployments]

App: Support Bot (ID 123)
- Slack Workspace: "Acme Corp"
  - Status: Connected
  - Channels: #support, #sales, #general
  - Last activity: 2 hours ago

App: FAQ Bot (ID 456)
- No Slack deployments configured