> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nemu.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Nemu AI Reports in Slack

> Get the reports written by Nemu AI straight into Slack channels and direct messages

![Nemu AI report posted in Slack by the Nemu app](https://mintcdn.com/nemu/WQSSk5EfzGv4hJoq/assets/pages/ia/slack/1.jpg?fit=max\&auto=format\&n=WQSSk5EfzGv4hJoq\&q=85\&s=3a9eb5183555ccfaafe6b2952632effa)

## What is it?

[AI reports](https://docs.nemu.com.br/en/ai/iareports.md) can be delivered through **Slack** as well as by email. Nemu AI generates the analysis at the scheduled time and the **Nemu** app posts the report to the channels and direct messages you choose.

Your team follows the numbers where it already talks, without depending on the inbox.

## How it works

```mermaid theme={null}
flowchart LR
    A[An admin connects Slack to the dashboard] --> B[You create the report and pick channels or people]
    B --> C[At the scheduled time, Nemu AI generates the analysis]
    C --> D[The Nemu app posts it to Slack]
```

* The connection is made **once per dashboard**, by an admin. Each dashboard is linked to one Slack workspace.
* Once connected, **anyone who can create or edit reports** on the dashboard picks where each report goes.
* Each report uses **one delivery channel**: email or Slack.

## Prerequisites

* **Admin** access to the Nemu dashboard, or a permission group that can **create integrations**. Only needed to connect Slack.
* Permission to **install apps** in the Slack workspace. If your workspace requires app approval, a Slack admin needs to approve Nemu.

## Setting up

**1. Open the Nemu AI integrations**

In the side menu, open **Nemu AI** and click **Settings**. The **Integrations** screen opens right away.

![Side menu with Nemu AI > Settings highlighted](https://mintcdn.com/nemu/WQSSk5EfzGv4hJoq/assets/pages/ia/slack/2.jpg?fit=max\&auto=format\&n=WQSSk5EfzGv4hJoq\&q=85\&s=b0f521014e68bf5dcd42269cb61ff4ec)

**2. Connect Slack**

On the **Slack** card, under **Messaging**, click **Connect**.

![Slack card in Integrations with the Connect button](https://mintcdn.com/nemu/WQSSk5EfzGv4hJoq/assets/pages/ia/slack/3.jpg?fit=max\&auto=format\&n=WQSSk5EfzGv4hJoq\&q=85\&s=2f6fafe605b5159b96ef84dd9454b2ff)

A window shows what Nemu will be able to do in Slack:

* view public channels;
* join public channels;
* send messages as Nemu.

Click **Authorize in Slack**.

![Connect Slack window with the permissions and the Authorize in Slack button](https://mintcdn.com/nemu/WQSSk5EfzGv4hJoq/assets/pages/ia/slack/4.jpg?fit=max\&auto=format\&n=WQSSk5EfzGv4hJoq\&q=85\&s=fcf8dcca6b2182e768d68424912bd761)

**3. Authorize in Slack**

A Slack popup opens. Check that the **workspace** in the top right corner is the right one and click **Allow**.

![Slack authorization screen with the workspace and the Allow button](https://mintcdn.com/nemu/WQSSk5EfzGv4hJoq/assets/pages/ia/slack/5.png?fit=max\&auto=format\&n=WQSSk5EfzGv4hJoq\&q=85\&s=4e0cd72cc14e3a76cfd6a76fc9c1cc18)

> [!NOTE]
>
> If the popup doesn't open, allow popups for Nemu in your browser and click
> **Connect** again.

**4. Check the connection**

The popup closes by itself and the card shows **Connected to** followed by your workspace name.

![Slack card showing Connected to and the Disconnect button](https://mintcdn.com/nemu/WQSSk5EfzGv4hJoq/assets/pages/ia/slack/6.jpg?fit=max\&auto=format\&n=WQSSk5EfzGv4hJoq\&q=85\&s=df1f3455b3f97cc98d8045ca323ccd6a)

## Sending a report through Slack

Create the report as usual, as in [Nemu AI Reports](https://docs.nemu.com.br/en/ai/iareports.md). The difference is in the last step, **Recipients and Observations**.

**1. Choose Slack as the delivery channel**

Under **Delivery channel**, select **Slack**.

![Recipients and Observations step with Slack selected as the delivery channel](https://mintcdn.com/nemu/WQSSk5EfzGv4hJoq/assets/pages/ia/slack/7.jpg?fit=max\&auto=format\&n=WQSSk5EfzGv4hJoq\&q=85\&s=a8fd155f3cea06eadcc93ff8242f6fdd)

**2. Select the targets**

Under **Slack targets**, open the list and pick one or more items. Use the search to find them by name.

* **Channels**: the report is posted to the channel.
* **Users**: the person gets the report as a direct message from the Nemu app.

  ![Slack targets list open with two channels selected](https://mintcdn.com/nemu/WQSSk5EfzGv4hJoq/assets/pages/ia/slack/8.jpg?fit=max\&auto=format\&n=WQSSk5EfzGv4hJoq\&q=85\&s=a009705636a1ef4464551341577043b3)

**3. Save the report**

Click **Save report**. If you picked a public channel, the Nemu app joins it automatically. The same happens when you edit the targets later.

> [!NOTE]
>
> If you see **"Slack is not connected to this dashboard."**, click **Connect
> Slack** to go to the integrations. If you are not an admin, ask a dashboard
> admin to connect it.
>
> ![Slack is not connected to this dashboard notice with the Connect Slack link](https://mintcdn.com/nemu/WQSSk5EfzGv4hJoq/assets/pages/ia/slack/9.jpg?fit=max\&auto=format\&n=WQSSk5EfzGv4hJoq\&q=85\&s=a764ca95b7ecfe46ea2791952afed71b)

### Private channels

The Nemu app can only see a private channel after it is invited. In the private channel, send:

```
/invite @Nemu
```

Then open the target list again: the private channel shows up under **Channels**.

![/invite @Nemu command in a private channel and the Slack confirmation](https://mintcdn.com/nemu/WQSSk5EfzGv4hJoq/assets/pages/ia/slack/10.png?fit=max\&auto=format\&n=WQSSk5EfzGv4hJoq\&q=85\&s=f1e894998e22c1d92ed0c4a2ffe2758a)

## What arrives in Slack

Each delivery is a new analysis, built from the dashboard's latest data, with the same content as the email:

* the report **title** and the **dashboard name**;
* the **analysis** written by Nemu AI, formatted for Slack;
* the report **observations**, if any.

Long reports are split into more than one message. The following messages carry the title with **(continued)**.

![Report received as a direct message from the Nemu app](https://mintcdn.com/nemu/WQSSk5EfzGv4hJoq/assets/pages/ia/slack/1.jpg?fit=max\&auto=format\&n=WQSSk5EfzGv4hJoq\&q=85\&s=3a9eb5183555ccfaafe6b2952632effa)

## Managing

### Changing targets

In the report list, open the report and edit its **recipients**. You can change the Slack channels and users, or switch delivery back to email.

![Edit recipients window with Slack and the selected channels](https://mintcdn.com/nemu/WQSSk5EfzGv4hJoq/assets/pages/ia/slack/12.jpg?fit=max\&auto=format\&n=WQSSk5EfzGv4hJoq\&q=85\&s=0b40816933c11823260e9aa52208ec1f)

### Disconnecting Slack

In **Nemu AI > Settings > Integrations**, click **Disconnect** on the Slack card. The button is only enabled for admins, or for groups allowed to **delete integrations**.

Before you confirm, Nemu shows how many active reports use Slack. When you click **Pause reports and disconnect**, those reports are **paused**.

![Disconnect Slack confirmation listing the report that will be paused](https://mintcdn.com/nemu/WQSSk5EfzGv4hJoq/assets/pages/ia/slack/13.jpg?fit=max\&auto=format\&n=WQSSk5EfzGv4hJoq\&q=85\&s=943b837b8ded4aa36eacb6ef9677900f)

> [!WARNING]
>
> Reconnecting Slack does **not** resume the paused reports automatically.
> After reconnecting, reactivate each report in the list.

## Permissions

| Action | Who can |
| - | - |
| Connect Slack to the dashboard | Admins, or groups allowed to **create integrations** |
| Disconnect Slack | Admins, or groups allowed to **delete integrations** |
| Pick channels and users for a report | Anyone who can **create or edit reports** on the dashboard |

## Troubleshooting

> [accordion] The private channel is not in the list
>
> Invite the app to the channel with `/invite @Nemu` and open the target list
> again. Private channels only show up after the invite.

> [accordion] "Couldn't load Slack channels and users" shows up
>
> Click **Try again**. If the error persists, check in **Integrations** that
> Slack is still connected. If Nemu was removed from the workspace in Slack,
> disconnect and connect again.

> [accordion] A target shows as "Unavailable Slack target"
>
> The channel was archived, the person left the workspace, or the app lost
> access to the channel. Remove that target and pick another one.

> [accordion] The report reached some channels but not others
>
> Each target is sent separately: if one channel fails, the others still get
> the report. Check that the Nemu app is still in the channel that missed it.
> If someone ran `/remove @Nemu` in a private channel, invite the app again.

> [accordion] The Connect button is disabled
>
> Only dashboard admins, or groups allowed to create integrations, can
> connect Slack. Ask an admin.

> [accordion] The Slack popup didn't open
>
> The browser blocked the popup. Allow popups for Nemu and click **Connect**
> again.

## Privacy

* Nemu **only sends** messages. It does not read channel history or conversations.
* In channels, the report is visible to every member, including external guests in shared channels.
* Nemu only stores the app's authorization token, never your Slack password. Access can be revoked at any time by disconnecting in Nemu or removing the app in Slack.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.