企业微信集成
企业微信集成把一个 HiFox Agent 连成企业微信智能机器人，在企业微信里收发消息。
这和自动化工作流里的企业微信动作不是同一条链路。工作流可以发消息、写表格，见 自动化工作流。本页只写 Agent 机器人。
企业微信智能体能做什么？
- 将一个 HiFox Agent 连接为企业微信智能机器人；
- 在企业微信私聊中直接和 Agent 对话；
- 在群聊中 @ 机器人，让 Agent 回复；
- 分别控制是否响应私聊和群里被 @；
- 在 HiFox 中查看、调整或断开已有绑定。
企业微信消息进入的是 Agent 外部会话，不会自动变成 HiFox 任务。如果对话中形成了需要分配、追踪或验收的工作，建议把它整理成 HiFox 任务，再指派给 Agent。
连接前需要准备什么？
一个 Agent 同一时间只能绑定一个企业微信入口。已经绑定企业微信的 Agent 不会再次出现在可选列表中。
从哪里进入？
你可以从两个位置配置：
- 进入组织后，打开 外部应用集成，在企业微信卡片上点击设置或管理；
- 进入某个 Agent 的详情页，在集成区域选择 绑定企业微信，这种方式会直接绑定当前 Agent。
卡片名称、按钮文案以线上为准。
连接企业微信机器人
- 打开 连接企业微信。
- 选择要绑定的 Agent。
- 在企业微信管理后台按下面步骤拿到凭据，粘贴到 HiFox。
- 等待状态变为已连接。
在企业微信管理后台：
- 打开 管理工具 → 智能机器人，创建一个机器人。
- 在设置面板滑到最底部，点击「API 模式创建」切换模式。
- 选择长连接方式，把生成的 BotID 和 Secret 填到 HiFox。
企业微信后台入口以线上「打开企业微信后台」为准。
不要把 BotID、Secret 粘贴到任务评论、聊天消息或公开文档中。
在企业微信中怎么使用？
私聊
安装完成后，可以直接给机器人发私信。是否响应私聊，取决于该绑定的触发设置。
群里被 @ 到
把机器人拉进群后，在群里 @ 它并输入问题或指令。是否响应群 @，同样取决于触发设置。
企业微信机器人当前没有飞书 / Slack 那套表情触发、群消息直接触发。触发开关以 Agent 集成页线上为准。
连接后会发生什么？
常见消息流程如下：
- 用户在企业微信中向机器人发送私聊，或在群里 @ 机器人；
- HiFox 接收事件并找到对应绑定；
- 消息进入该 Agent 的外部会话并触发运行；
- Agent 生成回复；
- 回复返回原会话。
管理和断开
企业微信详情页会列出当前组织中已有的 Agent 绑定。你可以查看每个入口绑定的 Agent，刷新状态，或断开不再需要的绑定。
断开后，该企业微信入口将停止把新消息发送给对应 Agent。已有 HiFox 会话和历史消息不会因此自动删除。需要恢复时，请重新填写凭据完成连接。
常见问题
为什么没有可选 Agent？
可能还没有创建 Agent，或者所有可用 Agent 都已经绑定企业微信。一个 Agent 只能绑定一个企业微信入口。
收不到企业微信消息怎么办？
先确认绑定仍显示为已连接，再检查对应的 私聊 或 群里被 @ 到 触发设置是否开启。群聊中还需要 @ 该机器人。
企业微信消息会自动变成 HiFox 任务吗？
不会。消息进入的是 Agent 外部会话。需要跟踪状态、处理人、评论或验收标准的工作，请在 HiFox 中创建任务并指派给 Agent。