跳到主要内容

机器人快速接入

机器人是开放平台应用身份,不是固定系统账号。推荐按以下顺序实现:

  1. 创建 BOT 类型应用并保存凭证。
  2. 配置机器人资料和最小 Scope。
  3. 订阅 im.message.receive_v1 事件。
  4. 提交应用,等待进入 ACTIVE
  5. 将机器人安装到群或用户会话。
  6. 使用消息 API 主动发送,或使用回复 API 响应事件。

消息幂等

发送消息时设置业务侧 clientMessageId。接收 Webhook 时至少按 eventId 去重,消息业务逻辑再按 messageId 去重。Webhook 可能因为网络超时被重复投递。

文件消息

图片和文件先调用文件上传接口获得 fileKey,再将 fileKey 放入消息内容。文件大小、有效期和消息类型以 机器人 API V2 为准。