# Slack

{% columns %}
{% column %}
Send AlmaBot alerts straight into Slack.

Route real-time security detections to a dedicated channel.

Alma connects to Slack using an **incoming webhook**.
{% endcolumn %}

{% column %}
![Slack integration overview](/files/mHjLoTmZR6WJDmtOEHlZ)
{% endcolumn %}
{% endcolumns %}

### Overview

AlmaBot sends real-time security alerts to a Slack channel you choose.

### How it works

1. You create a Slack App with **Incoming Webhooks** enabled.
2. Slack generates a **Webhook URL** for a channel.
3. You paste the Webhook URL into Alma’s Slack integration wizard.

### Prerequisites

* A Slack workspace where you can create apps.
* A Slack channel for AlmaBot alerts.
* Access to Alma with permission to manage integrations.

### Connect Slack in Alma

In Alma, go to **Integrations** and open **Slack**.

During setup, Alma will ask for a **Webhook URL**.

You’ll create that URL in Slack in the next section.

### Create the Slack incoming webhook

{% stepper %}
{% step %}

### Create a Slack App

1. Go to `https://api.slack.com/apps`.
2. Click **Create New App**.
3. Choose **From scratch**.
4. Name the app **AlmaBot**.
5. Pick the target Slack workspace.
6. Click **Create App**.
   {% endstep %}

{% step %}

### (Optional) Set an app icon

1. In the left menu, click **Basic Information**.
2. Scroll to **App Icon**.
3. Click **Add App Icon** and upload the AlmaBot image.
   {% endstep %}

{% step %}

### Enable Incoming Webhooks

1. In the left sidebar, go to **Features → Incoming Webhooks**.
2. Toggle **Activate Incoming Webhooks** to **On**.
   {% endstep %}

{% step %}

### Add a webhook to your channel

1. Click **Add New Webhook to Workspace**.
2. Select the channel that should receive AlmaBot alerts.
3. Click **Allow**.
4. Copy the generated **Webhook URL**.

{% hint style="warning" %}
Treat the Webhook URL like a secret. Anyone with the URL can post messages to that channel.
{% endhint %}
{% endstep %}
{% endstepper %}

### Finalize integration

1. Back in Alma, paste the **Webhook URL** into the Slack wizard.
2. Save the integration.
3. Send a test alert if the wizard offers it.

{% hint style="warning" %}
Avoid sharing the webhook URL in tickets or email.

If Alma support needs it, use a secure secret-sharing channel.
{% endhint %}

### Troubleshooting

* **No alerts arriving**
  * Confirm the webhook is attached to the correct channel.
  * Re-check the Webhook URL for truncation or extra spaces.
  * Generate a new webhook if the old one was rotated or revoked.
* **Wrong channel**
  * Create a new webhook for the right channel.
  * Update the Webhook URL in Alma.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.alma-security.com/integrations/slack.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.