> ## 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.

# 连接 Slack 以接收 AgencyHandy 实时提醒

> 将您的 Slack 工作区与 AgencyHandy 关联，订单更新、任务变更和工单提醒将自动推送到 Slack 频道。

AgencyHandy 的 Slack 集成让您的团队保持同步，无需在应用之间来回切换。连接后，每当任务、订单或其他工作区活动发生变化，AgencyHandy 都会自动向您选择的 Slack 频道发布通知 — 让您的团队始终实时掌握最新动态。

<Note>
  只有**超级管理员**、**管理员**和具有集成权限的**经理**角色才能连接或管理 Slack 集成。您需要拥有 Slack 工作区管理员权限才能授权连接。
</Note>

## 连接 Slack

<Steps>
  <Step title="打开集成">
    在左侧边栏中，点击 **集成**。
  </Step>

  <Step title="找到 Slack 卡片">
    滚动到 **Slack** 卡片并点击 **连接**。
  </Step>

  <Step title="在 Slack 中授权 AgencyHandy">
    将打开 Slack 授权窗口。如果您尚未登录 Slack 工作区，请先登录。查看 AgencyHandy 请求的权限，然后点击 **允许** 以授予访问权限。
  </Step>

  <Step title="选择通知频道">
    授权后，选择您希望 AgencyHandy 通知出现的 Slack 频道。从下拉列表中选择一个频道，然后点击 **保存** 确认。
  </Step>

  <Step title="确认设置">
    Slack 卡片将更新显示 **已连接**。AgencyHandy 将立即开始向所选频道发布通知。
  </Step>
</Steps>

## 哪些通知会发送到 Slack

每当以下任意事件发生时，AgencyHandy 都会发布一条 Slack 消息：

| 类别       | 触发通知的事件        |
| -------- | -------------- |
| **任务**   | 任务已创建、更新、分配或完成 |
| **订单**   | 订单已创建或状态已变更    |
| **评论**   | 在任务或订单中添加了新评论  |
| **文件附件** | 向任务添加了文件或附件    |
| **工单**   | 工单已创建、分配或状态已变更 |

每条 Slack 消息包含：

* 任务、订单或工单的**名称**
* 触发消息的**状态变更**或操作
* 返回 AgencyHandy 中相关条目的**链接**

当文件或附件添加到任务时，Slack 消息还会包含该附件的预览。

<Tip>
  选择一个专用的 **#agency-handy-alerts** 频道（或类似名称）来整理通知，避免它们打乱您的主要团队频道。
</Tip>

## 断开 Slack 连接

如需停止通知，请返回 **集成** 并点击 Slack 卡片上的 **断开连接**。所有通知将立即停止。

## 重要说明

* **每个工作区只能连接一个 Slack** — 每个 AgencyHandy 工作区只能连接一个 Slack 工作区。如需切换到其他 Slack 工作区，请先断开当前连接再重新连接。
* **频道可见性** — 通知对所选 Slack 频道中的所有人可见。请确保该频道适合共享相应详细程度的信息（例如，避免将涉及客户敏感信息的订单详情发布到公开频道）。
* **重新授权** — 如果您的 Slack 令牌过期或权限发生变化，请返回集成并重新连接以恢复通知。