Enable announcements from Slack
Glean lets you create announcements directly from Slack messages. This capability requires proper configuration of the Gleanbot Slack application. This guide provides step-by-step instructions for administrators to enable this functionality.
Prerequisites
This feature requires two roles to complete each task: one to set up the integration, and another to create announcements once it's live. Confirm the following access requirements before you begin.
| Required roles | Task |
|---|---|
| Admin or Super Admin | Configure the Gleanbot message shortcut. |
| Admin, Super Admin, or Announcements Moderator | Create an announcement from a Slack message using the shortcut. |
| Slack workspace admin | Edit the Glean Slack app in your organization's Slack workspace. |
To assign these roles or review what each one can do, see User roles.
Configure announcements from Slack
Access Slack API console
First, navigate to the Slack API console and select Glean from the drop-down menu. This will take you to the configuration page for your Glean Slack integration.
Navigate to shortcuts settings
In the left navigation bar, locate and select Interactivity & Shortcuts. This section allows you to configure how users can interact with Gleanbot through Slack's interface.
Create message shortcut
Within the Shortcuts section, create a new Message Shortcut. Ensure you select the option for the shortcut to appear On Messages, as this enables users to create announcements from existing Slack messages.
Configure shortcut details
Configure the shortcut with the following specific parameters:
| Field | Required Value |
|---|---|
| Name | Create announcement in |
| Description | Creates an announcement in Glean |
| Callback ID | create_announcement |
The Callback ID must be exactly create_announcement for the integration to function properly.
Use the shortcut
After configuration, users with permission to create announcements can do so by following these steps:
- Click the three-dot menu (⋮) on any Slack message
- Select Create announcement in Glean from the menu options
If users don't see the shortcut immediately in the context menu, they should select More message shortcuts... to access it. The shortcut will appear in this expanded menu.
Verification
After completing the configuration, it's recommended to verify the setup by:
- Testing the shortcut on a test message
- Confirming the announcement appears correctly in Glean
- Checking that all team members who need access can see and use the shortcut
See also
- How Announcements work - The end-user guide to composing, targeting, scheduling, and publishing announcements in Glean. Share this with the people who will create announcements from the Slack shortcut you set up here.
- Announcements - Admin overview: grant users access to create announcements and troubleshoot Announcement Insights.