My Slack agent integration isn't working - it's not responding to messages or finding channels. How do I troubleshoot this?

If your Slack integration isn't working properly after following the basic setup, here are the most common issues and solutions:

1. Add the App in Slack First

Start by ensuring your app is properly added in Slack:

1. In Slack, look at the bottom of your left sidebar for the Apps section
2. Click Add apps
3. Search for and add your app
4. This enables you to chat directly with your agent in Slack

2. Configure Event Subscriptions (Critical for Listening)

Event subscriptions are necessary when you want your agent to listen to Slack messages, not just send them. If your agent isn't responding to messages, this is likely the issue:

1. In your Slack app settings, click Event Subscriptions in the left sidebar
2. Set the Request URL to: https://agent-service-339911427090.europe-north2.run.app/api/slack/webhook
3. Ensure the Enable Events toggle is switched ON
4. Under Subscribe to bot events section, click Add Bot User Event
5. Add at least these events:
   • app_mention - To receive mentions in channels
   • message.im - To receive direct messages

3. Understanding Response Behavior

With the basic configuration above, your agent will only respond to direct @mentions. If you want it to respond to general messages in channels, you need to add:

• message.groups (for private channels)
• message.channels (for public channels)

4. Invite the Agent to Channels

Your agent must be invited to channels where you want it to work:

1. In each channel, type /invite @YourAgentName
2. The agent can then receive and respond to messages in those channels

5. Verify Required Scopes

Ensure your app has these OAuth scopes in OAuth & Permissions:

• channels:read - To see public channels
• groups:read - To see private channels
• chat:write - To send messages
• app_mentions:read - To receive mentions

6. Reinstall if Needed

If you've added new scopes or made configuration changes:

1. Use the Install to Workspace button in your app settings
2. Update the Bot Token in your Abundly agent settings with the new token

Still Not Working?

If you've completed all these steps and your agent still isn't responding:

1. Test by sending a direct message to your agent
2. Try @mentioning your agent in a channel where it's been invited
3. Contact support@abundly.ai with details about which specific steps aren't working