StarBot
  1. 监听回调事件
StarBot
  • 文档必读
    • 文档说明
    • 风控说明
    • 使用说明
    • 版本对比
  • 监听回调事件
    • 登录的机器人->微信启动成功
      POST
    • 微信登录成功事件
      POST
    • 收到私聊消息事件
      POST
    • 收到群聊消息事件
      POST
    • 收到公众号消息事件
      POST
    • 收到转账事件
      POST
    • 收到撤回消息事件
      POST
    • 收到好友申请事件
      POST
    • 二维码收款事件
      POST
  • api请求
    • 获取群聊列表
      POST
    • 获取好友列表
      POST
    • 获取机器人信息
      POST
    • 发送文本消息
      POST
    • 回复引用文本消息
      POST
    • 回复引用文本消息-新
      POST
    • 发送图片消息
      POST
    • 发送xml消息
      POST
    • 发送文件消息
      POST
    • 发送动态表情GIF消息
      POST
    • 发送url卡片消息
      POST
    • 发送小程序消息
      POST
    • 发送音乐分享消息
      POST
    • 发送聊天记录消息
      POST
    • 发送名片消息
      POST
    • 发送名片xml消息
      POST
    • 获取机器人登录状态信息
      POST
    • 获取机器人登录二维码信息(存在bug)请转至买断版本
      POST
    • 同意好友申请
      POST
    • 添加好友
      POST
    • 从群里添加好友
      POST
    • 删除好友
      POST
    • 修改好友/群聊备注
      POST
    • 查询陌生账号信息
      POST
    • 查询好友/群聊信息
      POST
    • 退出群聊
      POST
    • 创建群聊
      POST
    • 查询群聊信息
      POST
    • 添加群成员
      POST
    • 邀请群成员
      POST
    • 移除群成员
      POST
    • 修改机器人群昵称
      POST
    • 查询群聊成员列表
      POST
    • 获取群成员昵称
      POST
    • 确认收款
      POST
    • 退还收款
      POST
    • 打开浏览器
      POST
    • 启动微信
      POST
    • 关闭微信
      POST
    • 获取机器人列表
      POST
    • 删除离线的机器人信息
      POST
    • 根据wxId获取机器人信息
      POST
    • 根据instanceId获取机器人信息
      POST
  1. 监听回调事件

收到好友申请事件

POST
http://callbackurl

请求参数

Body 参数application/json
event
enum<string> 
事件类型
必需
枚举值:
10007
description
string 
事件描述
必需
示例值:
好友申请事件
time
integer 
毫秒时间戳
必需
示例值:
1726826627676
data
object 
数据体
必需
robotId
string 
消息来源
必需
机器人微信ID
示例值:
机器人微信id
instanceId
string 
实例id
必需
示例值:
97554f7c82a1439c86df3143ef4975c5
messageId
string 
消息id
必需
示例值:
6912269877584593037
fromWxId
string 
对方微信id
必需
示例值:
对方微信id
wxNum
string 
对方微信号
必需
示例值:
对方微信号
nickname
string 
对方微信昵称
必需
示例值:
对方微信昵称
v3
string 
必需
V3数据 同意好友验证时使用
示例值:
v3_020b3826fd0301000000000070a61470bbfdda000000501ea9a3dba12f95f6b60a0536a1adb6443c5bb8c2efda9a0e3081c0ad7a00f4557eaadc402ed0ded26c4b9cde7641ca1f7782b77b31d1fd7f7585158466cedbb7a38e4790b6614cfe98a64928@stranger
v4
string 
必需
V4数据 同意好友验证时使用
示例值:
v4_000b708f0b0400000100000000005e2196a850ec772301c1998f51661000000050ded0b020927e3c97896a09d47e6e9e96383fd759a53aa3cc1b6a11e532cc4a02c2e79cef4d5661fec6faaf5b3d4f0ddf5c384d4f7f2ae3940d880ef2478eda8415339b67d6c417882daf8e4bc8ee3a415a52b875a5392a91c9080c7b353759ca1ec5d97db50460088a86ead44984a8d4a81d2b9e9f451555@stranger
sign
string 
签名
必需
示例值:
签名
country
string 
国家
必需
province
string 
省份
必需
city
string 
城市
必需
avatarMinUrl
string 
头像小图
必需
avatarMaxUrl
string 
头像大图
必需
sex
string 
必需
性别，0=未知，1=男，2=女
示例值:
1
content
string 
附言
必需
scene
string 
必需
来源，同意好友请求时使用，1=qq 3=微信号 6=单向添加 10和13=通讯录 14=群聊 15=手机号 17=名片 30=扫一扫
示例值:
13
示例
{
    "event": "10007",
    "description": "好友申请事件",
    "time": 1726826627676,
    "data": {
        "robotId": "机器人微信id",
        "instanceId": "97554f7c82a1439c86df3143ef4975c5",
        "messageId": "6912269877584593037",
        "fromWxId": "对方微信id",
        "wxNum": "对方微信号",
        "nickname": "对方微信昵称",
        "v3": "v3_020b3826fd0301000000000070a61470bbfdda000000501ea9a3dba12f95f6b60a0536a1adb6443c5bb8c2efda9a0e3081c0ad7a00f4557eaadc402ed0ded26c4b9cde7641ca1f7782b77b31d1fd7f7585158466cedbb7a38e4790b6614cfe98a64928@stranger",
        "v4": "v4_000b708f0b0400000100000000005e2196a850ec772301c1998f51661000000050ded0b020927e3c97896a09d47e6e9e96383fd759a53aa3cc1b6a11e532cc4a02c2e79cef4d5661fec6faaf5b3d4f0ddf5c384d4f7f2ae3940d880ef2478eda8415339b67d6c417882daf8e4bc8ee3a415a52b875a5392a91c9080c7b353759ca1ec5d97db50460088a86ead44984a8d4a81d2b9e9f451555@stranger",
        "sign": "签名",
        "country": "string",
        "province": "string",
        "city": "string",
        "avatarMinUrl": "string",
        "avatarMaxUrl": "string",
        "sex": "1",
        "content": "string",
        "scene": "13"
    }
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://callbackurl' \
--header 'Content-Type: application/json' \
--data-raw '{
    "event": "10007",
    "description": "好友申请事件",
    "time": 1726826627676,
    "data": {
        "robotId": "机器人微信id",
        "instanceId": "97554f7c82a1439c86df3143ef4975c5",
        "messageId": "6912269877584593037",
        "fromWxId": "对方微信id",
        "wxNum": "对方微信号",
        "nickname": "对方微信昵称",
        "v3": "v3_020b3826fd0301000000000070a61470bbfdda000000501ea9a3dba12f95f6b60a0536a1adb6443c5bb8c2efda9a0e3081c0ad7a00f4557eaadc402ed0ded26c4b9cde7641ca1f7782b77b31d1fd7f7585158466cedbb7a38e4790b6614cfe98a64928@stranger",
        "v4": "v4_000b708f0b0400000100000000005e2196a850ec772301c1998f51661000000050ded0b020927e3c97896a09d47e6e9e96383fd759a53aa3cc1b6a11e532cc4a02c2e79cef4d5661fec6faaf5b3d4f0ddf5c384d4f7f2ae3940d880ef2478eda8415339b67d6c417882daf8e4bc8ee3a415a52b875a5392a91c9080c7b353759ca1ec5d97db50460088a86ead44984a8d4a81d2b9e9f451555@stranger",
        "sign": "签名",
        "country": "string",
        "province": "string",
        "city": "string",
        "avatarMinUrl": "string",
        "avatarMaxUrl": "string",
        "sex": "1",
        "content": "string",
        "scene": "13"
    }
}'

返回响应

🟢200成功
application/json
Body
object {0}
示例
{}
修改于 2024-09-24 05:27:40
上一页
收到撤回消息事件
下一页
二维码收款事件
Built with