加入群聊事件回调

POST

/room/joined

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

请求参数

Body 参数application/json

示例

{
    "token": "669dc78a7****23e04351d6",
    "avatarUrl": "https://workmate.s3.cn-northwest-1.amazonaws.com.cn/room_avatar/1c16b66c-8a00-4754-9f64-a1c71c14e863/10882094539049797.png",
    "botInfo": {
        "botId": "66a77970c****6b879ef868",
        "imBotId": "168885****578438",
        "wecomUserId": "zhangsan",
        "nickName": "张三1234"
    },
    "chatId": "685bd3c3e****c8657fb492e",
    "joinedMember": [
        {
            "avatarUrl": "https://wx.qlogo.cn/mmhead/eHEMOF2hOemjL4zQT7rQgicicRibAM6T7RveG2diasqXXNFNFACYibicPf5Ygds0GvpVXLq2CntjP0gfo/0",
            "contactType": 1,
            "coworker": false,
            "isFriend": true,
            "nickName": "f",
            "roomAlias": null,
            "imContactId": "78813****9110143",
            "joinTime": 1752115629,
            "isSelf": false
        }
    ],
    "inviter": {
        "avatarUrl": "https://wework.qpic.cn/wwpic3az/375283_30QqeKdzQkKC_kj_1752047248/0",
        "contactType": 3,
        "coworker": true,
        "isFriend": true,
        "nickName": "张三4321",
        "roomAlias": "马云飞",
        "imContactId": "16888****578438",
        "joinTime": 1750848444,
        "isSelf": true
    },
    "ownerImContactId": "168885****644281",
    "topic": "20250625群聊1-1",
    "imRoomId": "R:108820****9049797",
    "groupId": "64758f02111f3bf9615998f1",
    "timestamp": 1752115635653
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://zan-api.xiaoshunai.com/room/joined' \
--header 'Content-Type: application/json' \
--data-raw '{
    "token": "669dc78a7****23e04351d6",
    "avatarUrl": "https://workmate.s3.cn-northwest-1.amazonaws.com.cn/room_avatar/1c16b66c-8a00-4754-9f64-a1c71c14e863/10882094539049797.png",
    "botInfo": {
        "botId": "66a77970c****6b879ef868",
        "imBotId": "168885****578438",
        "wecomUserId": "zhangsan",
        "nickName": "张三1234"
    },
    "chatId": "685bd3c3e****c8657fb492e",
    "joinedMember": [
        {
            "avatarUrl": "https://wx.qlogo.cn/mmhead/eHEMOF2hOemjL4zQT7rQgicicRibAM6T7RveG2diasqXXNFNFACYibicPf5Ygds0GvpVXLq2CntjP0gfo/0",
            "contactType": 1,
            "coworker": false,
            "isFriend": true,
            "nickName": "f",
            "roomAlias": null,
            "imContactId": "78813****9110143",
            "joinTime": 1752115629,
            "isSelf": false
        }
    ],
    "inviter": {
        "avatarUrl": "https://wework.qpic.cn/wwpic3az/375283_30QqeKdzQkKC_kj_1752047248/0",
        "contactType": 3,
        "coworker": true,
        "isFriend": true,
        "nickName": "张三4321",
        "roomAlias": "马云飞",
        "imContactId": "16888****578438",
        "joinTime": 1750848444,
        "isSelf": true
    },
    "ownerImContactId": "168885****644281",
    "topic": "20250625群聊1-1",
    "imRoomId": "R:108820****9049797",
    "groupId": "64758f02111f3bf9615998f1",
    "timestamp": 1752115635653
}'

返回响应

🟢200成功

application/json

Body

示例

{}

修改于 2026-01-20 10:37:44

退出群聊事件回调

更改群名事件回调