API发送消息结果回调

POST

功能说明：

本接口为发送消息回调接口，本接口将使用API发送消息的详情数据回调给指定的路径。

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

💡

回调地址在企业级 api接入配置发消息结果回调地址
注：此接口仅是【发送消息】接口的情况回执，仅对该接口生效

请求参数

Body 参数application/json

示例

{
    "orgId": "646d818baf71*****24fabde",
    "token": "66fe7b0b027b42*****dfb3236c230e5",
    "requestId": "65a772cd0b1f68bb1b4a85b6",
    "externalRequestId": "",
    "botId": "657fb386ad*****cdf5a5567",
    "imBotId": "16888****513525",
    "imContactId": "788130****58266",
    "messageType": 7,
    "payload": {
        "text": "Hello World"
    },
    "errorCode": 0,
    "sendCode": 0,
    "timestamp": 1705472718082
}

请求示例代码

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": "646d818baf71*****24fabde",
    "token": "66fe7b0b027b42*****dfb3236c230e5",
    "requestId": "65a772cd0b1f68bb1b4a85b6",
    "externalRequestId": "",
    "botId": "657fb386ad*****cdf5a5567",
    "imBotId": "16888****513525",
    "imContactId": "788130****58266",
    "messageType": 7,
    "payload": {
        "text": "Hello World"
    },
    "errorCode": 0,
    "sendCode": 0,
    "timestamp": 1705472718082
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "orgId": "646d818baf71*****24fabde",
    "token": "66fe7b0b027b42*****dfb3236c230e5",
    "requestId": "65a772cd0b1f68bb1b4a85b6",
    "externalRequestId": "",
    "botId": "657fb386ad*****cdf5a5567",
    "imBotId": "16888****513525",
    "imContactId": "788130****58266",
    "messageType": 7,
    "payload": {
        "text": "Hello World"
    },
    "errorCode": 0,
    "sendCode": 0,
    "timestamp": 1705472718082
}

修改于 2025-11-21 11:31:25

发送消息

接收消息回调 POST