账号托管事件回调

POST

功能说明：

本接口为回调接口，用户配置完成该回调后，当新增托管账号、托管账号离线、删除托管账号、托管账号数据同步中等状态时，本接口都会向指定接收地址推送具体报文信息。

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

请求参数

Body 参数application/json

示例

{
    "token": "66fe7b0b027b42******fb3236c230e5",
    "eventType": 3,
    "logoutReason": "",
    "bot": {
        "wecomUserId": "dhtest2",
        "partnerOrgId": "",
        "botCorpId": "19703****5115309",
        "orgCorpId": "ww5ecc****5dce6e9d",
        "botId": "6864eaad3c****4df4520e3c",
        "imBotId": "16888****1477771",
        "orgId": "646d818baf****75124fabde",
        "status": 1,
        "name": "test_bot_name",
        "avatar": "https://qpic.cn/wwpic3az/454947_Dxaq84oaRC26kAP_1746723656/0",
        "type": 2,
        "group": {
            "groupId": "64758f02111f3bf9615998f1",
            "groupName": "test"
        }
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://zan-hub.xiaoshunai.com' \
--header 'Content-Type: application/json' \
--data-raw '{
    "token": "66fe7b0b027b42******fb3236c230e5",
    "eventType": 3,
    "logoutReason": "",
    "bot": {
        "wecomUserId": "dhtest2",
        "partnerOrgId": "",
        "botCorpId": "19703****5115309",
        "orgCorpId": "ww5ecc****5dce6e9d",
        "botId": "6864eaad3c****4df4520e3c",
        "imBotId": "16888****1477771",
        "orgId": "646d818baf****75124fabde",
        "status": 1,
        "name": "test_bot_name",
        "avatar": "https://qpic.cn/wwpic3az/454947_Dxaq84oaRC26kAP_1746723656/0",
        "type": 2,
        "group": {
            "groupId": "64758f02111f3bf9615998f1",
            "groupName": "test"
        }
    }
}'

返回响应

🟢200成功

application/json

Body

示例

{}

修改于 2025-11-19 12:23:08

获取企业内各小组托管账号信息

新建托管账号