gitlab-org--gitlab-foss/doc/integration/slack.md
Ewan Edwards e6e337088b Make all non-config/non-operational mentions of URL consistently
capitalized.

Make the plural version consistently "URLs".

Fix an instance where the article "the" before URL was missing.
2015-01-30 10:24:45 -08:00

1.2 KiB

Slack integration

On Slack

To enable Slack integration you must create an Incoming WebHooks integration on Slack;

  1. Sign in to Slack

  2. Select Configure Integrations from the dropdown next to your team name.

  3. Select the All Services tab

  4. Click Add next to Incoming Webhooks

  5. Pick Incoming WebHooks

  6. Choose the channel name you want to send notifications to

  7. Click Add Incoming WebHooks IntegrationAdd Integrations.

    • Optional step; You can change bot's name and avatar by clicking modifying the bot name or avatar under Integration Settings.
  8. Copy the Webhook URL, we'll need this later for GitLab.

On GitLab

After Slack is ready we need to setup GitLab. Here are the steps to achieve this.

  1. Sign in to GitLab

  2. Pick the repository you want.

  3. Navigate to Settings -> Services -> Slack

  4. Fill in your Slack details

    • Mark it as active
    • Paste in the webhook URL you got from Slack

Have fun :)

P.S. You can set "branch,pushed,Compare changes" as highlight words on your Slack profile settings, so that you can be aware of new commits when somebody pushes them.