简介
# 简介
## 目的
为了解决机器人登录、绑定、异常状态监听、推送素材（文字消息、图片消息）等功能
## 解决方案
针对以上功能，提供对应的接口，供对接方使用，对接方可根据自己的功能需要，对接不同的接口。
提供的接口如下：
### 微信号登录
主要用于机器人的登录
#### 需要对接方主动请求的接口：
+ 请求二维码
#### 需要对接方接收的接口：
+ 二维码状态监听
+ 微信号登录结果推送
+ 微信号下线监听
### 绑定机器人
通过接收群聊中@该机器人的消息推送，获取到对应的群聊信息，可用于对接方机器人与群聊的绑定与具体推送群聊的确认。
可通过接收机器人退群通知，更新机器人与群聊的绑定关系。
#### 需要对接方接收的接口：
+ @机器人消息响应
+ 群机器人退群通知
### 推送素材
对接方根据需要，进行图片消息或者文本消息的的发送，完成机器人的推送任务
#### 需要对接方主动发起请求的接口：
+ 发送文本消息
+ 发送图片消息
## 具体流程说明
### 微信登录流程接口
>d1.请求二维码接口,请求的时候，traceId参数为用户id
2.处理获取二维码响应（待扫码）返回包括traceId（用户id）和二维码（base64位）
3.处理扫码后响应（登录中）返回包括traceId（用户id）
4.微信号登录成功响应 返回包括traceId（用户id）、uin为微信用户、微信账号信息，需要用户自己保存
5.处理登录异常响应 返回包括traceId（用户id）
### 微信号退出和异常接口
>d1.微信号退出登录响应接口 返回包括traceId（用户id）
2.微信号登录异常 返回包括traceId（用户id）
### 激活机器人流程接口
>d1.处理@群机器人响应接口，会收到这个是用户id、微信号、群id、群名称、群主微信号、群主昵称
2.自己决定是否保存这些信息作为群机器人
### 发送信息接口
>d1.需要发送文本信息就调用文本接口
2.需要发送图片就调用图片接口
3.发送消息都会有个msgid请求参数，这个是用来做消息回执，当消息发送成功或者失败，都会通过发送结果响应这个接口返回
4.发送消息需要uin（微信id）和groupId(群id)，所有登录的时候要保存uin，激活群机器人要保存groupId
### 群机器人退群通知响应
>d1.当这个微信号退群的时候，会调用群机器人退群通知响应接口，返回当前uin（微信id）和groupId(群id），通过这两个参数判断自己的机器人已经失效了。是不是要删除，自己决定。