即时通讯渠道

即时通讯渠道可将 T-Agent 接入 Telegram、飞书/Lark、钉钉、微信和企业微信等消息应用； Slack 与 Discord 在当前配置中标记为即将上线。

通用配置顺序

在“设置 > 渠道配置”选择要接入的渠道，先阅读该渠道的字段说明。
使用组织账号在渠道官方后台创建或选择机器人 / 应用；凭据只填写在受控的渠道配置页，不要发送到聊天窗口、截图、文档或任务指令。
选择该渠道要使用的智能体，配置可访问用户、主聊天或允许的群组，再保存并启用。
在目标渠道发送一条无敏感信息的测试消息，确认能收到回复；随后检查权限边界、群聊触发规则和通知是否符合预期。
人员变动、设备遗失、更换机器人或怀疑凭据泄露时，立即停用渠道、撤销旧凭据并重新测试。停用前也要检查是否有定时任务依赖该渠道通知。

在 BotFather 创建机器人后，将 Bot Token 填入渠道配置。 Token 等同于机器人控制权，泄露后应立即在 BotFather 重新生成并替换。私聊通常需要用户先主动向机器人发送消息；群聊需要先把机器人加入群组。若机器人未响应群消息，检查是否开启了隐私模式、是否需要 @机器人 触发，以及群组是否允许该机器人读取消息。

不要把机器人加入包含客户隐私或支付信息的群组，除非已经配置最小访问范围和审批规则。

官方参考：Telegram 机器人入门与 BotFather； Telegram 群组隐私模式。

飞书 / Lark

可按页面选择扫码绑定已有机器人，或手动填写 App ID 与 App Secret。 App Secret 只能由应用管理员在官方后台获取，不能当作普通密码发送。确认应用所在飞书 / Lark 租户与目标用户一致，并在官方后台完成机器人可用范围、事件订阅和消息接收配置。

把机器人加入群聊后，先验证是否要求 @机器人 才响应；仅批准具有权限的配对请求和群组。配置完成后，用测试群验证私聊、群聊、通知和撤销权限后的行为。

官方参考：飞书：创建企业自建应用； Lark：自建应用开发流程。事件接收方式、所需权限和机器人可用范围均应以对应租户的官方后台提示为准。

钉钉

按钉钉开放平台的应用信息填写页面要求的 Client ID / AppKey、 Client Secret / AppSecret 等字段，并在钉钉后台启用机器人、事件订阅或消息接收能力。应用的可见范围决定谁能使用机器人，不要默认开放给全员。

若群中没有响应，依次检查机器人是否已被添加到群、群聊触发方式、回调或 Stream 配置，以及应用是否已发布到目标组织。

官方参考：钉钉：自定义机器人接入。创建方式会因自定义机器人、企业机器人或 Stream 模式而不同；请只使用与当前渠道配置方式匹配的官方文档。

微信

微信渠道通常通过扫码或页面指定的登录方式完成绑定。请使用业务专用、已获授权的账号，不要用个人主账号承载团队自动化；登录状态失效、手机端确认、风控提示或账号更换后都可能导致消息中断。

企业微信

企业微信通常需要管理员在管理后台创建应用，并按页面要求填写 企业 ID（Corp ID）、应用 Agent ID、应用 Secret，以及在启用回调时需要的 Token、EncodingAESKey 与回调地址。每个字段都必须来自同一企业、同一应用；不要混用测试应用和正式应用的凭据。将应用可见范围限制到实际使用部门，确认机器人能收到目标会话事件后再启用自动通知。人员离职或部门权限变更时，同步回收企业微信应用可见范围。

官方参考：企业微信：创建应用与获取应用凭证；企业微信：接收消息与事件回调。回调地址必须可从企业微信访问， Token 与 EncodingAESKey 由同一个回调配置生成并配对使用。

Tyaio · 更新于 2026-09-20