Mattermost incoming webhooks

Overview

This topic explains how to use the LaunchDarkly Mattermost incoming webhooks integration.

The Mattermost incoming webhooks integration sends you alerts when the LaunchDarkly resources you care about, such as feature flags, projects, and account members, change. These notifications appear in your Mattermost channel.

Prerequisites

To use this integration, you must have:

• A Mattermost workspace with permission to create incoming webhooks
• A LaunchDarkly account with permission to create integrations

Set up an incoming webhook in Mattermost

To add LaunchDarkly to a Mattermost workspace, you first configure an incoming webhook in Mattermost, then add the webhook URL to LaunchDarkly.

Follow these steps:

1. Log into your Mattermost workspace.
2. From the main menu, navigate to Integrations > Incoming Webhooks.
3. Click Add Incoming Webhook.
4. Fill in the display name (for example, “LaunchDarkly”), an optional description, and select the channel you want notifications delivered to.
5. Click Save.
6. Copy the provided webhook URL to your clipboard. You will need it in the next procedure.

To learn more about creating incoming webhooks in Mattermost, read Mattermost’s incoming webhooks documentation.

Connect LaunchDarkly to Mattermost

To configure LaunchDarkly to connect with the Mattermost webhook:

1. In LaunchDarkly, click the gear icon in the left sidenav to view Organization settings.
2. Click Integrations and find “Mattermost incoming webhooks.”
3. Click Add integration. The “Create Mattermost incoming webhooks configuration” panel appears.
4. Paste your Incoming webhook URL into the field.
5. Set any filters for sending notifications to Mattermost by configuring a policy. LaunchDarkly sends all flag change events in the production environment to Mattermost by default. To learn more about creating a policy filter, read Add a policy filter.
6. Click Save configuration.

You are now notified in your Mattermost channel when someone updates a flag.

Add a policy filter

LaunchDarkly sends all flag change events in the production environment to a webhook by default. To customize the events LaunchDarkly sends to your Mattermost channel, use the policy editor in the webhook creation panel.

For example, if you want to receive an event only when a change is made to one of your production feature flags, you can add the following policy to the webhook integration:

1
[
2
  {
3
    "effect": "allow",
4
    "actions": ["*"],
5
    "resources": ["proj/*:env/production:flag/*"]
6
  }
7
]

To learn more, read Example roles and policies.

Disable a Mattermost incoming webhook

To temporarily disable a Mattermost incoming webhook:

1. In LaunchDarkly, navigate to the Integrations page and find “Mattermost incoming webhooks.”
2. Click the expand arrow to display all of the configured webhooks.
3. Click the pencil icon next to the webhook you want to disable. The “Edit Mattermost incoming webhooks configuration” panel appears.
4. Toggle the switch Off.