机器人快速接入
机器人是开放平台应用身份,不是固定系统账号。推荐按以下顺序实现:
- 创建
BOT类型应用并保存凭证。 - 配置机器人资料和最小 Scope。
- 订阅
im.message.receive_v1事件。 - 提交应用,等待进入
ACTIVE。 - 将机器人安装到群或用户会话。
- 使用消息 API 主动发送,或使用回复 API 响应事件。
消息幂等
发送消息时设置业务侧 clientMessageId。接收 Webhook 时至少按 eventId 去重,消息业务逻辑再按 messageId 去重。Webhook 可能因为网络超时被重复投递。
文件消息
图片和文件先调用文件上传接口获得 fileKey,再将 fileKey 放入消息内容。文件大小、有效期和消息类型以 机器人 API V2 为准。