How to Connect Slack to Ekuri

What You Need

• An active Ekuri VPS (deploy one from your dashboard)
• A Slack workspace where you have permission to install apps

By the end of this guide, you'll be chatting with your Ekuri AI assistant directly in Slack — via DMs or @mentions in any channel.

Step 1 — Create a Slack App

1. Go to api.slack.com/apps
2. Click Create New App
3. Choose From scratch
4. Enter an app name (e.g. Ekuri) and select your workspace
5. Click Create App

Step 2 — Enable Socket Mode

Socket Mode lets your bot receive messages in real time without exposing a public URL.

1. In the left sidebar, click Socket Mode
2. Toggle Enable Socket Mode to ON
3. You'll be prompted to create an App-Level Token:
   • Name it ekuri
   • Add the scope connections:write
   • Click Generate
4. Copy the token that starts with xapp- — this is your App Token

Keep this token handy — you'll need it in the final step.

Step 3 — Add Bot Permissions

1. In the left sidebar, click OAuth & Permissions
2. Scroll down to Bot Token Scopes
3. Click Add an OAuth Scope and add each of these:
   • chat:write — lets the bot send messages
   • app_mentions:read — lets the bot see when it's @mentioned
   • im:history — lets the bot read DM history
   • im:read — lets the bot see DMs
   • im:write — lets the bot send DMs

Once all five scopes are added, it should look like this:

Step 4 — Install to Your Workspace

1. Scroll back up on the same OAuth & Permissions page
2. Click Install to Workspace
3. Review the permissions and click Allow

4. Copy the Bot User OAuth Token that starts with xoxb- — this is your Bot Token

Step 5 — Enable Events

This tells Slack to forward messages to your bot.

1. In the left sidebar, click Event Subscriptions
2. Toggle Enable Events to ON
3. Expand Subscribe to bot events
4. Click Add Bot User Event and add:
   • message.im — triggers when someone DMs the bot
   • app_mention — triggers when someone @mentions the bot
5. Click Save Changes

Step 6 — Connect in Ekuri Dashboard

1. Open your Ekuri dashboard
2. Find the Slack section under Connections
3. Paste your two tokens:
   • Bot Token: the xoxb-... token from Step 4
   • App Token: the xapp-... token from Step 2
4. Click Connect

The gateway will restart automatically. After a few seconds, open Slack and send a message — your Ekuri AI assistant should respond.

If your bot doesn't respond in a channel, make sure you've invited it first — type /invite @Ekuri in the channel. You can refer to our setup video above to see how it's done.

Troubleshooting

Bot doesn't respond to DMs? Make sure you added message.im in Event Subscriptions (Step 5) and that Socket Mode is enabled (Step 2).

Bot doesn't respond to @mentions in channels? Make sure you added app_mention in Event Subscriptions (Step 5). You also need to invite the bot to the channel first — type /invite @Ekuri in the channel.

"missing_scope" error? Go back to OAuth & Permissions and verify all 5 scopes from Step 3 are added. After adding scopes, you may need to reinstall the app (Step 4).