微信WechatTool API
  1. 机器人回调配置
微信WechatTool API
  • 快速入门
  • QA回调接口规范
  • 指令消息
    • 发送消息
      POST
    • 推送任意图片/音视频/文件
      POST
    • 转发消息(小程序)
      POST
    • 发送朋友圈
      POST
    • 删除朋友圈
      POST
    • 创建群
      POST
    • 修改群配置(拉人等)
      POST
    • 解散群
      POST
    • 按手机号添加好友
      POST
    • 从外部群添加好友
      POST
    • 修改好友信息
      POST
    • 获取客户群列表(定制)
      POST
  • 群管理
    • 群列表查询
      GET
  • 机器人配置
    • 获取机器人信息
      GET
    • 查询机器人是否在线
      GET
    • 查询机器人登录日志
      GET
  • 历史消息
    • 指令消息API调用查询
      GET
    • 指令执行结果查询
      GET
    • 机器人消息回调日志列表查询
      GET
  • 回调接口Demo
    • QA回调接口Demo(json)(推荐)
  • 机器人回调配置
    • 机器人消息回调配置
      POST
    • 机器人其他配置回调
      POST
    • 查询机器人回调
      GET
    • 删除机器人回调
      POST
    • 机器人回调接口标准
      POST
  1. 机器人回调配置

机器人回调接口标准

POST
/robot/robotInfo/callBack/test/{{robot_id}}
注:
1.
请开发者开发此回调接口接收数据,返回值响应码应为200,响应内容不限
2.
开发完成后调用【机器人配置回调】将接口地址绑定到机器人
3.
目前只会回调一次且不做失败重试
4.
请提前记录每次调用发送指令消息的返回值(data值为messageId),回调时与此messageId对应
5.
如果一次发送指令含多条串行指令,同一messageId消息会回调多次

错误码列表#

        //指令执行成功
        const val SUCCESS = 0
        //数据格式错误
        const val ERROR_ILLEGAL_DATA = 101011
        //非法操作
        const val ERROR_ILLEGAL_OPERATION = 101012

        //创建群失败
        const val ERROR_CREATE_GROUP = 201011
        //群改名失败
        const val ERROR_GROUP_RENAME = 201012
        //群拉人失败
        const val ERROR_GROUP_ADD_MEMBER = 201013
        //群踢人失败
        const val ERROR_GROUP_REMOVE_MEMBER = 201014
        //改群公告失败
        const val ERROR_GROUP_CHANGE_ANNOUNCEMENT = 201015
        //改群备注失败
        const val ERROR_GROUP_CHANGE_REMARK = 201016
        //查找聊天窗失败
        const val ERROR_INTO_ROOM = 201101
        //发送消息失败
        const val ERROR_SEND_MESSAGE = 201102
        //按钮寻找失败
        const val ERROR_BUTTON = 201103
        //目标寻找失败
        const val ERROR_TARGET = 201104
        //转发失败
        const val ERROR_RELAY = 201105
        //重复添加
        const val ERROR_REPEAT = 201106
        //文件下载异常
        const val ERROR_FILE_DOWNLOAD = 201107
        //文件存储异常
        const val ERROR_FILE_STORAGE = 201108

请求参数

Body 参数application/json
messageId
string 
消息id
必需
errorCode
integer 
错误码
必需
0为成功 其他为失败
errorReason
string 
错误原因
必需
runTime
integer 
执行时间
可选
执行时间戳(毫秒)
timeCost
number 
耗时
可选
指令执行耗时
type
integer 
指令类型
可选
指令类型
rawMsg
string 
原始指令
可选
successList
array[string]
成功名单
可选
成功时不提供
failList
array[string]
失败名单
可选
成功时不提供
示例
{
    "messageId": "990000200110099239",
    "errorCode": 0,
    "errorReason": "",
    "runTime": 1666238534935,
    "timeCost": 2.5,
    "type": 203,
    "rawMsg": "{\"messageId\":\"1582945256466776064\",\"titleList\":[\"第一个接收者\",\"第二个接收者\",\"第三个接收者\"],\"textType\":0,\"receivedContent\":\"测试一下发送消息\",\"type\":203,\"showMessageHistory\":false}",
    "successList": ["第一个接收者","第三个接收者"],
    "failList": ["第二个接收者"]
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request POST 'https://api.worktool.ymdyes.cn/robot/robotInfo/callBack/test/wechattool1' \
--header 'Content-Type: application/json' \
--data-raw '{
    "messageId": "990000200110099239",
    "errorCode": 0,
    "errorReason": "",
    "runTime": 1666238534935,
    "timeCost": 2.5,
    "type": 203,
    "rawMsg": "{\"messageId\":\"1582945256466776064\",\"titleList\":[\"第一个接收者\",\"第二个接收者\",\"第三个接收者\"],\"textType\":0,\"receivedContent\":\"测试一下发送消息\",\"type\":203,\"showMessageHistory\":false}",
    "successList": ["第一个接收者","第三个接收者"],
    "failList": ["第二个接收者"]
}'

返回响应

🟢200成功
application/json
Body
object {0}
示例
{}
上一页
删除机器人回调
Built with