> For the complete documentation index, see [llms.txt](https://docs.keeping.com/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.keeping.com/help/setup/integrations/slack.md).

# Slack

## Slack integration

Keeping's Slack integration keeps your team in the loop on customer conversations without forcing anyone to leave Slack. Once connected, Keeping can:

* **Send you a direct message in Slack** whenever a teammate @mentions you in an internal note on a Keeping conversation.
* **Post workflow notifications to a Slack channel** so the whole team can see ticket activity (new tickets, status changes, assignments, etc.) routed by your Keeping workflows.

The integration is set up once at the company level by an admin.

<figure><img src="/files/WEw1A9CoENA06XUeMAxp" alt=""><figcaption><p>Notification in Slack</p></figcaption></figure>

### Before you start

You'll need:

* A Keeping account with **admin** access (only admins can connect or disconnect integrations).
* A Slack workspace where you have permission to install apps. If your workspace requires admin approval for new apps, your Slack admin may need to approve the Keeping app the first time it's installed.

### Connecting Slack to Keeping

<figure><img src="/files/MggwxEBxXwKgXI51j1Yi" alt="Enable slack integration"><figcaption><p>Enable Keeping's Slack integration</p></figcaption></figure>

1. In the left-hand sidebar, click [**Integrations**](https://app.keeping.com/integrations).
2. Find the **Slack** tile and click **Connect**.
3. You'll be redirected to Slack's authorization screen. Choose the workspace you want to connect (if you belong to more than one) and click **Allow** to grant Keeping permission to:
   * Read the list of channels in your workspace
   * Post messages to channels you select
   * Send direct messages to teammates when they're @mentioned
4. After you allow access, you'll be returned to Keeping. The Slack tile will now show **Connected**, along with the name of the workspace you connected and the bot user that Keeping uses to post messages (for example, *Connected as @keeping in Acme HQ*).

### Choosing a notification channel

After connecting, pick the Slack channel where Keeping should post workflow notifications.

1. On the Slack integration page in Keeping, click the **Notification channel** dropdown.
2. Select any public channel — or any private channel that the Keeping bot has been invited to.
3. Click **Save**.

{% hint style="info" %}
**Don't see a private channel you expected?** The Keeping bot can only post in private channels it's been added to. In Slack, open the channel, type `/invite @keeping`, then refresh the dropdown in Keeping.
{% endhint %}

#### Sending a test message

To make sure Keeping can post to the channel you chose, click **Send test message**. A short message from the Keeping bot will appear in the selected channel within a few seconds. If it doesn't show up, see Troubleshooting below.

### Direct messages for @mentions

When the Slack integration is active, Keeping will send you a direct message in Slack any time a teammate @mentions you in an internal note on a Keeping conversation. The DM includes:

* The subject of the conversation
* Who mentioned you
* A direct link back to the note in Keeping

Keeping matches your Slack identity to your Keeping account using the email address on each side, so make sure the email address on your Slack profile matches the email you use to log in to Keeping.

#### Turning off mention DMs for yourself

Each agent can opt out of mention DMs without disconnecting the integration for the rest of the team.

1. In Keeping, click your initials in the top-right and choose **Settings**.
2. Open the **Preferences** tab.
3. Under **Slack**, toggle off **Send me a Slack DM when I'm @-mentioned**.

The toggle only appears when your company has an active Slack integration. If your admin disconnects Slack later, the setting is preserved and will take effect again the next time Slack is connected.

### Using Slack in workflows

Once a notification channel is set, any Keeping workflow you build can post a message to that channel as part of its actions. For example, "When a ticket is tagged *urgent*, post to `#support-alerts`." See the [Workflows documentation](https://docs.keeping.com/help/setup/workflows) for details on building workflow rules.

<figure><img src="/files/fuynjrL6SMltIua7vn1p" alt=""><figcaption></figcaption></figure>

### Disconnecting Slack

To disconnect Slack from Keeping:

1. Go to **Settings → Integrations**.
2. Click the Slack tile.
3. Click **Disconnect**.

Disconnecting stops all DMs and channel notifications immediately. Your notification channel choice and each agent's personal DM preference are remembered, so reconnecting later restores your previous configuration without any extra setup.

### Troubleshooting

**The test message didn't appear in Slack.** Make sure the Keeping bot has been added to the channel. For private channels, open the channel in Slack and run `/invite @keeping`. For public channels, no invite is needed but the channel must not be archived.

**A teammate isn't receiving DMs when I @mention them.** Check that:

* The teammate's email address in Slack matches their Keeping login email.
* The teammate hasn't turned off **Send me a Slack DM when I'm @-mentioned** in their own Preferences.
* The Slack integration is still connected (an admin can verify this on **Settings → Integrations**).

**The Slack tile shows "Reconnect required."** This happens if the connection between Keeping and Slack has expired — for example, if a Slack admin removed the Keeping app from your workspace. Click **Reconnect** to restore the integration. Your channel and per-user settings will be applied automatically once the reconnection is complete.

**I need help.** If you're still stuck, email <support@keeping.com> and we'll dig in.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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.keeping.com/help/setup/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.