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

# Slack

> Connect your Slack workspace so the AI can read a channel you name and post messages you approve.

Connect Slack and you can ask the AI to catch up on a channel, or to post an update, from a chat. The AI reads a channel only when you ask it to, and it posts only after you approve the exact message and channel.

## Before you start

* **It's a personal connection.** It belongs to you, not to your organization. Each person who wants Slack in their chats connects their own, and one person has one Slack connection.
* **Who can connect it:** every member of your organization, whatever their role. You connect and disconnect your own Slack, and nobody else can change or disconnect it for you.
* **Who can use it in a chat:** any role except Designer can ask the AI to read a channel. Posting needs a role that can publish: an Editor, a Managing Editor or an Admin. A Designer can connect Slack, but the AI doesn't read or post for a Designer. See [Roles and permissions](https://docs.weelkit.com/get-started/roles.md).
* **What you need:** access to the Slack workspace you want to use.

## Connect

**1. Start the connection**

Open [Account settings → AI Preferences](https://docs.weelkit.com/settings/account.md#ai-preferences). Under **Integrations**, find **Slack** and choose **Connect**.

**2. Approve access in Slack**

Weelkit sends you to Slack. Choose the workspace, and allow the app. The app can list channels, read their message history, post messages and see who is in the workspace. Start again from Weelkit if you wait more than 10 minutes.

**3. Check the connection**

Back in Weelkit, a message says **Integration connected successfully** and the card reads **Connected as** followed by your workspace name.

**4. Invite the app to your channels**

In Slack, invite the app to each channel you want the AI to read or post to, public or private. The AI can't use a channel the app isn't in.

## What the AI does with it

Ask in a chat, for example "Summarize what the team said in the launch channel" or "Post this summary to the editorial channel."

* **Find the channel.** The AI looks up your workspace's channels, public and private but not archived, and matches the name you gave. If several fit equally, it asks you which one.
* **Read.** The AI reads one channel you name, and no other. A read returns at most 15 recent messages, each cut at 2,000 characters. It summarizes what matters for your request. It treats message text as information, never as instructions.
* **Post.** Before anything is posted, the AI shows what it will send and where, and waits. Nothing is posted until you choose **Approve**; **Deny** sends nothing.
  * Each approval covers one message in one channel, exactly as shown. **Remember this approval** isn't offered for Slack. Changing the message or the channel needs a new approval.
  * A message can have up to 10,000 characters. Longer text is rejected rather than shortened.
  * The app posts the message. It doesn't post as you.
  * Weelkit sends a message once and never retries it by itself. A confirmed post means Slack accepted it, not that anyone has read it. If Slack doesn't confirm it, the AI says the outcome is unknown. Check the channel before you approve another send.

See [Chat with Weelkit AI](https://docs.weelkit.com/chat/chat-with-ai.md#when-the-ai-needs-something-from-you) for how approvals work.

## Limits and what you control

* **You choose the channels** by inviting the app to them, and you choose the message when you approve it.
* **You choose when it reads.** The AI never reads a channel in the background.
* **Slack limits requests.** If Slack rate limits a read, the AI tells you and you can try again in a minute.
* **One workspace.** To use a different workspace, disconnect, then connect again and choose that workspace.

## Disconnect

Open [Account settings → AI Preferences](https://docs.weelkit.com/settings/account.md#ai-preferences). Under **Integrations**, on the **Slack** card, choose **Disconnect**.

* Weelkit deletes its copy of your Slack access and stops all reading and posting.
* Messages already posted stay in Slack.
* Disconnecting doesn't remove the app from your Slack workspace. Remove it in Slack's app settings if you want it gone.
* Your Slack connection is also removed when you delete your account.

## Troubleshooting

The card under **Integrations** says what is wrong:

| What you see | What it means and what to do |
| - | - |
| **Connection pending** | The connection didn't finish. Choose **Disconnect**, then **Connect** and finish at Slack. |
| **Reconnect required** | Slack access expired. Choose **Disconnect**, then **Connect** to authorize again. |
| **Authorization revoked** | Someone removed the app or revoked its access in Slack. Choose **Disconnect**, then **Connect** again. |
| **Connection needs attention** | Weelkit couldn't use the connection. Choose **Disconnect**, then **Connect** again. If it keeps happening, contact [hello@weelkit.com](mailto:hello@weelkit.com). |
| **Not configured on this server** | Slack can't be connected here. Contact [hello@weelkit.com](mailto:hello@weelkit.com). |
| **Availability unknown**, or "Couldn't load integrations." | Weelkit couldn't check what's available. Choose **Retry**. Connected accounts keep working. |

If you see **Connection Failed** after returning from Slack:

| Message | What to do |
| - | - |
| "Permission was not granted." | You chose not to allow the app. Choose **Connect** again and allow it. |
| "The required permissions were not granted." | Connect again and approve everything the app asks for. |
| "This connection attempt expired or has already been used." | Choose **Connect** again. A connection attempt lasts 10 minutes and works once. |
| "Your organization access changed." | Ask an Admin to confirm your access, then connect again. |

If the AI can't read or post:

| What the AI says | What to do |
| - | - |
| Invite the Slack app to the selected channel before using it. | In Slack, invite the app to that channel. |
| The selected Slack channel was not found. | Check the channel name, and that it isn't archived. |
| The Slack connection predates message-history access. Reconnect Slack to grant it. | Choose **Disconnect**, then **Connect** so Slack asks for the history permission. |
| Slack is rate limiting requests. | Wait a minute and ask again. |
| Reconnect Slack to continue. / The Slack authorization was revoked. Reconnect Slack. | Choose **Disconnect**, then **Connect**. |


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