diff options
Diffstat (limited to 'doc/user/project/integrations/gitlab_slack_application.md')
-rw-r--r-- | doc/user/project/integrations/gitlab_slack_application.md | 47 |
1 files changed, 2 insertions, 45 deletions
diff --git a/doc/user/project/integrations/gitlab_slack_application.md b/doc/user/project/integrations/gitlab_slack_application.md index abfd4243e07..0a42b363eb6 100644 --- a/doc/user/project/integrations/gitlab_slack_application.md +++ b/doc/user/project/integrations/gitlab_slack_application.md @@ -1,7 +1,7 @@ --- stage: Manage group: Import and Integrate -info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/product/ux/technical-writing/#assignments +info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://handbook.gitlab.com/handbook/product/ux/technical-writing/#assignments --- # GitLab for Slack app **(FREE ALL)** @@ -20,7 +20,7 @@ you run in Slack is run by your linked GitLab user. Prerequisites: - You must have the [appropriate permissions to add apps to your Slack workspace](https://slack.com/help/articles/202035138-Add-apps-to-your-Slack-workspace). -- On self-managed GitLab, an administrator must [enable the integration](../../admin_area/settings/slack_app.md). +- On self-managed GitLab, an administrator must [enable the integration](../../../administration/settings/slack_app.md). In GitLab 15.0 and later, the GitLab for Slack app uses [granular permissions](https://medium.com/slack-developer-blog/more-precision-less-restrictions-a3550006f9c3). @@ -170,46 +170,3 @@ The following events are available for Slack notifications: | **Deployment** | A deployment starts or finishes. | | **Alert** | A new, unique alert is recorded. | | [**Vulnerability**](../../application_security/vulnerabilities/index.md) | A new, unique vulnerability is recorded. | - -## Troubleshooting - -When configuring the GitLab for Slack app on GitLab.com, you might encounter the following issues. - -For self-managed GitLab, see [GitLab for Slack app administration](../../../administration/settings/slack_app.md#troubleshooting). - -### The app does not appear in the list of integrations - -The GitLab for Slack app might not appear in the list of integrations. To have the GitLab for Slack app on your self-managed instance, an administrator must [enable the integration](../../../administration/settings/slack_app.md). On GitLab.com, the GitLab for Slack app is available by default. - -The GitLab for Slack app is enabled at the project level only. Support for the app at the group and instance levels is proposed in [issue 391526](https://gitlab.com/gitlab-org/gitlab/-/issues/391526). - -### Project or alias not found - -Some Slack commands must have a project full path or alias and fail with the following error -if the project cannot be found: - -```plaintext -GitLab error: project or alias not found -``` - -As a workaround, ensure: - -- The project full path is correct. -- If using a [project alias](#create-a-project-alias-for-slash-commands), the alias is correct. -- The GitLab for Slack app is [enabled for the project](#from-project-integration-settings). - -### Slash commands return an error in Slack - -Slash commands might return `/gitlab failed with the error "dispatch_failed"` in Slack. -To resolve this issue, ensure an administrator has properly configured the [GitLab for Slack app settings](../../../administration/settings/slack_app.md) on your self-managed instance. - -### Notifications are not received to a channel - -If you're not receiving notifications to a Slack channel, ensure: - -- The channel name you configured is correct. -- If the channel is private, you've [added the GitLab for Slack app to the channel](#receive-notifications-to-a-private-channel). - -### The App Home does not display properly - -If the [App Home](https://api.slack.com/start/overview#app_home) does not display properly, ensure your [app is up to date](#update-the-gitlab-for-slack-app). |