删除客户或者被客户删除回调

POST

/v1/notify/del/customer

功能说明：

在调用本接口前需要安装自建应用

当用户主动删除或被删时，本接口会将删除的客户信息回调给接收方

⚠重试机制：若回调请求超时，则会重试，最多5次，如果3分钟内有10个回调重试5次全部失败，则禁用回调地址30分钟。
⚠建议收到后回调后进行异步处理，防止处理超时导致我们重复推送。

请求参数

Body 参数application/json

示例

{
    "type": "del_external_contact",
    "event": {
        "ToUserName": "ww5ecc1****dce6e9d",
        "FromUserName": "sys",
        "CreateTime": "1752044091",
        "MsgType": "event",
        "Event": "change_external_contact",
        "ChangeType": "del_follow_user",
        "UserID": "zhangsan",
        "ExternalUserID": "wmrRhyBgAAT*****XBFhZyYxB_FF3Q"
    },
    "data": {
        "unionId": "oDEUm6oVY_D*****q2EoR_Vku12I",
        "name": "",
        "avatar": "http://wx.qlogo.cn/mmhead/eHEMOF2hOemjL4zQT7rQgicicRibAM6T7RveG2diasqXXNFNFACYibicPf5Ygds0GvpVXLq2CntjP0gfo/0",
        "externalUserId": "wmrRhyBgAAT*****XBFhZyYxB_FF3Q",
        "gender": 1,
        "type": 1,
        "followUser": [
            {
                "userId": "zhangsan",
                "name": "张三1234",
                "remark": "f",
                "avatar": "",
                "createTimestamp": 1751888057000,
                "state": "",
                "tags": [
                    {
                        "groupName": "测试企微标签组排序444",
                        "tagName": "WWWWWWWWWWWWWWW",
                        "type": "1",
                        "tagId": "etrRhyBgAA6Xqi9RlUp4PAEwpF2dVTqQ"
                    }
                ],
                "remarkMobiles": [
                    "131******06"
                ]
            }
        ]
    },
    "timestamp": 1752044091559
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://zan-hub.xiaoshunai.com/v1/notify/del/customer' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": "del_external_contact",
    "event": {
        "ToUserName": "ww5ecc1****dce6e9d",
        "FromUserName": "sys",
        "CreateTime": "1752044091",
        "MsgType": "event",
        "Event": "change_external_contact",
        "ChangeType": "del_follow_user",
        "UserID": "zhangsan",
        "ExternalUserID": "wmrRhyBgAAT*****XBFhZyYxB_FF3Q"
    },
    "data": {
        "unionId": "oDEUm6oVY_D*****q2EoR_Vku12I",
        "name": "",
        "avatar": "http://wx.qlogo.cn/mmhead/eHEMOF2hOemjL4zQT7rQgicicRibAM6T7RveG2diasqXXNFNFACYibicPf5Ygds0GvpVXLq2CntjP0gfo/0",
        "externalUserId": "wmrRhyBgAAT*****XBFhZyYxB_FF3Q",
        "gender": 1,
        "type": 1,
        "followUser": [
            {
                "userId": "zhangsan",
                "name": "张三1234",
                "remark": "f",
                "avatar": "",
                "createTimestamp": 1751888057000,
                "state": "",
                "tags": [
                    {
                        "groupName": "测试企微标签组排序444",
                        "tagName": "WWWWWWWWWWWWWWW",
                        "type": "1",
                        "tagId": "etrRhyBgAA6Xqi9RlUp4PAEwpF2dVTqQ"
                    }
                ],
                "remarkMobiles": [
                    "131******06"
                ]
            }
        ]
    },
    "timestamp": 1752044091559
}'

返回响应

🟢200成功

application/json

Body

示例

{}

修改于 2025-09-02 16:39:07

客户信息变更回调