Identity
- SSO
- People Data
- Roles
Assistant
- Configuration
- Features
- Apps
- Actions
- Data Analysis
- Slackbot
- Glean Assist
Knowledge
- Announcements
- Answers
- People & Teams
Management
- Alerts
- Glean Apps
- Customization
Developer
Troubleshooting Slackbot
How to triage and fix common issues with Glean’s Slackbot
Learn more about what Glean in Slack does and how to set it up here.
There are many possible reasons.
1. Glean may not be set up properly in Slack.
- Is Gleanbot enabled either across your workspace, or in the specific Slack channel where you’re noticing the issue?
-
Within Slack, is the Glean app added to the channel? See Slack’s instructions for how to add apps to a channel.
-
Is the channel an external channel? Gleanbot only responds in internal channels, in order to prevent private information from being unintentionally shared.
-
Is the Glean app set up with the correct scopes? The required scopes are listed in Glean Admin Workspace Settings > Apps > Slack > Setup.
2. The person who asked the question may not have access to Glean Assistant.
Glean only responds in Slack to users who have logged into Glean and have Assistant access.
3. Glean may not have a confident answer to the question.
By default, Glean only responds automatically when specific conditions are met, including:
- The message is a question, and it’s posted at the channel level and not within a thread
- Glean Assistant is able to generate a high confidence response, using the permission set of the person who posted the question
You can try asking the same question and tagging @Glean directly, or configuring Glean to respond to more questions by typing /glean configure
in the channel.
4. Glean has hit a rate limit.
If Glean has received a high rate of questions, it may not be able to respond. Try asking the question again later.
5. The question is in a thread.
Glean currently only automatically responds to channel-level messages in order to avoid the potential noise caused by jumping into a conversation that is already happening between people in a thread.
It takes up to a minute for Glean to generate a full answer to a question and evaluate whether it’s worth showing.
Additionally, the Slackbot is configured to only respond to questions if it has a high degree of confidence that it can answer the question. This helps prevent spam in your Slack channels from the Slackbot attempting to answer everything.
-
Be sure to add Glean to each of the Slack channels you wish it to work in. See Slack’s instructions for how to add apps to a channel.
-
If emojis still don’t show up, ask your Slack admin to check if
reactions:write
is added as a Bot Token Scope under https://api.slack.com/apps > Glean > OAuth & Permissions. If not, that scope needs to be added and the app needs to be republished.
Ask them to go to Your Settings in Glean and toggle off “Show suggestions for questions asked in Slack.”
When there are issues with Gleanbot’s setup, Glean will send an alert. These alerts indicate issues which cause either some or all of bot functionality to break. These could be caused by a range of issues including missing or invalid tokens, missing scopes etc.
To fix the setup issues, follow these steps:
-
Open Glean’s admin page > Setup > Apps, and navigate to the app you’ve been alerted about. Alternatively, you can directly navigate to the following URL by plugging in the datasource you’ve been alerted about: app.glean.com/admin/setup/apps/slack/<datasource>
- If the alert refers to a Slack instance that you are no longer using, navigate to the Gleanbot tab and disable all the toggles in order to prevent receiving alerts in the future
-
Navigate to the Setup tab and redo the setup steps
-
Navigate to the Gleanbot tab, and toggle on the elements of Gleanbot behavior you’d like enabled. If a particular toggle is already enabled, switch it off and then on again.
-
If while toggling Gleanbot tabs, an error is shown referring to
missing_scopes
, follow the steps at [External] Gleanbot Missing Scope to fix the issue.
If you need further assistance, please contact Glean Support.
Was this page helpful?