开发须知
基础概念
在开发之前,建议优先浏览开发须知,了解平台的使用逻辑
机器人
机器人可以理解为一个虚拟用户,可以被多个用户添加为好友。不同用户和机器人的对话是相互隔离, 每个机器人拥有两个主要功能:
- 订阅事件功能。任何人发送到机器人的消息都可以推送到订阅URL链接,用于机器人创建者根据用户发送到机器人的消息进行回复。
- 通过机器人发送消息给用户。给机器人的好友用户发送或者回复消息
群
群即常见的群聊功能,每个群也拥有机器人的两个功能,和机器人不同的是,不同用户发送到群的消息任何人都能看到。
接口参数含义说明userId: 用户IDrecvId: 接收消息的用户ID、群IDrecvType: 接收类型,取值user、group
接口调用方式
平台中所有接口都是通过HTTP/HTTPS协议进行数据交互
HTTP Method: POST、GET
授权:所有接口不需要身份验证及登录等操作,部分接口带有token信息,便于接入,
如token信息泄露可以重置
频次限制:注意每个接口有不同的频次控制
机器人开发流程
- 在软件中创建机器人
- 开发订阅消息接收Web程序,将URL填入官网控制台中(系统会自动推送机器人消息到该URL)
- 从官网控制台中查看机器人发送消息URL
- 在订阅消息的Web程序中收到系统推送的消息后,根据消息内容或指令进行消息回复
云湖开放文档