接收消息回调 POST

POST

功能说明：

本接口为接收消息回调，由于本系统为RPA系统，无论是用户发送消息还是托管账号发送消息，针对于底层都需要进行接收消息，所以都会触发该回调接口。

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

💡

回调地址在企业级 api接入配置收消息回调地址

请求参数

Body 参数application/json

示例

{
    "orgId": "646d818ba*****75124fabde",
    "groupId": "64758f02111f3bf9615998f1",
    "token": "66fe7b0b027b4******dfb3236c230e5",
    "botId": "66a77970c98****879ef868",
    "imBotId": "1688855****8438",
    "botUserId": "zhangsan",
    "chatId": "6810a6fe3*****3b224a13d",
    "avatar": "https://wx.qlogo.cn/mmhead/eHEMOF2hOemjL4zQT7rQgicicRibAM6T7RveG2diasqXXNFNFACYibicPf5Ygds0GvpVXLq2CntjP0gfo/0",
    "imContactId": "788130*****10143",
    "externalUserId": "wmrRhyBgAAT2*****BFhZyYxB_FF3Q",
    "customerExternalUserId": "wmrRhyBgAAT2T*****FhZyYxB_FF3Q",
    "contactName": "f",
    "contactType": 1,
    "messageId": "9e0c1214c1889db8e928da64540a3f2e",
    "source": 0,
    "timestamp": 1752050339960,
    "messageType": 7,
    "payload": {
        "pureText": "测试一下",
        "text": "测试一下"
    }
}

请求示例代码

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 '{
    "orgId": "646d818ba*****75124fabde",
    "groupId": "64758f02111f3bf9615998f1",
    "token": "66fe7b0b027b4******dfb3236c230e5",
    "botId": "66a77970c98****879ef868",
    "imBotId": "1688855****8438",
    "botUserId": "zhangsan",
    "chatId": "6810a6fe3*****3b224a13d",
    "avatar": "https://wx.qlogo.cn/mmhead/eHEMOF2hOemjL4zQT7rQgicicRibAM6T7RveG2diasqXXNFNFACYibicPf5Ygds0GvpVXLq2CntjP0gfo/0",
    "imContactId": "788130*****10143",
    "externalUserId": "wmrRhyBgAAT2*****BFhZyYxB_FF3Q",
    "customerExternalUserId": "wmrRhyBgAAT2T*****FhZyYxB_FF3Q",
    "contactName": "f",
    "contactType": 1,
    "messageId": "9e0c1214c1889db8e928da64540a3f2e",
    "source": 0,
    "timestamp": 1752050339960,
    "messageType": 7,
    "payload": {
        "pureText": "测试一下",
        "text": "测试一下"
    }
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "errcode": 0,
    "errmsg": "string"
}

修改于 2026-03-04 05:56:12

API发送消息结果回调

获取指定托管账号的聊天历史