一、接入准备 ​

1、开发须知： ​

基础概念 ​

在开发之前，建议优先浏览开发须知，了解平台的使用逻辑。

机器人 ​

机器人可以理解为一个虚拟用户，可以被多个用户添加为好友。不同用户和机器人的对话是相互隔离。 每个机器人拥有两个主要功能：

1.订阅事件功能：任何人发送到机器人的消息都可以推送到订阅URL链接，用于机器人创建者根据用户发送到机器人的消息进行回复。

2.通过机器人发送消息给用户。给机器人的好友用户发送或者回复消息。

群 ​

群即常见的群聊功能，每个群也拥有机器人的两个功能，和机器人不同的是，不同用户发送到群的消息任何人都能看到。

接口参数含义说明 ​

fromUserId: 消息发送者ID

toUserId: 接收消息的用户ID

jidArr:接收消息的群组ID

type: 消息类型

content: 消息正文

接口调用方式 ​

平台中所有接口都是通过HTTPS协议进行数据交互。

HTTP Method： POST。

授权：接口通过token鉴权。

频次限制：注意每个接口有不同的频次控制。

机器人开发流程 ​

1.在家聊IM能力开放平台注册为开发者，创建机器人应用并填写三方消息推送的url（系统会自动推送机器人消息到该URL），管理员审核成功后会返回机器人appId与appSecret用于接口鉴权。

2.在订阅消息的Web程序中收到系统推送的消息后，根据消息内容或指令进行消息回复。

2、服务端API列表: ​

当前机器人涉及接口

3、服务端错误代码: ​

文档更新中

二、接口调用： ​

文档更新中

三、事件订阅： ​

文档更新中