队列发送消息接口

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 参数

token

string

可选

示例值:

Body 参数application/json

示例

{
    // "externalRequestId": "100",
    "imBotId": "1688854807513525",
    "imContactId": "7881301204958266",
    "messageType": 7,
    "payload": {
        "text": "nihao"
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST '/api/v2/message/sendByQueue?token={{org_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    // "externalRequestId": "100",
    "imBotId": "1688854807513525",
    "imContactId": "7881301204958266",
    "messageType": 7,
    "payload": {
        "text": "nihao"
    }
}'

返回响应

🟢200成功

application/json

Body

errcode

enum<number>

返回码

必需

0: 成功 1: token不正确 2: 参数验证不通过 6: 没有发送权限 -2: 没有找到bot -3: 找到了多个bot

枚举值:

-1-2-3-4-5-6

errmsg

string

对返回码的文本描述内容

必需

requestId

string

消息的请求id，可与回调结合使用获取本次发消息情况

必需

示例

{
  "errcode": -1,
  "errmsg": "string",
  "requestId": "string"
}

修改于 2024-09-25 09:57:35

更新配置

队列发送消息接口（企微id）