summaryrefslogtreecommitdiff
path: root/doc/integration/slack.md
blob: 8dc6c4a24bb10d9ab75c63be657f3ba748d96930 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
# Slack integration

## On Slack

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

1.  [Sign in to Slack](https://slack.com/signin)

1.  Visit [Incoming WebHooks](https://my.slack.com/services/new/incoming-webhook/)

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

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.


## On GitLab

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

1.  Sign in to GitLab

1.  Pick the repository you want.

1.  Navigate to Settings -> Services -> Slack

1. Pick the triggers you want to activate and respective channel(#general by default).

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
    - Mark it as active

1. Save your settings

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.*