diff --git a/docs/IM集成开发文档.md b/docs/IM集成开发文档.md index 117ae1c1..810da38d 100644 --- a/docs/IM集成开发文档.md +++ b/docs/IM集成开发文档.md @@ -419,7 +419,9 @@ curl -X POST "https://api.telegram.org/bot/setWebhook" \ **第二步:配置机器人** 1. 在应用详情页 → **机器人** → 配置消息接收模式为 **Stream 模式** -2.(可选)如需流式 AI 卡片效果,在 **互动卡片** 中创建一个 **AI 卡片模板**,记录 **Card Template ID** +2. 如需识别用户发送的图片,在钉钉控制台为应用授予机器人消息文件下载所需权限,并在 WeKnora Agent 配置中启用**图片上传/多模态** +3.(可选)如需流式 AI 卡片效果,在 **互动卡片** 中创建一个 **AI 卡片模板**,记录 **Card Template ID** +4. 如需点赞/点踩和转人工,在卡片模板中配置互动按钮,按钮参数使用 `action=like`、`action=dislike`、`action=unresolved` 或 `action=handoff`;点踩原因可附加 `reason` 参数 **第三步:在 WeKnora 中添加 IM 渠道** @@ -431,6 +433,7 @@ curl -X POST "https://api.telegram.org/bot/setWebhook" \ - **Client ID**:填入 AppKey - **Client Secret**:填入 AppSecret - **Card Template ID**(可选):填入 AI 卡片模板 ID,启用后流式回复将以 AI 卡片形式展示 + - **技术支持群 openConversationId**(可选):配置后,转人工工单会自动推送到该群;可让机器人先加入支持群并从该群消息回调的 `conversationId` 获取 3. 保存 启动后日志出现以下内容表示连接成功: @@ -439,7 +442,7 @@ curl -X POST "https://api.telegram.org/bot/setWebhook" \ [IM] DingTalk Stream connecting... ``` -> **关于 AI 卡片**:配置 Card Template ID 后,流式回复将通过钉钉 AI 卡片实时展示打字效果;未配置时流式内容将在结束后一次性发送。 +> **关于 AI 卡片**:配置 Card Template ID 后,流式回复将通过钉钉 AI 卡片实时展示打字效果;未配置时流式内容将在结束后一次性发送。点赞/点踩/转人工回调使用钉钉 Stream 卡片回调,需保持渠道为 WebSocket/Stream 模式。 ---