From 93e4b82ad6f9dda5ccd51c730b612ff5b17e156d Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 25 Sep 2025 21:41:38 +0000 Subject: [PATCH 1/7] Update integrations/support/slack.mdx --- integrations/support/slack.mdx | 118 +++++++++++++++++++++++++++++++++ 1 file changed, 118 insertions(+) create mode 100644 integrations/support/slack.mdx diff --git a/integrations/support/slack.mdx b/integrations/support/slack.mdx new file mode 100644 index 000000000..3d705c825 --- /dev/null +++ b/integrations/support/slack.mdx @@ -0,0 +1,118 @@ +--- +title: "Slack" +description: "Integrate with Slack for Writer Agent notifications and direct messaging" +icon: "slack" +--- + + + The Slack integration is available for Writer Agent users and enables direct messaging and automated notifications. + + +## About the Slack integration + +The Slack integration connects your Writer Agent system with Slack, enabling: + +- **Direct message handling** - Bot responds to direct messages from users +- **Automated notifications** - Writer Agent completion notifications sent to Slack +- **Real-time status updates** - Display of Writer Agent status in your dashboard +- **Formatted messaging** - Proper rendering of Slack-formatted content including links, mentions, and channels + +## Setting up the Slack integration + +### Prerequisites + +- Active Slack workspace with admin permissions +- Writer Agent system configured +- Access to Slack app configuration + +### OAuth scopes + +Configure your Slack app with the following OAuth scopes for full functionality: + +#### Bot token scopes +- `im:read` - Read DM channel information +- `im:write` - Send DM responses +- `im:history` - **Critical:** Receive DM message events +- `channels:history` - Receive channel message events +- `groups:history` - Receive private channel events +- `mpim:history` - Receive group DM events + +### Event subscriptions + +Configure these bot event subscriptions in your Slack app settings: + +- `message.im` - Direct message events +- `message.channels` - Public channel messages +- `message.groups` - Private channel messages +- `message.mpim` - Group DM messages +- `app_mention` - When the bot is mentioned + +### Installation steps + +1. **Create a Slack app** in your workspace or use an existing one +2. **Configure OAuth scopes** as listed above in your app's OAuth & Permissions section +3. **Set up event subscriptions** in your app's Event Subscriptions section +4. **Install the app** to your workspace to generate the bot token +5. **Configure your Writer Agent** system with the Slack app credentials + +## Using the Slack integration + +### Direct messaging + +Users can send direct messages to the Slack bot, which will: + +- Process the message through the Writer Agent system +- Respond with relevant information or actions +- Filter out bot messages to prevent loops +- Handle type-safe message processing + +### Notifications + +The integration automatically sends notifications for: + +- Writer Agent task completions +- Pull request updates and links +- System status changes +- Error notifications and alerts + +### Message formatting + +The integration properly handles Slack's message formatting: + +- **Bold text** using single asterisks (`*bold*`) +- **Links** formatted as `` +- **User mentions** as `<@USER_ID>` +- **Channel references** as `<#CHANNEL_ID>` + +### Dashboard integration + +The Slack integration displays in your dashboard: + +- Real-time bot status +- Writer Agent completion notifications +- Formatted pull request links +- Message history and analytics + +## Troubleshooting + +### Bot not responding to DMs + +Ensure you have configured the `im:history` scope - this is critical for receiving DM message events. + +### Missing notifications + +Verify that: +- Event subscriptions are properly configured +- The bot is installed in your workspace +- OAuth scopes include all required permissions + +### Formatting issues + +Check that your Slack app has the correct permissions to read and write messages in the channels where formatting issues occur. + +## Security considerations + +- Bot tokens should be stored securely and rotated regularly +- Limit bot permissions to only required scopes +- Monitor bot activity through Slack's audit logs +- Review message handling to ensure sensitive information is protected \ No newline at end of file From 8ec75136b7ba736649b8debd0f311f213e1a7586 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 25 Sep 2025 21:42:24 +0000 Subject: [PATCH 2/7] Update integrations/support/overview.mdx --- integrations/support/overview.mdx | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/integrations/support/overview.mdx b/integrations/support/overview.mdx index 21892b0c1..3c8914772 100644 --- a/integrations/support/overview.mdx +++ b/integrations/support/overview.mdx @@ -4,6 +4,13 @@ description: "Integrate with a support widget" --- + + Date: Thu, 25 Sep 2025 21:42:37 +0000 Subject: [PATCH 3/7] Update docs.json --- docs.json | 1 + 1 file changed, 1 insertion(+) diff --git a/docs.json b/docs.json index f7fff9fba..f67d2fb84 100644 --- a/docs.json +++ b/docs.json @@ -216,6 +216,7 @@ "icon": "messages-square", "pages": [ "integrations/support/overview", + "integrations/support/slack", "integrations/support/intercom", "integrations/support/front" ] From d2dc933aeccd1d1b2c46109eec28acc292415029 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 25 Sep 2025 21:42:50 +0000 Subject: [PATCH 4/7] Update docs.json --- docs.json | 1 + 1 file changed, 1 insertion(+) diff --git a/docs.json b/docs.json index f67d2fb84..a9cc97002 100644 --- a/docs.json +++ b/docs.json @@ -484,6 +484,7 @@ "icon": "messages-square", "pages": [ "fr/integrations/support/overview", + "integrations/support/slack", "fr/integrations/support/intercom", "fr/integrations/support/front" ] From 6bb748d5ebd28b0c270d97350454475aa83d554c Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 25 Sep 2025 21:43:00 +0000 Subject: [PATCH 5/7] Update docs.json --- docs.json | 1 + 1 file changed, 1 insertion(+) diff --git a/docs.json b/docs.json index a9cc97002..5e379c457 100644 --- a/docs.json +++ b/docs.json @@ -752,6 +752,7 @@ "icon": "messages-square", "pages": [ "es/integrations/support/overview", + "integrations/support/slack", "es/integrations/support/intercom", "es/integrations/support/front" ] From a8f16373df8626e453c3af93a5d122caa475c168 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 25 Sep 2025 21:43:11 +0000 Subject: [PATCH 6/7] Update docs.json --- docs.json | 1 + 1 file changed, 1 insertion(+) diff --git a/docs.json b/docs.json index 5e379c457..62bd33d19 100644 --- a/docs.json +++ b/docs.json @@ -1020,6 +1020,7 @@ "icon": "messages-square", "pages": [ "zh/integrations/support/overview", + "integrations/support/slack", "zh/integrations/support/intercom", "zh/integrations/support/front" ] From 8033f554cbab97a624606ca2c6ba884fca3c36c3 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 25 Sep 2025 21:45:39 +0000 Subject: [PATCH 7/7] Update changelog.mdx --- changelog.mdx | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/changelog.mdx b/changelog.mdx index 92d56b10e..2cec2c5b4 100644 --- a/changelog.mdx +++ b/changelog.mdx @@ -5,6 +5,21 @@ rss: true noindex: true --- + + +## Major release: Slack bot integration + +- **Major enhancement**: Comprehensive Slack bot integration for Writer Agent system with direct messaging and automated notifications +- Bot responds to direct messages (DMs), @mentions, and messages in designated channels +- Real-time display of Writer Agent completion notifications in dashboard +- Enhanced OAuth scopes including `im:read`, `im:write`, `im:history`, and channel history permissions +- Event subscriptions for `message.im`, `message.channels`, `message.groups`, `message.mpim`, and `app_mention` +- Proper message formatting for Slack-style text including bold text, links, user mentions, and channel references + +Learn more in our [Slack integration guide](/integrations/support/slack). + + + ## GitLab integration enhancements