机器人概述
IM PaaS 提供 AI 机器人管理能力，基于指定机器人提供更加详细的事件回调能力，方便开发者针对不同事件进行业务处理逻辑，如与机器人单聊沟通，@机器人消息等。同时提供机器人与 AI 平台的对接能力，减少客户对接 AI 平台的中间处理环节，提升链路稳定性、降低开发者实现成本。
💡 使用场景
-
实现自动化客服、智能回复、业务提醒等 IM 消息处理能力，提升用户体验与运营效率。
-
单聊机器人助手：通过私聊与机器人对话，触发智能对话、任务执行、内容生成等功能，适用于：
- 用户向 AI 提问知识类问题，机器人通过知识库或大模型进行回答；
- 发起智能操作请求，如“帮我写一封道歉邮件”、“生成周报摘要”；
- 查询个人事务，如“我今天还有哪些未完成的任务”。
-
群聊 @机器人 智能处理：在群聊中通过 @ 机器人，触发 AI 能力或业务流程，例如：
- FAQ 问答：解析用户意图并自动回复；
- 工单创建：识别需求并提交至工单系统；
- 日程提醒：识别时间表达并添加到日历服务。
-
集成 AI Agent 平台（如 Dify）：
- Dify 是一个开源 AI Agent 平台，支持接入 OpenAI、Claude、Gemini 等多种大模型；
- 可通过机器人集成实现多轮对话、Function Call、知识库问答、RPA 流程等；
- 无需 自行搭建模型服务，即可实现 AI 聊天助手、客服机器人、流程执行代理等高级功能；
- 适用于“IM + 大模型”的快速落地。
-
Webhook 集成自研/私有大模型：
- 客户可通过 Webhook 回调自由对接自建服务（如私有部署的 LLM、LangChain、RAG 检索系统等）；
- 适合需要高度定制化、私有化部署、安全隔离等场景；
- 实现灵活的消息接入、参数定制、响应策略，构建专属智能助手。
机器人数据模型
下表显示了机器人资源中的属性列表。
| 属性名称 | 类型 | 说明 |
|---|---|---|
userId | String | 机器人的唯一 ID，长度限制为 64 个字符。 |
name | String | 机器人的昵称，长度限制为 128 个字符。 |
type | String | 指定机器人的类型，以便对机器人进行分类。长度限制为 128 个字符。 |
profileUrl | String | 指定机器人头像的 URL。长度限制为 256 个字符。 |
integrations | Array<Object> | 集成平台配置列表，可配置多个平台（如 webhook、dify）。 |
integrations.enabled | Boolean | 是否启用该集成项。 |
integrations.type | String | 集成类型，可选值详见 回调类型列表。 |
integrations.callbackUrl | String | 该平台的回调地址。用于接收用户消息或事件通知。 |
integrations.objectNames | Array<String> | 指定要监听的消息类型，可选值详见 消息类型列表。 |
integrations.events | Array<String> | 指定触发事件类型，可选值详见 事件类型列表。 |
integrations.stream | Boolean | 是否启用流式响应（适用于如 dify 等平台）。默认 true。 |
integrations.handleResponse | Boolean | 是否处理第三方返回结果（适用于如 dify 等平台），默认 true。 |
integrations.auth.apiKey | String | 第三方平台的认证信息，通常是 API Key（如接入 Dify 所需）。仅当该平台需要认证时填写。 |
metadata | Map<String, String> | 自定义键值对，应指定为 Map 对象格式。长度为 16 对键值对，其中键（key）的长度范围为 1～32 个字符，值（value）的长度范围为 1～128 个字符。 |
机器人回调事件
用于标识机器人接收到的触发场景。支持以下事件：
| 事件类型 | 说明 |
|---|---|
message:private | 用户发送私聊消息给机器人时触发。通常用于 1v1 对话场景。 |
message:group_mentioned | 机器人在群聊中被 @ 提及时触发。适用于群组协作类助手型 Bot。 |
机器人回调类型
用于将机器人集成到不同平台或系统中，当前支持以下回调方式：
| 类型 | 描述 |
|---|---|
webhook | 通过 Webhook 实现自定义回调，适用于灵活对接外部系统。详见：Webhook 回调。 |
dify_chat | 接入 Dify 平台的“聊天助手”模式，用于构建多轮对话机器人。详见：Dify 回调。 |
dify_completion | 接入 Dify 平台的“文本生成”模式，用于生成式内容应用场景。详见：Dify 回调。 |
dify_chatflow | 接入 Dify 平台的“Chatflow”模式，用于流程化对话构建。详见：Dify 回调。 |
📘 Dify 相关集成类型均共用同一接入方式，详见上方链接。
机器人管理接口
| 功能分类 | 功能描述 | 服务端 API 名称 |
|---|---|---|
| 创建机器人 | 创建应用下的机器人，并配置回调事件，支持自定义业务逻辑处理。 | 创建机器人 |
| 更新机器人 | 修改机器人的基本信息（如名称、头像、描述等）。 | 更新机器人 |
| 删除机器人 | 删除指定机器人及其回调配置，删除后不再接收该机器人 ID 的事件推送。 | 删除机器人 |
| 列出机器人列表 | 获取当前应用下已创建的机器人列表。 | 列出机器人列表 |
| 获取指定机器人 | 获取当前应用下指定机器人列表。 | 获取指定机器人 |
| 添加机器人回调配置 | 添加一个第三方机器人集成平台（如webhook Dify等），用于统一调度与消息转发。 | 添加机器人回调配置 |
| 更新机器人回调配置 | 更新已添加的集成平台的配置信息 | 更新机器人回调配置 |
| 删除机器人回调配置 | 删除某个已配置的机器人集成平台，移除其相关资源配置。 | 删除机器人回调配置 |