收到好友申请事件

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

对方微信昵称

必需

示例值:

对方微信昵称

string

必需

V3数据同意好友验证时使用

示例值:

v3_020b3826fd0301000000000070a61470bbfdda000000501ea9a3dba12f95f6b60a0536a1adb6443c5bb8c2efda9a0e3081c0ad7a00f4557eaadc402ed0ded26c4b9cde7641ca1f7782b77b31d1fd7f7585158466cedbb7a38e4790b6614cfe98a64928@stranger

string

必需

V4数据同意好友验证时使用

示例值:

v4_000b708f0b0400000100000000005e2196a850ec772301c1998f51661000000050ded0b020927e3c97896a09d47e6e9e96383fd759a53aa3cc1b6a11e532cc4a02c2e79cef4d5661fec6faaf5b3d4f0ddf5c384d4f7f2ae3940d880ef2478eda8415339b67d6c417882daf8e4bc8ee3a415a52b875a5392a91c9080c7b353759ca1ec5d97db50460088a86ead44984a8d4a81d2b9e9f451555@stranger

sign

string

签名

必需

示例值:

签名

country

string

国家

必需

province

string

省份

必需

city

string

城市

必需

avatarMinUrl

string

头像小图

必需

avatarMaxUrl

string

头像大图

必需

sex

string

必需

性别，0=未知，1=男，2=女

示例值:

content

string

附言

必需

scene

string

必需

来源，同意好友请求时使用，1=qq 3=微信号 6=单向添加 10和13=通讯录 14=群聊 15=手机号 17=名片 30=扫一扫

示例值:

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

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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-03-10 17:33:20

好友删除事件

登录二维码事件