客户信息变更回调

POST

/v1/notify/change/customer/info

功能说明：

本接口需要提前安装自建应用或待开发应用才可以进行回调！

当客户核心信息发生改变时、本接口会将信息回调给接收方

变更信息包括：客户昵称、头像、标签等

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

请求参数

Body 参数application/json

示例

{
    "type": "edit_external_contact",
    "event": {
        "ToUserName": "ww5ecc*****dce6e9d",
        "FromUserName": "sys",
        "CreateTime": "1752040718",
        "MsgType": "event",
        "Event": "change_external_contact",
        "ChangeType": "edit_external_contact",
        "UserID": "zhangsan",
        "ExternalUserID": "wmrRhyBgAApg*****xMGQH_JIYMPvkw"
    },
    "data": {
        "unionId": "oDEUm6s77*****F6TFcs8wZ3AVtw",
        "name": "Freedom",
        "avatar": "http://qlogo.cn/mmhead/dx4Y70y9XcvkIUiaiaI2icdibMricwLFcoFVJzr4uZHUDJgluEyGBqB5A6icrFgTFJmbsGw8wJQhIAnqY/0",
        "externalUserId": "wmrRhyBgAA******QdxMGQH_JIYMPvkw",
        "gender": 1,
        "type": 1,
        "followUser": [
            {
                "userId": "zhangsan",
                "name": "",
                "remark": "测试随机张三123",
                "avatar": "http://qlogo.cn/mmhead/dx4Y70y9XcvkIUiaiaI2icdibMricwLFcoFVJzr4uZHUDJgluEyGBqB5A6icrFgTFJmbsGw8wJQhIAnqY/0",
                "createTimestamp": 1716360119000,
                "state": "",
                "tags": [
                    {
                        "groupName": "测试企微标签组排序444",
                        "tagName": "WWWWWWWWWWWWWWW",
                        "type": "1",
                        "tagId": "etrRhyBgAA6Xqi9RlUp4PAEwpF2dVTqQ"
                    }
                ],
                "remarkMobiles": [
                    "131****1213"
                ]
            }
        ]
    },
    "timestamp": 1752040719720
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://zan-hub.xiaoshunai.com/v1/notify/change/customer/info' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": "edit_external_contact",
    "event": {
        "ToUserName": "ww5ecc*****dce6e9d",
        "FromUserName": "sys",
        "CreateTime": "1752040718",
        "MsgType": "event",
        "Event": "change_external_contact",
        "ChangeType": "edit_external_contact",
        "UserID": "zhangsan",
        "ExternalUserID": "wmrRhyBgAApg*****xMGQH_JIYMPvkw"
    },
    "data": {
        "unionId": "oDEUm6s77*****F6TFcs8wZ3AVtw",
        "name": "Freedom",
        "avatar": "http://qlogo.cn/mmhead/dx4Y70y9XcvkIUiaiaI2icdibMricwLFcoFVJzr4uZHUDJgluEyGBqB5A6icrFgTFJmbsGw8wJQhIAnqY/0",
        "externalUserId": "wmrRhyBgAA******QdxMGQH_JIYMPvkw",
        "gender": 1,
        "type": 1,
        "followUser": [
            {
                "userId": "zhangsan",
                "name": "",
                "remark": "测试随机张三123",
                "avatar": "http://qlogo.cn/mmhead/dx4Y70y9XcvkIUiaiaI2icdibMricwLFcoFVJzr4uZHUDJgluEyGBqB5A6icrFgTFJmbsGw8wJQhIAnqY/0",
                "createTimestamp": 1716360119000,
                "state": "",
                "tags": [
                    {
                        "groupName": "测试企微标签组排序444",
                        "tagName": "WWWWWWWWWWWWWWW",
                        "type": "1",
                        "tagId": "etrRhyBgAA6Xqi9RlUp4PAEwpF2dVTqQ"
                    }
                ],
                "remarkMobiles": [
                    "131****1213"
                ]
            }
        ]
    },
    "timestamp": 1752040719720
}'

返回响应

🟢200成功

application/json

Body

示例

{}

修改于 2025-09-02 16:38:55

新增客户回调—RPA

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