# Slack

Although a turnkey integration is available for [email](https://docs.rafay.co/integrations/monitoring/notifications/) based notifications, organizations may wish to send notifications to other platforms in use internally. This recipe documents how organizations can customize the "Alert Manager" system addon configuration and send the alerts to [Slack](https://www.slack.com/).

---

## Configure Slack  
If you want to receive the notifications via Slack, you will need an existing Slack workspace or create a new one for testing [here](https://slack.com/create).

To setup the alerting to your Slack workspace, you will need a Slack API URL.

- Go to Slack > Administration > Manage apps
- Go to "Custom Integrations"
- Search for "Incoming Webhooks" in App Directory and select the integrations

- Add it to your Slack workspace

- Then configure the channel where you would like to receive the notifications
- Confirm the configuration and click Add Incoming Webhooks Integration

- Copy the Webhook URL (Slack API URL) for the integration to use in the next steps

---

## Configure Alert Manager Addon  
Follow the below steps to create a customized "Alert Manager" System Addon to send notifications to the Slack channel from the prior step.

- Navigate to Infrastructure -> Addons
- Create a new addon using "Customize System Addon" option.

- Create a new version for the custom system Alert Manager addon.

- Download the default configuration manifest.

- Modify the "global" section of the downloaded configuration to add the Slack API URL that you copied from the "Configure Slack Integration" steps:

```
global:
  resolve_timeout: 5m
  slack_api_url: https://hooks.slack.com/services/T01D6D4xxxxxxxxlhvzNg
```

- Now, add the custom receiver for Slack notifications to the "receivers" section of the configuration:

```
receivers:
- name: default-receiver
- name: rafay-webhook
  webhook_configs:
  - http_config:
      tls_config:
        ca_file: /etc/config/certs/ca.crt
        cert_file: /etc/config/certs/client.crt
        insecure_skip_verify: true
        key_file: /etc/config/certs/client.key
        server_name: '{{{ .V2EventFrameworkFQDN }}}'
    url: https://{{{ .V2EventFrameworkFQDN }}}/event/v1/alert/raise
- name: myalerts
  slack_configs:
  - channel: '#alert'
    send_resolved: true
    title_link: nil
```

- Optionally, you can further customize the "slack_configs" to make the notifications easier to read. An example is provided [here](https://prometheus.io/docs/alerting/latest/notification_examples/#notification-template-examples).

```
- name: myalerts
  slack_configs:
  - channel: '#alert'
    send_resolved: true
    text: |-
      {{ range .Alerts -}}
      *Alert:* {{ .Annotations.title }}{{ if .Labels.severity }} - `{{ .Labels.severity }}`{{ end }}
      *Description:* {{ .Annotations.description }}
      *Details:*
        {{ range .Labels.SortedPairs }} • *{{ .Name }}:* `{{ .Value }}`
        {{ end }}
      {{ end }}
    title: |-
      [{{ .Status | toUpper }}{{ if eq .Status "firing" }}:{{ .Alerts.Firing | len }}{{ end }}] {{ .CommonLabels.alertname }} for {{ .CommonLabels.job }}
      {{- if gt (len .CommonLabels) (len .GroupLabels) -}}
        {{