# Slack Integration

The Slack Integration feature lets you connect your Agency Handy workspace to a Slack channel. Once connected, updates about orders, tasks and other workspace activities are automatically posted to Slack in real time, keeping team members informed without leaving their messaging app.

### What You Can Do

* Connect your Slack workspace to Agency Handy
* Choose a specific Slack channel for notifications
* Receive automatic updates when tasks, orders or projects change
* Include task attachments or comments directly in Slack messages
* Disconnect the integration at any time from the Integrations page

### Why It Matters

* Keeps your team informed in real time without switching apps
* Centralises notifications, reducing email clutter
* Improves collaboration by showing task and order details where the team already works

### Who Can Use This

* **Super Admin** and **Admin** roles with access to Integrations
* **Manager** role if granted integration permissions

### Getting Started

1. **Open Integrations**
   * Go to the left sidebar and click **Integrations**.
2. **Find Slack**
   * Scroll to the Slack card and click **Connect**.
3. **Authorise Slack**
   * A Slack window opens. Sign in to your Slack workspace (if not already signed in).
   * Review the permissions and click **Allow** to authorise Agency Handy.
4. **Choose a Channel**
   * After authorisation, select the Slack channel where you want notifications to appear.
   * Click **Save** to confirm.
5. **Complete the Setup**
   * The Slack card will show as **Connected**.
   * You will now start receiving notifications in the selected channel.

### How Notifications Work

* When a task is created, updated or completed, or when there is a new comment or order update, a message is posted to the configured Slack channel.
* Messages include basic details (task name, order number, status change) and a link back to Agency Handy.
* If a file or attachment is added to the task, the Slack message includes a preview.

### Important Notes

* Only one Slack workspace can be connected per Agency Handy workspace.
* You need Slack workspace admin rights to authorise the integration.
* Disconnecting the integration stops all notifications immediately.
* Notifications are visible to all members of the selected Slack channel—make sure the channel is appropriate for the level of detail shared.


---

# Agent Instructions: 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.agencyhandy.com/english/agencyhandy-user-guide-for-agency/integration/slack-integration.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.