IM 集成

把 Datyo 接入 IM，实现两件事：

1. 群内 / 私聊问数：直接给机器人发消息或在群里 @它提问，回答返回到对话中；
2. 定时推送：定时巡检任务的结果按时推到群里。

支持 钉钉、飞书、企业微信、个人微信。集成绑定在工作空间上，机器人会复用该空间的数据集与业务口径。

各平台接入方式

平台	接入方式	需要公网	说明
钉钉	创建 Stream 模式机器人，填入 Client ID / Secret	否（旧版 Outgoing 接收才需回调地址）	支持私聊与群内 @；定时推送推荐另配群机器人 Webhook
飞书	创建应用（长连接），填入 App ID / Secret	否	支持私聊与群聊
Slack	Socket Mode 应用，填入 Bot Token / App-Level Token	否	支持 DM 与频道 @
企业微信	自建应用，配置回调地址	是	需把回调地址填到企业微信后台
个人微信	扫码登录	否	仅保证私聊；群消息受平台限制

钉钉、飞书、Slack、个人微信通过出站长连接接入，无需公网地址；企业微信因平台限制需要一个可访问的回调地址。

通用步骤

1. 进入工作空间的 集成 设置，选择平台；
2. 按表单填写该平台所需信息（密钥类会打码保存）：
   • 钉钉：在钉钉开发者后台创建 Stream 模式机器人，复制 Client ID 与 Client Secret；
   • 飞书：在飞书开放平台创建应用，复制 App ID 与 App Secret，并开启接收消息权限；
   • Slack：在 api.slack.com 创建应用并开启 Socket Mode（生成 xapp- App-Level Token，勾选 connections:write）；在 OAuth & Permissions 给 Bot 添加 chat:write、app_mentions:read、im:history、files:write 权限并安装到工作区（得到 xoxb- Bot Token）；在 Event Subscriptions 订阅 app_mention 与 message.im 两个 Bot 事件；把两个 Token 填入表单；
   • 企业微信：在企业微信后台创建自建应用，填入企业 ID、AgentId、Secret、回调 Token 与 EncodingAESKey，并把页面给出的回调地址配置到企业微信后台；
   • 个人微信：保存后点击「扫码登录」，用手机微信扫码完成连接；
3. 启用集成，发送一条消息测试。

访问控制

• 允许的用户：可在集成里填写「允许的用户 ID」（逗号分隔）。设置后只有这些用户能与机器人对话。
• 群内 @ 才回：群聊默认只有 @机器人 时才回应，避免打扰；私聊始终直接回应。
• 会话隔离：私聊每人一个独立上下文；群里默认每个成员在该群内拥有独立上下文，互不串话。

群内问数与多轮追问

发送消息（群里需 @机器人）即可提问，例如「昨天的退款率」。对话保留上下文，可以继续追问 「再按渠道拆一下」，机器人会承接上一轮结果。

定时结果推送

在定时巡检任务里勾选推送渠道，任务结果会自动推到已接入的群或会话。

各平台的推送目标填法不同：

• 钉钉：推荐在群里添加「自定义机器人」（安全设置选加签），把钉钉生成的 Webhook 地址与加签 Secret 填入集成表单；
• 飞书 / Slack：机器人入群并收到过消息后，直接在「推送目标」里选择该群/频道；
• 企业微信：推送目标填成员 userid；
• 个人微信：推送目标填对方用户 ID。

关于个人微信

个人微信通过扫码登录接入，仅保证私聊可用；由于平台限制，扫码身份通常收不到普通微信群的消息。 如果需要稳定的群能力，建议使用企业微信。