小组级接收消息回调

POST

/message

功能描述：

本接口为小组级接收消息回调，系统后台会将接收到的托管账号消息、外部客户消息一起进行回调

回调地址：小组控制台->api接入->回调地址

个人发消息：消息回调中没有chatExternalUserId，ExternalUserId是联系人的id，botWeixin是托管账号。

企业成员发消息：消息回调中ExternalUserId是托管账号的id，chatExternalUserId是用户的id。（如果没有开通ExternalUserId的话，发消息回调里面就没有chatExternalUserId或者为空）

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

请求参数

Body 参数application/json

示例

{
    "data": {
        "messageId": "a7e3d70d236fa003f7bfd08c4e92395b",
        "chatId": "681046253*****3b2fe4f1b",
        "avatar": "https://wx.qlogo.cn/mmhead/bVy2VQVTWzbt6h7DOt8RLLgW1O3WKurmfLQ8W7EQHIGvD2XDLyofYTaryeL9jQiadgQjb7SZPrxY/0",
        "roomTopic": "",
        "roomId": "",
        "contactName": "test_name",
        "contactId": "78813****9347451",
        "payload": {
            "imageUrl": "https://workmate.s3.cn-northwest-1.amazonaws.com.cn/link_msg/e3bc2eb2-308a-49aa-adaf-80409f58bab1/1f9e667e-f1fb-4813-b0de-2a0da0b7428f.jpg",
            "size": 3844,
            "width": 446,
            "height": 478,
            "artwork": {
                "url": "https://s3.cn-northwest-1.amazonaws.com.cn/xiaoju-new-resource-test/temp/chat-file/646d818baf71f175124fabde/66a77970c980f76b879ef868/1752130639802/a35d386d-3253-4a63-8a61-4b4d9a7307b6.jpg.jpg",
                "height": 643,
                "width": 600
            }
        },
        "type": 6,
        "timestamp": 1752130636721,
        "token": "669dc78a7****b23e04351d6",
        "contactType": 1,
        "coworker": false,
        "botId": "66a77970c****6b879ef868",
        "botWxid": "16888****6578438",
        "botWeixin": "zhangsan",
        "isSelf": false,
        "externalUserId": "wmrRhyBgAAvwB*****AoGkAYsUo6XzCQ",
        "roomWecomChatId": null,
        "mentionSelf": false
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://zan-api.xiaoshunai.com/message' \
--header 'Content-Type: application/json' \
--data-raw '{
    "data": {
        "messageId": "a7e3d70d236fa003f7bfd08c4e92395b",
        "chatId": "681046253*****3b2fe4f1b",
        "avatar": "https://wx.qlogo.cn/mmhead/bVy2VQVTWzbt6h7DOt8RLLgW1O3WKurmfLQ8W7EQHIGvD2XDLyofYTaryeL9jQiadgQjb7SZPrxY/0",
        "roomTopic": "",
        "roomId": "",
        "contactName": "test_name",
        "contactId": "78813****9347451",
        "payload": {
            "imageUrl": "https://workmate.s3.cn-northwest-1.amazonaws.com.cn/link_msg/e3bc2eb2-308a-49aa-adaf-80409f58bab1/1f9e667e-f1fb-4813-b0de-2a0da0b7428f.jpg",
            "size": 3844,
            "width": 446,
            "height": 478,
            "artwork": {
                "url": "https://s3.cn-northwest-1.amazonaws.com.cn/xiaoju-new-resource-test/temp/chat-file/646d818baf71f175124fabde/66a77970c980f76b879ef868/1752130639802/a35d386d-3253-4a63-8a61-4b4d9a7307b6.jpg.jpg",
                "height": 643,
                "width": 600
            }
        },
        "type": 6,
        "timestamp": 1752130636721,
        "token": "669dc78a7****b23e04351d6",
        "contactType": 1,
        "coworker": false,
        "botId": "66a77970c****6b879ef868",
        "botWxid": "16888****6578438",
        "botWeixin": "zhangsan",
        "isSelf": false,
        "externalUserId": "wmrRhyBgAAvwB*****AoGkAYsUo6XzCQ",
        "roomWecomChatId": null,
        "mentionSelf": false
    }
}'

返回响应

🟢200成功

application/json

Body

示例

{}

修改于 2026-01-22 09:50:18

发送消息

聊天历史