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

# Hudson in Slack

> Mention @Hudson in any Slack channel to ask about your ads, get files, and draft plans, without leaving the conversation.

Hudson answers in the thread, using the conversation and context around your question, the files shared there, and your data in Converge.

![A teammate asks @Hudson which ad sets pushed CPA up, and Hudson answers in the thread with linked ad sets and a link to review its plan](https://mintcdn.com/converge/HtC17uzgvUaEUpoQ/images/agentic-media-buying/slack-answer.png?fit=max\&auto=format\&n=HtC17uzgvUaEUpoQ\&q=85\&s=f6a644e3868e7ae70a4da1e1ec657d66)

It's the same Hudson you chat with in Converge, with the same data and memory. See the [overview](https://docs.runconverge.com/agentic-media-buying/overview.md) for everything it can do.

## How it works

```mermaid actions={false} theme={null}
flowchart LR
  A("`**You mention @Hudson**
  in a channel or a thread`") --> B("`**Converge checks**
  the workspace and who's asking`") --> C("`**Hudson reacts 👀**
  and reads the thread and its files`") --> D("`**Hudson answers**
  in the thread`")
```

Hudson acts on your behalf, with the same access you have in Converge. To ask it, you need a Converge account with the admin, editor, or analyst [role](https://docs.runconverge.com/settings/roles.md) in the workspace you ask about.

## Set up Hudson in Slack

**1. Connect Slack to Converge**

A Converge admin or editor connects Slack once for the whole workspace. This is the same connection that posts your [loop](https://docs.runconverge.com/agentic-media-buying/overview.md#what-hudson-does) and [routine](https://docs.runconverge.com/mcp/routines.md) reports.

> [!NOTE]
>
> Already connected? See [Slack was already connected](#slack-was-already-connected).

1. Go to [**Settings → Integrations**](https://app.runconverge.com/-/settings/workspace-integrations), click **Add connection**, and select **Slack**.
2. Click **Add to Slack**, pick your Slack workspace, and click **Allow**. If your Slack requires app approval, a Slack admin may need to approve the Converge app first.

![The Add Converge to Slack dialog, listing what Hudson can do, including Answer when you mention it](https://mintcdn.com/converge/HtC17uzgvUaEUpoQ/images/agentic-media-buying/add-to-slack.png?fit=max\&auto=format\&n=HtC17uzgvUaEUpoQ\&q=85\&s=a074f0d0a9cc005dd01886b5db734da9)

If you did this step yourself, your own Slack account is linked at the same time, so you can skip step 3.

**2. Add Hudson to your channels**

In each Slack channel where your team will ask Hudson, run `/invite @Hudson`. This works in public and private channels.

**3. Link your Slack account**

Everyone who asks Hudson links their Slack account once, so Hudson knows who's asking.

1. Mention `@Hudson` in a channel. Hudson replies privately with a link.

![Hudson's private reply: This channel answers for Acme. Connect your Converge account, then mention me again.](https://mintcdn.com/converge/HtC17uzgvUaEUpoQ/images/agentic-media-buying/slack-connect-reply.png?fit=max\&auto=format\&n=HtC17uzgvUaEUpoQ\&q=85\&s=317be4d25bce8bacede5ac296fba3a80)

2. Click **Connect your Converge account**, sign in to Converge if it asks, and click **Sign in with Slack**. Pick the Slack workspace connected to Converge and confirm. Converge only learns which Slack user you are.

![The Link your Slack account dialog with a Sign in with Slack button](https://mintcdn.com/converge/HtC17uzgvUaEUpoQ/images/agentic-media-buying/link-dialog.png?fit=max\&auto=format\&n=HtC17uzgvUaEUpoQ\&q=85\&s=5d3107123ad505bc86af4757c36f1dfe)

**4. Ask Hudson**

Mention `@Hudson` again with your question. Hudson reacts 👀 and answers in the thread. It doesn't answer messages you sent before linking.

### Other setups

> [accordion] Slack was already connected
>
> Older Slack connections don't have the permissions Hudson needs to see mentions. Open the Slack connection under [**Settings → Integrations**](https://app.runconverge.com/-/settings/workspace-integrations). If **Ask Hudson in Slack** says **Hudson can't see mentions until Slack is reconnected**, click **Reconnect** and approve the new permissions in Slack. Your channels, loops, and routines keep working.
>
> ![A Slack connection missing Hudson's permissions: the Ask Hudson in Slack row says Hudson can't see mentions until Slack is reconnected, above a Reconnect card](https://mintcdn.com/converge/HtC17uzgvUaEUpoQ/images/agentic-media-buying/reconnect.png?fit=max\&auto=format\&n=HtC17uzgvUaEUpoQ\&q=85\&s=9c048d831da3caaa0cb966d4d60524dd)

> [accordion] One Slack is connected to several Converge workspaces
>
> Agencies and brands often connect one Slack to several Converge workspaces. Each channel then answers for one workspace, so Hudson knows whose data a question is about. In each workspace, an admin or editor opens the Slack connection and picks channels in **Channels Hudson answers in**. Converge adds Hudson to public channels for you. For a private channel, run `/invite @Hudson` in it first.
>
> ![The Channels Hudson answers in card, with two channels added and a dropdown of channels to add](https://mintcdn.com/converge/HtC17uzgvUaEUpoQ/images/agentic-media-buying/channels-card.png?fit=max\&auto=format\&n=HtC17uzgvUaEUpoQ\&q=85\&s=2ece3feaf4cb9f4ef71884928b1002e9)
>
> A channel answers for the first workspace that adds it. Teammates link their Slack account in each workspace they ask Hudson about.

> [accordion] Link your Slack account from Converge
>
> Open the Slack connection under [**Settings → Integrations**](https://app.runconverge.com/-/settings/workspace-integrations). In **Ask Hudson in Slack**, click **Link**, then **Sign in with Slack**.
>
> ![The Ask Hudson in Slack row with a Link button](https://mintcdn.com/converge/HtC17uzgvUaEUpoQ/images/agentic-media-buying/link-row.png?fit=max\&auto=format\&n=HtC17uzgvUaEUpoQ\&q=85\&s=000ea062858ba27247f67ef4a5bbae1d)

## Use Hudson in Slack

* **Ask in a thread or in the channel.** In a thread, Hudson reads the first message and up to 15 replies before your mention. In the channel itself, it reads up to 15 messages posted since the last question it answered there, leaving out replies inside threads, and answers in a thread under your message.
* **Follow up in the same thread.** Mention `@Hudson` again: it remembers the thread and reads what was posted since. Hudson only replies when you mention it, one question at a time per thread.
* **Share files.** Hudson opens CSV, Excel, PDF, text, Markdown, JSON, PNG, and JPG files shared with your question or in the messages it reads, up to 25 MB each and 10 per question. It skips files stored outside Slack, like Google Drive links.
* **Get files back.** Exports and reports Hudson writes are posted in the thread after its answer.
* **Open ads, files, and plans in Converge.** Campaigns, ad sets, ads, and files link to the chat in Converge, with that item open. Plans link to Converge, where you approve them.
* **Ask about a loop run.** Mention `@Hudson` in the thread of a loop's post, and it continues that run's chat.
* **Continue in Converge.** Every thread is also a chat in Converge, with the Slack messages Hudson read as context. Only answers to Slack mentions are posted back to Slack.

![Hudson answers a request for a CSV export and posts the CSV file in the thread](https://mintcdn.com/converge/HtC17uzgvUaEUpoQ/images/agentic-media-buying/slack-files.png?fit=max\&auto=format\&n=HtC17uzgvUaEUpoQ\&q=85\&s=3582b946d32e6fe852c52792390a4896)

Files Hudson writes are posted in the thread.

![A chat in Converge that started in Slack, with the Thread context button on the question and Hudson's answer below](https://mintcdn.com/converge/HtC17uzgvUaEUpoQ/images/agentic-media-buying/slack-session.png?fit=max\&auto=format\&n=HtC17uzgvUaEUpoQ\&q=85\&s=832a8d87e14145711cf0bbbf020c27cf)

Every thread is also a chat in Converge.

## Troubleshooting

> [accordion] Hudson doesn't react at all
>
> * **Check the Slack connection.** If **Ask Hudson in Slack** says **Hudson can't see mentions until Slack is reconnected**, [reconnect Slack](#slack-was-already-connected). With several workspaces, check the one the channel answers for.
> * **Add Hudson to the channel.** Run `/invite @Hudson` in it.
> * **Mention Hudson in a channel.** Hudson doesn't answer direct messages, or messages posted by apps and bots.

> [accordion] Hudson reacted 👀 but takes a while
>
> Slack limits how often apps can read a thread or channel, so in a busy Slack a question can wait about a minute before Hudson starts. Bigger analyses also take a few minutes.

> [accordion] Linking says my account or Slack user is already linked
>
> In each Converge workspace, one Converge account links to one Slack user. Click **Unlink** under **Ask Hudson in Slack** and link again. If a teammate linked your Slack user, ask them to unlink it.

> [accordion] Hudson's files don't show up in the thread
>
> Older Slack connections can't upload files. [Reconnect Slack](#slack-was-already-connected), or open the files in the Converge chat.

> [accordion] Hudson's answer is cut off
>
> Slack limits message length, so Hudson cuts very long answers short. Open the chat in Converge for the full answer.

> [accordion] How is Hudson different from the Claude app in Slack?
>
> [Ask Claude in Slack](https://docs.runconverge.com/mcp/ask-claude-in-slack.md) uses your own Claude account and the Converge MCP to query your analytics. Hudson is Converge's media buyer: it also drafts plans, runs loops, and remembers your setup. You can use both.

## Privacy and permissions

* **Hudson only reads where it's mentioned.** It reads the thread or channel around a mention, and the files there, only when someone mentions it.
* **Everyone in the channel sees Hudson's answers**, including members without Converge access and people from other organizations in a Slack Connect channel. Ask Hudson in channels where everyone may see that data.
* **Hudson acts on your behalf.** It uses your role in the channel's Converge workspace, so removing someone from the workspace stops Hudson from answering them there.

See [what Converge asks Slack for](https://docs.runconverge.com/settings/integrations/slack.md#what-converge-can-do-in-slack) for the full list of Slack permissions.


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