> For AI agents: the complete documentation index is available at https://docs.danqiuos.com/llms.txt, the full documentation bundle is available at https://docs.danqiuos.com/llms-full.txt.

# 外部消息渠道

## 让员工进入团队日常沟通入口

飞书、企业微信、钉钉、微信等外部渠道可作为用户对话入口。实际可用的接入方式取决于客户环境、账号、租户配置和授权，应先确认对应入口、接收消息的员工及使用者身份。外部消息渠道承接沟通，系统集成承接业务系统操作，两者不能相互替代。

企业可先选一个常用渠道和一位目标员工试点，跑通用户发起、员工读取资料、生成结果、回复原会话的完整路径。需要持续跟踪的事项进入 [任务看板](https://docs.danqiuos.com/platform/taskboard.md)，不让进展只留在聊天中。

## 身份与资源授权的前置条件

| 前置条件  | 配置时要回答的问题             |
| ----- | --------------------- |
| 接入方式  | 当前客户环境实际支持哪种入口，谁维护连接？ |
| 员工绑定  | 该入口由哪个 team 的哪位员工接收？  |
| 用户身份  | 渠道联系人是否已按既定流程确认身份或绑定？ |
| 业务访问  | 员工与使用者分别获准访问哪些资料和记录？  |
| 回复与文件 | 回复应到哪个会话，接收人能否打开结果文件？ |

不能仅凭昵称、自报身份或能发消息，就授权内部数据访问。绑定完成也不代表可以读取所有业务资源；工作区、数据表和知识库仍要分别验证。未绑定、身份未确认或员工无权读取资料时，先处理相应前置条件。详见 [身份与权限](https://docs.danqiuos.com/platform/security.md)。

## 输入、处理与回复的最小闭环

从真实渠道发送一条消息，再发送一份测试附件，确认目标员工收到正确的文本和文件。员工依照岗位 skill 处理，在权限范围内查询数据或创建任务，把结果回复到原会话。最后由实际接收人查看回复并打开附件或成果链接，核对内容与输入相符。

外部联系人工具在已启用且获授权时提供独立动作：`list_external_users` 查询联系人，`dispatch_external_user_turn` 向联系人对应会话提交输入并触发员工处理，`send_external_user_message` 经对应渠道发送消息。触发员工处理和直接发送消息的职责不同，发送前要确认对象、内容及授权范围，参见 [任务与编排速查](https://docs.danqiuos.com/reference/orchestration.md)。

邮件入站及 Webhook 属于事件入口，配置和验证见 [计划任务与事件触发](https://docs.danqiuos.com/platform/triggers.md)。邮件入站地址不能视为已具备出站邮件发送能力。

## 结果证据与失败测试

验收保留真实渠道输入、员工执行记录、回复所在会话、接收人查看结果，以及附件或成果可打开的证据。员工生成了内容、工具返回已受理、或任务标成完成，都不能单独证明消息已送达。

测试绑定未完成、无资料权限、附件不可读、连接失效和发送结果不明确的情况。应返回可处理的缺口，保留未完成状态，并由连接或业务责任人处理。消息结果未知时先核查实际会话，不能盲目重复发送。涉及内部成果的外发，还应检查 [工作区与成果](https://docs.danqiuos.com/platform/workspaces.md) 的访问边界。