Slack 集成

Slack 集成用于把 HiFox Agent 接入 Slack。连接后，团队可以在 Slack 里给 Agent 发消息，Agent 的回复会回到同一个 Slack 对话或线程中。

HiFox 当前使用自动创建和安装 Slack App 的方式：你提供 Slack App Configuration Refresh Token，HiFox 会替你创建 Slack App、配置事件回调和 OAuth 回调，并打开 Slack 授权窗口完成安装。

每个 Slack 机器人会绑定一个 HiFox Agent。它适合临时提问、方案讨论、信息查询，或在 Slack 中快速触发一个 Agent 对话。

Slack 集成能做什么？

Slack 集成可以帮助你：

把一个 HiFox Agent 连接成 Slack 机器人；

在 Slack 私聊中直接和 Agent 对话；

在频道或私有频道中 @ 机器人，让 Agent 在线程中回复；

在已经由 Agent 参与的 Slack 线程中继续回复；

使用 Slack Assistant 面板时，让 Agent 运行状态显示为 Thinking；

在 HiFox 外部应用集成页或 Agent 集成页查看、管理、断开 Slack 机器人。

Slack 集成连接的是 Agent 外部会话，不会自动创建 HiFox 任务。如果对话中形成了需要分配、追踪或验收的工作，建议把它整理成 HiFox 任务，再委派给 Agent。

连接前需要准备什么？

准备项	说明
HiFox 组织权限	需要组织 owner 或 admin 来配置 Slack 集成。
Agent	每个 Slack 机器人都需要绑定一个 Agent。没有 Agent 时，先创建 Agent。
Slack 管理权限	需要能在 Slack API 后台生成 App Configuration Token，并能在目标 Slack 工作区安装应用。
Slack App Configuration Refresh Token	在 Slack API 后台生成后，把其中的 Refresh Token 粘贴到 HiFox。

一个 Agent 同一时间只能绑定一个 Slack 机器人。已经绑定 Slack 的 Agent 不会再出现在可选列表中。

从哪里进入？

你可以从两个位置配置 Slack：

进入组织后，打开 外部应用集成，在 Slack 卡片上点击设置或管理；

进入某个 Agent 的详情页，在集成页签中配置 Slack，这种方式会直接绑定当前 Agent。

Slack 卡片会根据当前状态显示不同信息：

状态	含义
设置	还没有配置 Slack。
管理	已经配置过 Slack，可以继续查看或调整。
N 个机器人已绑定	当前组织已有 N 个 Slack 机器人连接到 Agent。

打开弹窗后，标题为 连接 Slack。如果还没有可绑定的 Agent，弹窗会提示先创建 Agent。

获取 Slack App Configuration Refresh Token

连接 Slack 前，需要先在 Slack API 后台生成 App Configuration Token。

操作步骤：

打开 api.slack.com/apps。

进入 Your App Configuration Tokens。

生成一个新的 App Configuration Token。

复制其中的 Refresh Token。

回到 HiFox，把 Refresh Token 粘贴到 Slack 集成弹窗中。

这个令牌只用于创建和安装 Slack App。HiFox 会用它自动配置应用，不需要你手动填写事件订阅 URL、OAuth 回调 URL 或权限范围。

连接 Slack 机器人

在 HiFox 中连接 Slack 的步骤：

打开 连接 Slack 弹窗。

点击 添加机器人。

选择要绑定的 Agent。

可选：填写 Slack 应用名称。不填写时，默认使用 Agent 名称；名称最长 35 个字符。

粘贴 App Configuration Refresh Token。

点击 创建并安装。

在弹出的 Slack 授权窗口中选择工作区并授权安装。

回到 HiFox，等待机器人状态变为 已连接。

安装过程中，HiFox 会显示安装进度。授权完成后，Slack 窗口会通知 HiFox 刷新状态；如果没有立即刷新，也可以稍等几秒或重新打开弹窗查看。

安装成功后，HiFox 会尽量给安装用户发送一条欢迎私信。欢迎消息发送失败不会影响集成本身。

HiFox 会自动配置什么？

创建 Slack 机器人时，HiFox 会自动创建 Slack App，并配置：

应用名和机器人显示名；

App Home Messages tab；

Slack Assistant View；

OAuth redirect URL；

Events API Request URL；

机器人所需权限；

私聊、频道提及、频道消息和 Assistant 相关事件订阅。

当前自动配置的权限重点用于读取提及和消息、发送回复、接入私聊和 Assistant。你通常不需要在 Slack 后台手动修改这些配置。

在 Slack 中怎么使用？

私聊机器人

安装完成后，可以直接给 Slack 机器人发私信。

第一次私聊时，HiFox 会为这个 Slack 对话创建对应的 Agent 会话。之后你在同一个私聊里继续发送消息，Agent 会基于这个会话继续回复。

在频道中 @ 机器人

在频道或私有频道中，可以 @ 机器人并输入问题或指令。

HiFox 会把 @ 后面的文本作为用户消息发送给 Agent，Agent 回复会发到该消息所在的线程中。

普通频道消息不会触发 Agent。要在频道里开始一次 Agent 对话，需要先 @ 机器人。

在线程中继续回复

当 Agent 已经参与某个 Slack 线程后，你可以在线程里继续回复。只要这是已有的 Agent 线程，后续回复不需要每条都重新 @ 机器人。

如果是在普通频道里单独发消息，且不是 Agent 已参与的线程，HiFox 不会触发 Agent。

使用 Slack Assistant 面板

Slack App 会启用 Assistant 相关能力。使用 Assistant 面板时，Agent 运行过程中会尽量在 Slack 里显示 Thinking 状态。

连接后会发生什么？

连接成功后，Slack 中的消息会进入 HiFox 对应 Agent 的外部会话。

常见流程是：

用户在 Slack 私聊、Assistant 面板，或频道中 @ 机器人；

HiFox 接收 Slack 事件并验证请求；

HiFox 找到或创建对应 Slack 会话；

用户消息写入会话，并触发 Agent 运行；

Agent 生成回复；

回复通过 Slack 集成发回原对话或线程。

当前回复以文本消息发送。Slack 中的编辑消息、加入频道、修改话题等非普通消息事件不会触发 Agent；机器人或应用自己发出的消息也会被忽略，避免循环回复。

管理和断开 Slack 机器人

回到 Slack 集成弹窗后，可以查看已连接的机器人列表。

每个机器人会显示：

绑定的 Agent；

Slack 应用名称；

Slack 工作区信息；

当前状态。

需要停止使用时，可以在机器人列表中选择断开。断开后，这个 Agent 不再通过该 Slack 机器人收发消息；已有 HiFox 会话和历史消息不会因此变成 Slack 里的新消息或自动删除 Slack 历史。

权限和安全

通常规则是：

组织 owner / admin 可以创建、查看和断开 Slack 机器人；

每个 Slack 机器人绑定一个 Agent；

Slack bot token、signing secret、client secret 等凭证会加密保存；

Slack webhook 请求会验证签名，防止伪造事件；

App Configuration Refresh Token 只应通过 HiFox 的连接弹窗提交，不要粘贴到任务评论、聊天消息或公开文档中。

建议使用权限清晰的 Slack 管理账号完成安装，并定期检查 Slack App 的安装状态和权限范围。

常见状态

状态	说明
安装中	HiFox 正在创建 Slack App，或等待 Slack 授权安装完成。
已连接	Slack 机器人已经安装并可用。
失败	创建或安装失败，需要检查令牌、权限或 Slack 授权流程后重试。

常见问题

为什么需要 App Configuration Refresh Token？

HiFox 使用它自动创建和配置 Slack App。这样你不需要手动复制 Events API Request URL、OAuth callback、权限 scope 或事件订阅配置。

为什么没有可选 Agent？

可能还没有创建 Agent，或者所有可用 Agent 都已经绑定了 Slack。一个 Agent 只能绑定一个 Slack 机器人。

Slack 应用名称可以不填吗？

可以。不填写时，HiFox 会默认使用 Agent 名称。Slack 应用名称最多 35 个字符，过长会被截断。

频道里的普通消息会触发 Agent 吗？

不会。频道里要先 @ 机器人，或者在已有 Agent 线程中继续回复。这样可以避免机器人读取和响应频道中的所有普通消息。

断开 Slack 机器人会删除 Slack App 吗？

HiFox 会断开这个 Agent 和 Slack 机器人的绑定。是否还需要在 Slack 后台移除或管理对应 App，可以根据团队的 Slack 管理规则处理。

Slack 消息会变成 HiFox 任务吗？

不会自动变成任务。Slack 集成连接的是 Agent 外部会话。需要状态、负责人、评论和验收标准的工作，建议创建 HiFox 任务，再委派给 Agent。

Slack 集成能做什么？#

连接前需要准备什么？#

从哪里进入？#

获取 Slack App Configuration Refresh Token#

连接 Slack 机器人#

HiFox 会自动配置什么？#

在 Slack 中怎么使用？#

私聊机器人#

在频道中 @ 机器人#

在线程中继续回复#

使用 Slack Assistant 面板#

连接后会发生什么？#

管理和断开 Slack 机器人#

权限和安全#

常见状态#

常见问题#

为什么需要 App Configuration Refresh Token？#

为什么没有可选 Agent？#

Slack 应用名称可以不填吗？#

频道里的普通消息会触发 Agent 吗？#

断开 Slack 机器人会删除 Slack App 吗？#

Slack 消息会变成 HiFox 任务吗？#