Notifications through Slack Channel or Webhook

Set up notification alerts for your Web and Feature experiments or for individual feature flags. There are two ways to receive notifications for different types of events:

• Email / Slack direct messages: Sends notifications for Experiments (Web and Feature) about to start or end, if a sample-ration mismatch (SRM) is detected, or a statsig for a recommendation metric reached.
• Slack channel notifications / webhooks: Sends notifications for any changes to an active flag configuration that generates a new history version or when flags are activated or deactivated.

This page discusses setting up and maintaining notification alerts through Slack channels and webhooks. Only notifications created through the Experiment Alerts function are sent in this way.

All other experiment alerts are sent either through email or Slack direct message. For more information on these other types of notification, go to Account Settings Notifications or Integrate Slack to know how to manage your Slack workspace integration.

To connect a Slack workspace to your experiment notifications

You only need to connect your Slack workspace to your experiment notifications once.

1. Go to Experiment and then click Experiments.
   You can also access alerts by going to Settings > Organization settings > Experiment and then clicking Add alert.
2. Click Alerts in the top right.
3. Click Connect To Slack.
4. Click Allow to confirm that you want to connect Amplitude to Slack.

Experiment activities that generate alerts

You can specify if you want to receive alerts for the following experiment activities:

• Flags created, updated, or deleted

Setting up an alert

After you have connected your Slack organization to Amplitude, you can create notifications for your experiments.

If you want to send notifications through webhooks, you must provide the URL and valid signing key. You can specify your webhook at the same time that you create the alert.

Webhook schema:

{
  "flagId":"{flagId}",
  "flagName":"{flagName}",
  "scope":"{scope}",
  "scopeParam":"{scopeParam}",
  "scopeParamName":"{scopeParamName}",
  "action":"{action}",
  "modifiedBy":"{modifiedBy}",
  "flag":"{flag}",
  "oldFlag":"{oldFlag}"
  }

To set up an alert

1. Go to Experiment and then click Experiments.
   You can also access alerts by going to Settings > Organization settings > Experiment and then clicking Add alert.
2. Click Alerts in the top right.
3. Specify the project that you want.
4. Set the scope. You can select one of:
   • All In the Project: Receive notifications for all experiments in the project.
   • By Deployment: Receive notifications for all experiments in your entire deployment.
     If you are receiving alerts by deployment, you must specify the deployment by API key. Go to Deployments for more information.
   • By Tag: Receive notifications only for experiments and flags tagged with specific labels.
5. Choose how you want to receive your notifications:
   • If you're using Slack, click the dropdown to choose the channel for your alerts.
   • If you're using a Webhook, enter the URL and your signing key.
6. Name your alert.
7. Click Create Alert.