队列发送消息接口

POST

/api/v2/message/sendByQueue

功能说明：

当使用本接口发送消息时，发送消息的任务将被放到队列里进行排队发送，系统会根据设置的时间排队

📌

imBotId 是v1版本api接口中bot的wxid, 详见imBotId
imContactId 是v1版本api接口中contact的wxid, 详见contactWxid
imRoomId 是v1版本api接口中room的wxid, 详见roomWxid
imContactId 和 imRoomId 必须存在一个，当同时存在时，优先imContactId

请求参数

Query 参数

Body 参数application/json

示例

{
    "externalTaskId": "test",
    "imBotId": "168885****85505",
    "imContactId": "78813*****110143",
    //以下是单条消息格式
    "messageType": 7,
    "payload": {
        "text": "test"
    },
    //以下是多条消息发给同一个人的格式
    "messages": [
        {
            "messageType": 7,
            "payload": {
                "text": "test1"
            }
        },
        {
            "messageType": 7,
            "payload": {
                "text": "test2"
            }
        },
        {
            "messageType": 7,
            "payload": {
                "text": "test3"
            }
        },
        {
            "messageType": 6,
            "payload": {
                "url": "https://s3.cn-northwest-1.amazonaws.com.cn/xiaoju-new-resource-test/permanent/material/646d818baf71f175124fabde/67bfd790-3192-43c5-a1e0-318d90c671af/06af9a99-105f-44ab-b613-eb7d91555dae.jpg.jpg"
            }
        },
        {
            "messageType": 13,
            "payload": {
                "url": "https://s3.cn-northwest-1.amazonaws.com.cn/xiaoju-new-resource-test/permanent/material/646d818baf71f175124fabde/e4c127e9-47ad-4cc6-a514-b5aef45e6ef9/43642bfc-25d1-4cbe-9fe0-e67d2e870e9b.mp4"
            }
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://stride-bg.dpclouds.com/hub-api/api/v2/message/sendByQueue?token=d12195ec829f4********9e79f1c0bc7' \
--header 'Content-Type: application/json' \
--data-raw '{
    "externalTaskId": "test",
    "imBotId": "168885****85505",
    "imContactId": "78813*****110143",
    //以下是单条消息格式
    "messageType": 7,
    "payload": {
        "text": "test"
    },
    //以下是多条消息发给同一个人的格式
    "messages": [
        {
            "messageType": 7,
            "payload": {
                "text": "test1"
            }
        },
        {
            "messageType": 7,
            "payload": {
                "text": "test2"
            }
        },
        {
            "messageType": 7,
            "payload": {
                "text": "test3"
            }
        },
        {
            "messageType": 6,
            "payload": {
                "url": "https://s3.cn-northwest-1.amazonaws.com.cn/xiaoju-new-resource-test/permanent/material/646d818baf71f175124fabde/67bfd790-3192-43c5-a1e0-318d90c671af/06af9a99-105f-44ab-b613-eb7d91555dae.jpg.jpg"
            }
        },
        {
            "messageType": 13,
            "payload": {
                "url": "https://s3.cn-northwest-1.amazonaws.com.cn/xiaoju-new-resource-test/permanent/material/646d818baf71f175124fabde/e4c127e9-47ad-4cc6-a514-b5aef45e6ef9/43642bfc-25d1-4cbe-9fe0-e67d2e870e9b.mp4"
            }
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

示例

{"errcode":0,"errmsg":"ok","requestId":"6868c251735380222ef0a427"}

修改于 2026-02-09 03:41:01

更新间隔时间配置

队列发送消息接口（im员工id）