创建高级版群发

POST

/api/v2/broadcast/create

功能说明：

通过本接口可以创建高级版群发任务

💡

私聊群发，type=1，使用参数botUserId和externalUserId  
群聊群发，type=2，使用参数 botUserId和wecomChatId（或者使用imBotId和wxids）

请求参数

Query 参数

Body 参数application/json

示例

{
    "name": "imBotId+wxids",
    "messages": [
        {
            "type": 7,
            "payload": {
                "text": "test_text"
            }
        }
    ],
    "atAll": false,
    "sendAnnouncement": false,
    "scheduledTimestamp": 1751726369000,
    "members": [
        {
            "imBotId": "1688855916578438",
            "wxids": [
                "R:10879432836728483"
            ]
        }
    ],
    "type": 2
}

请求示例代码

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/broadcast/create?token=d12195ec829f4********9e79f1c0bc7' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "imBotId+wxids",
    "messages": [
        {
            "type": 7,
            "payload": {
                "text": "test_text"
            }
        }
    ],
    "atAll": false,
    "sendAnnouncement": false,
    "scheduledTimestamp": 1751726369000,
    "members": [
        {
            "imBotId": "1688855916578438",
            "wxids": [
                "R:10879432836728483"
            ]
        }
    ],
    "type": 2
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "errcode": 0,
    "errmsg": "",
    "data": {
        "id": "686922d058a375be80547d01",
        "orgId": "646d818ba****175124fabde",
        "nameId": "QLQF202507052104165411",
        "name": "【api创建】imBotId+wxids",
        "count": 1,
        "successCount": 0,
        "failedCount": 0,
        "lostCount": 0,
        "botIds": [
            "66a77970c****6b879ef868"
        ],
        "groupIds": [
            "64758f0211****f9615998f1"
        ],
        "createdAt": 1751720656628,
        "updatedAt": 1751720656628,
        "startAt": 1751720656628,
        "finishAt": 0,
        "cancelCount": 0,
        "sendAnnouncement": false,
        "memberNumber": 1,
        "scheduledTimestamp": 1751720656628
    },
    "failedMembers": [
        {
            "corpId": "",
            "botUserId": "",
            "externalUserId": null,
            "wecomChatId": null,
            "imBotId": "1688855916578438",
            "wxids": [
                "R:10879432836728483"
            ],
            "failReason": "群不存在或者该bot不在群内"
        }
    ]
}

修改于 2026-01-14 10:57:11

获取高级群发失败详情

删除群发任务