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

# Overview

The Sumble Slack app does two things:

* Gives each rep an AI agent that can research accounts, find prospects, rank your book of business, and analyze your sales plays directly in a Slack thread
* Delivers [Sumble Signals](/enterprise-services/sumble-signals.md) alerts to your team

Use it when you want account research inside Slack, AI prospecting and whitespace discovery, or Signal alerts routed to each rep automatically.

{% hint style="info" %}
The AI agent is available on Pro and Enterprise plans. Free plan users receive Signal alerts only.
{% endhint %}

## In this section

* [Querying Sumble from Slack](/slack-agent/querying-sumble-from-slack.md) — the AI agent: quick-start actions, example prompts, file attachments, memory, and credits.
* [Signal alerts in Slack](/slack-agent/signals-alerts-in-slack.md) — delivery options, priority filters, and alert content.

***

## How to set up the Slack agent

A Slack admin installs the app once for the workspace.

{% stepper %}
{% step %}

### Open Account Settings

Go to [Account Settings](https://sumble.com/account/settings) in Sumble.
{% endstep %}

{% step %}

### Add to Slack

Click the **Add to Slack** button.
{% endstep %}

{% step %}

### Install the app

Follow the prompts to install the Sumble app in your workspace.
{% endstep %}
{% endstepper %}

Once installed, Sumble matches workspace members to Sumble accounts by email.

Each matched user receives a welcome DM with quick-start options.

Individual users connect their own Slack account from [Account Settings](https://sumble.com/account/settings).

{% hint style="success" %}
If your email doesn't match between Slack and Sumble, select your Slack user manually during setup. Sumble shows your team name so you can confirm the right workspace.
{% endhint %}

***

## Troubleshooting

### Not receiving alerts

* Check that your Slack account is connected in [Account Settings](https://sumble.com/account/settings)
* Confirm your Sumble email matches your Slack email, or complete the manual connection
* Make sure you haven't muted the Sumble app in Slack

Check your notification preferences in the **Home** tab too. You may have **Don't send any updates** selected.

### The AI agent is not responding

* The AI agent requires a Pro or Enterprise plan. Confirm your plan in [Account Settings](https://sumble.com/account/settings)
* Start a new message in the Sumble app DM, or open the **Home** tab and use a quick-start action
* Replies come in-thread. Check the thread on the original message if you don't see a response

### Need to reconnect

Go to [Account Settings](https://sumble.com/account/settings) and click the Slack button again to re-authorize.

***

## Slack permissions

| Scope               | What it's for                                   |
| ------------------- | ----------------------------------------------- |
| `chat:write`        | Send alerts and agent messages via DM           |
| `chat:write.public` | Post alerts to public channels when configured  |
| `files:read`        | Read files attached to agent messages           |
| `team:read`         | Display your team name during manual connection |
| `users:read`        | Map users between Slack and Sumble              |
| `users:read.email`  | Match Slack users to Sumble users by email      |

{% hint style="info" %}
Need help? Contact <support@sumble.com>. Use of this integration is subject to Sumble's [Privacy Policy](https://sumble.com/privacy).
{% endhint %}

***

## FAQ

### What is the Sumble Slack agent?

The Sumble Slack agent is Sumble's AI assistant inside Slack for account research, prospecting, whitespace discovery, sales planning, and Signal alerts.

### Who can use the AI agent in Slack?

The AI agent is available on Pro and Enterprise plans.

Free plans can receive Signal alerts in Slack, but do not get agent access.

### Can the Slack agent research accounts and prospects?

Yes. You can ask it for company research, prospect discovery, account ranking, sales plays, and whitespace accounts directly in a Slack thread.

### Can the Slack agent read uploaded files?

Yes. The agent can read supported documents, spreadsheets, presentations, and images that you attach to a Slack message.

### How are Signal alerts routed in Slack?

Sumble uses your account ownership mapping so each rep receives alerts for their own book of business.


---

# 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.sumble.com/slack-agent/slack-agent.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.