docs(cpt): add tuto part one

Author: nerda-codes

tutorials/configure-slack-grafana-alerting/assets/scaleway-slack-alert-test.webp

@@ -0,0 +1,79 @@
+---
+meta:
+  title: How to configure Slack for Grafana alerting using a Webhook URL
+  description: Learn how to send your Grafana alert notifications to your Slack channels for more efficient monitoring.
+content:
+  h1: How to configure Slack for Grafana alerting using a Webhook URL
+  paragraph: Learn how to send your Grafana alert notifications to your Slack channels for more efficient monitoring.
+categories:
+  - observability
+dates:
+  validation: 2025-02-10
+  posted: 2025-02-10
+---
+
+This page shows you how to use the Slack `Incoming Webhooks` feature to send your Grafana alert notifications to a Slack channel.
+
+<Macro id="requirements" />
+
+ - A Scaleway account logged into the [console](https://console.scaleway.com)
+ - [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
+ - [Created](/cockpit/how-to/create-external-data-sources/) data sources
+ - [Enabled](/cockpit/how-to/enable-alert-manager/) the alert manager
+ - [Retrieved](/cockpit/how-to/retrieve-grafana-credentials/) your Grafana credentials
+ - [Configured](/cockpit/how-to/configure-alerts-for-scw-resources/) Grafana alerts for your resources
+ - Created a Slack workspace in which you want to receive the alert notifications
+
+## How to create a Slack app
+
+1. Refer to the [Slack documentation](https://api.slack.com/messaging/webhooks#create-app) and click **Create your Slack app**. You are redirected to a new page and a pop-up appears prompting you to either create your app **from a manifest** or **from scratch**.
+2. Click **From scratch**.
+3. Enter a name for your app. For the purpose of this documentation, we are naming the app `Grafana alerts`.
+4. Pick the workspace you want to receive alerts in from the drop-down.
+5. Click **Create App** to confirm. You app's **Basic information** page displays.
+6. Optionally, scroll down to **Display information** to customize the way your app will display in Slack. For example, you can:
+    - Add a short description in the **Short description** field.
+    - Add an icon
+    - Choose a background color
+    - Add a long description
+7. Click **Save Changes** Once you are done configuring your app.
+
+## How to activate incoming webhooks
+
+1. Click **Incoming Webhooks** under the **Features** section.
+2. Click the toggle icon to activate incoming webhooks. The **Webhook URLs for Your Workspace** section displays.
+3. Click **Add New Webhook to Workspace**. You are prompted to choose a Slack channel in which your Grafana alerts app will post.
+4. Click the drop-down and select one or all Slack channels.
+5. Click **Allow**.
+6. Click **Copy** under the **Webhook URL** section, as you will need it in the next steps.
+
+## How to create your Slack integration in Grafana
+
+### With the Scaleway Alerting alert manager
+
+1. [Access](/cockpit/how-to/access-grafana-and-managed-dashboards/) your Grafana dashboard.
+2. Click the **Toggle menu** icon next to **Home** in the top left corner of your screen.
+3. Click **Alerting**, then click **Contact points**.
+4. Choose the **Scaleway Alerting** alert manager in the drop-down next to the **Choose Alertmanager** field.
+5. Click **+ Add contact point**.
+6. Enter a contact point name.
+7. Select **Slack** from the **Integration** drop-down.
+8. In the **Channel** field, paste the name of the Slack channel or user to send notifications to.
+9. Click **Optional Slack settings** and paste your Slack app Webhook URL in the **Webhook URL** field.
+10. Click **Save contact point**.
+
+### With the Grafana alert manager
+
+1. [Access](/cockpit/how-to/access-grafana-and-managed-dashboards/) your Grafana dashboard.
+2. Click the **Toggle menu** icon next to **Home** in the top left corner of your screen.
+3. Click **Alerting**, then click **Contact points**.
+4. Choose the **Grafana** alert managet in the drop-down next to the **Choose Alertmanager** field.
+5. Click **+ Add contact point**.
+6. Enter a contact point name.
+7. Select **Slack** from the **Integration** drop-down.
+8. In the **Recipient** field, paste the name of the Slack channel or recipient to send notifications to.
+9. Paste your Slack app Webhook URL in the **Webhook URL** field.
+10. Optionally, configure your contact point as you wish with more customization.
+11. Optionally, click **Test** to send a test notification to the recipient you have configured in step 8.
+    <Lightbox src="scaleway-slack-alert-test.webp" alt="Grafana test alert notification on Slack" />
+12. Click **Save contact point**.