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

# Connect Slack to Receive Real-Time AgencyHandy Alerts

> Link your Slack workspace to AgencyHandy so order updates, task changes, and ticket alerts are posted to a Slack channel automatically.

AgencyHandy's Slack integration keeps your team in the loop without requiring anyone to switch between apps. Once connected, AgencyHandy posts automatic notifications to the Slack channel of your choice whenever tasks, orders, or other workspace activities change — so your team always knows what's happening in real time.

<Note>
  Only **SuperAdmin**, **Admin**, and **Manager** roles (with integration permissions) can connect or manage the Slack integration. You need Slack workspace admin rights to authorize the connection.
</Note>

## Connect Slack

<Steps>
  <Step title="Open Integrations">
    In the left sidebar, click **Integrations**.
  </Step>

  <Step title="Find the Slack card">
    Scroll to the **Slack** card and click **Connect**.
  </Step>

  <Step title="Authorize AgencyHandy in Slack">
    A Slack authorization window opens. If you are not already signed in to your Slack workspace, sign in now. Review the permissions AgencyHandy requests and click **Allow** to grant access.
  </Step>

  <Step title="Select a notification channel">
    After authorization, choose the Slack channel where you want AgencyHandy notifications to appear. Select a channel from the dropdown and click **Save** to confirm.
  </Step>

  <Step title="Confirm the setup">
    The Slack card updates to show **Connected**. AgencyHandy immediately begins posting notifications to the selected channel.
  </Step>
</Steps>

## What notifications are sent to Slack

AgencyHandy posts a Slack message whenever any of the following events occur:

| Category             | Events that trigger a notification            |
| -------------------- | --------------------------------------------- |
| **Tasks**            | Task created, updated, assigned, or completed |
| **Orders**           | Order created or status changed               |
| **Comments**         | New comment added to a task or order          |
| **File attachments** | File or attachment added to a task            |
| **Tickets**          | Ticket created, assigned, or status changed   |

Each Slack message includes:

* The **name** of the task, order, or ticket
* The **status change** or action that triggered the message
* A **link** back to the relevant item in AgencyHandy

When a file or attachment is added to a task, the Slack message also includes a preview of that attachment.

<Tip>
  Choose a dedicated **#agency-handy-alerts** channel (or similar) to keep notifications organized and prevent them from cluttering your main team channels.
</Tip>

## Disconnect Slack

To stop notifications, return to **Integrations** and click **Disconnect** on the Slack card. All notifications stop immediately.

## Important notes

* **One workspace per connection** — you can only connect a single Slack workspace to each AgencyHandy workspace. To switch to a different Slack workspace, disconnect the current one and reconnect.
* **Channel visibility** — notifications are visible to everyone in the selected Slack channel. Make sure the channel is appropriate for the level of detail being shared (e.g., avoid posting client-sensitive order details to a public channel).
* **Re-authorization** — if your Slack token expires or permissions change, return to Integrations and reconnect to restore notifications.