StarBot 标准版本买断
  1. 好友事件回调
StarBot 标准版本买断
  • 文档必读
    • 文档说明
    • 风控说明
    • 使用说明
    • 版本对比
    • 下一版本预览
    • 环境安装说明
  • 个人微信
    • 监听回调事件
      • 群事件回调
        • 群成员新增事件
        • 群成员删除/退出事件
        • 群创建成功事件
        • 退群/被踢事件
      • 好友事件回调
        • 好友新增事件
          POST
        • 好友删除事件
          POST
        • 收到好友申请事件
          POST
      • 登录回调
        • 微信登录成功事件
        • 微信账号注销事件
      • 机器人相关回调
        • 登录的机器人->微信启动成功
      • 收到私聊消息事件
        POST
      • 收到转账事件
        POST
      • 收到撤回消息事件
        POST
      • 二维码收款事件
        POST
      • 收到公众号消息事件
        POST
      • 收到群聊消息事件
        POST
    • api请求
      • 发送消息
        • 发送文本消息@所有人
        • 发送文本消息 @指定人
        • 发送文本消息
        • 发送图片消息
        • 发送视频消息
        • 发送文件消息
        • 发送动态表情GIF消息
        • 发送url卡片消息
        • 发送url卡片消息1
        • 发送名片xml消息
        • 发送名片消息
        • 发送xml消息
        • 发送小程序消息
        • 发送音乐分享消息
        • 回复引用文本消息-新
        • 撤回消息
      • rpa消息
      • 好友相关接口
        • 同意好友申请
        • 添加好友(搜索的微信用户)
        • 删除好友
        • 修改好友/群聊备注
        • 查询陌生账号信息
        • 获取好友列表
        • 查询指定好友信息
      • 登录相关接口
        • 获取/刷新登录二维码信息
      • 群相关接口
        • 从群里添加好友
        • 退出群聊
        • 创建群聊
        • 查询群聊信息(协议)
        • 查询群聊成员列表
        • 获取群聊列表
        • 添加群成员(邀请好友进群)(40人以下)
        • 邀请群成员(需要好友同意)
        • 移除群成员
        • 修改机器人群昵称
        • 修改群名称
        • 保存到/移出通讯录
        • 查询群聊信息(有群成员详细信息)
      • 机器人相关接口
        • 删除离线的机器人信息(适配)
        • 获取机器人列表
        • 根据wxId获取机器人信息
        • 根据instanceId获取机器人信息
        • 获取机器人信息
      • 微信相关接口
        • 启动微信
        • 关闭/退出微信
      • 转账相关
        • 确认收款
      • 发送聊天记录消息
      • 解密图片
      • 获取本地图片Base64(根据本地图片路径获取Base64)
  • 更新日志
    • 更新日志
  • 插件敏感词审核机制
    • 客户端敏感词审核算法
  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
chatRoomUserName
string 
必需
sourceUserName
string 
必需
shareCardUserName
string 
必需
shareCardNickName
string 
必需
rawMessage
string 
必需
示例
{
    "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",
        "chatRoomUserName": "string",
        "sourceUserName": "string",
        "shareCardUserName": "string",
        "shareCardNickName": "string",
        "rawMessage": "string"
    }
}

示例代码

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",
        "chatRoomUserName": "string",
        "sourceUserName": "string",
        "shareCardUserName": "string",
        "shareCardNickName": "string",
        "rawMessage": "string"
    }
}'

返回响应

🟢200成功
application/json
Body
object {0}
示例
{}
修改于 2025-02-11 03:00:49
上一页
好友删除事件
下一页
微信登录成功事件
Built with