Mattermost Gitlab Plugin Guide

Video Demonstration

Help your teams stay focused and productive with daily task summaries, real-time updates and notifications on new and closed merge requests, new and closed issues, and tag creation events.

You can also control which events trigger notifications beyond default events, including merges, issue comments, merge request comments, pipelines, pull reviews, and many more. - Mattermost supports both Software-as-a-Service (SaaS) and on-premises versions of GitLab.

Setup

Connect a GitLab account to Mattermost

Run the /gitlab connect slash account in any Mattermost channel to link your Mattermost account with your GitLab account.

Disconnect a GitLab account by running the /gitlab disconnect slash comamnd. Run the /gitlab me slash command to review which account is connected to GitLab.

Once connected, run the /gitlab help slash command to see what you can do.

Get started

Run the /gitlab todo slash command to get a list of todos, assigned issues, assigned merge requests and merge requests awaiting your review. Alternatively, use the options located in the left sidebar.

Run the /gitlab webhook slash command to have GitLab send events to Mattermost. For example: /gitlab webhook add group[/project]

Channel subscriptions

Collab-Tools offers channel subscriptions through webhooks that we believe offers a richer feature set. Please reach out to Collab Tools Support to setup channel subscriptions.

Run the /gitlab subscriptions list to review all of your subscriptions.

Run the /gitlab subscriptions add group[/project] [features] slash command to subscribe a Mattermost channel and receive posts for new merge requests, issues, or other features, from a GitLab project. To unsubscribe and stop receiving posts, run the /gitlab subscriptions delete group[/project] slash command.

For each project you want to receive notifications for or subscribe to, create a webhook in a channel where you want to watch events sent from GitLab by running the /gitlab webhook slash command. For example:/gitlab webhook add group[/project]

Update settings

Run the /gitlab settings [setting] [value] slash command to update your preferences for the integration:

• Turn personal notifications on or off.
• Turn reminders on or off when you connect initially each day.

Get help

Please reach out to Collab Tools Support if you experience any issues.