gitlab-org--gitlab-foss/doc/integration/slack.md

50 lines
1.5 KiB
Markdown
Raw Normal View History

2014-04-24 18:48:22 -04:00
# Slack integration
2014-04-13 20:26:48 -04:00
2014-04-24 18:48:22 -04:00
## On Slack
2014-04-13 20:26:48 -04:00
To enable Slack integration you must create an Incoming WebHooks integration on Slack;
1. [Sign in to Slack](https://slack.com/signin)
2016-01-25 08:06:09 -05:00
1. Select **Apps & Custom Integrations** from the dropdown next to your team name.
2016-01-25 08:06:09 -05:00
1. Click the **Configure** link (right-upper corner).
2016-01-25 08:06:09 -05:00
1. Select the **Custom integrations** tab.
2016-01-25 08:06:09 -05:00
1. Click the **Incoming WebHooks** row.
2014-04-13 20:26:48 -04:00
2016-01-25 08:06:09 -05:00
1. Click the **Add configuration** button.
1. Choose the channel name you want to send notifications to.
2015-04-21 13:25:37 -04:00
1. Click **Add Incoming WebHooks Integration**
- Optional step; You can change bot's name and avatar by clicking modifying the bot name or avatar under **Integration Settings**.
1. Copy the **Webhook URL**, we'll need this later for GitLab.
2014-04-13 20:26:48 -04:00
2014-04-24 18:48:22 -04:00
## On GitLab
2014-04-13 20:26:48 -04:00
After Slack is ready we need to setup GitLab. Here are the steps to achieve this.
2014-04-24 18:48:22 -04:00
1. Sign in to GitLab
1. Pick the repository you want.
1. Navigate to Settings -> Services -> Slack
2015-04-21 13:25:37 -04:00
1. Pick the triggers you want to activate
2014-04-13 20:26:48 -04:00
2015-04-21 13:25:37 -04:00
1. Fill in your Slack details
- Webhook: Paste the Webhook URL from the step above
- Username: Fill this in if you want to change the username of the bot
- Channel: Fill this in if you want to change the channel where the messages will be posted
- Mark it as active
2015-04-21 13:25:37 -04:00
1. Save your settings
2014-04-13 20:26:48 -04:00
Have fun :)
2014-04-24 18:48:22 -04:00
*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.*