gitlab-org--gitlab-foss/doc/user/project/integrations/microsoft_teams.md

2.4 KiB

stage group info
Create Ecosystem To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments

Microsoft Teams service (FREE)

You can integrate Microsoft Teams with GitLab, and display notifications about GitLab projects in Microsoft Teams. To integrate the services, you must:

  1. Configure Microsoft Teams to enable a webhook to listen for changes.
  2. Configure your GitLab project to push notifications to the Microsoft Teams webhook.

Configure Microsoft Teams

To configure Microsoft Teams to listen for notifications from GitLab:

  1. In Microsoft Teams, search for "incoming webhook" in the search bar, and select the Incoming Webhook item:

    Select Incoming Webhook

  2. Select Add to a team.

  3. Select the team and channel you want to add the integration to.

  4. Add a name for the webhook. The name is displayed next to every message that comes in through the webhook.

  5. Copy the webhook URL, as you need it to configure GitLab.

Configure your GitLab project

After you configure Microsoft Teams to receive notifications, you must configure GitLab to send the notifications:

  1. Sign in to GitLab as a user with Administrator and go to your project's page.
  2. Go to Settings > Integrations and select Microsoft Teams Notification.
  3. Select Active to enable the integration.
  4. Select the check box next to each Trigger to enable:
    • Push
    • Issue
    • Confidential issue
    • Merge request
    • Note
    • Confidential note
    • Tag push
    • Pipeline - If you enable this trigger, you can also select Notify only broken pipelines to be notified only about failed pipelines.
    • Wiki page
  5. In Webhook, paste the URL you copied when you configured Microsoft Teams.
  6. (Optional) If you enabled the pipeline trigger, you can select the Notify only broken pipelines check box to push notifications only when pipelines break.
  7. Select the branches you want to send notifications for.
  8. Click Save changes.

Resources