Connect Slack to the Dchat inbox

Before you start

• Difficulty: Hard
• Time: 30 minutes
• You need: Permission to create and install a Slack app in your workspace
• You need: Admin or owner access to your Dchat workspace

Steps

1. Create a Slack app

   At api.slack.com/apps, create an app for your workspace. Under OAuth & Permissions, add the bot scope chat:write and the history scopes for the conversations you want (channels:history, groups:history, im:history), then install the app and copy the Bot User OAuth Token (xoxb-…).

2. Collect the signing secret and team ID

   Copy the Signing Secret from the app's Basic Information page. Your Team ID starts with T.

3. Add the channel in Dchat

   In Dchat, open Settings → Channels and choose + Add channel. Pick "Slack", enter the Team ID, and paste the credentials.

   { "SigningSecret": "...", "BotToken": "xoxb-..." }

4. Turn on Event Subscriptions

   In the Slack app, enable Event Subscriptions with the request URL below and subscribe to the bot events message.channels, message.groups and message.im. Then invite the app to the channels it should listen in.

   https://api.dchat.com/api/inbound/slack/events

What goes in each field

• SigningSecret: From the app's Basic Information page. Events without a valid signature are rejected.
• BotToken: The Bot User OAuth Token, starting xoxb-; used to post replies.

Good to know

• Slack messages go to your team unless you switch on "AI replies first" for the channel; with it on (and workspace AI on), the AI answers first.
• Replies are posted into the channel, not in a thread.
• Your workspace needs at least one enabled site; new workspaces have one already. Messages are dropped while every site is switched off.
• Credentials are encrypted when you save them and are never shown again. To change one, paste the full credentials again.