创建极速群发任务

POST

/api/v2/wecomMessage/batchSend

功能说明：

通过本接口可以创建极速群发任务，对指定群聊、私聊进行群发触达

本接口调用了企业微信本身群发接口能力，可以快速高效触达目前对象，但是本接口对于每个触达对象每天上限只有一次。

极速群发任务支持定时发送、立即发送。

请求参数

Query 参数

Body 参数application/json

示例

{
    "name": "test_name",
    "messages": [
        {
            "type": 7,
            "payload": {
                "text": "test"
            }
        }
    ],
    "members": [
        {
            "botUserId": "zhangsan",
            "externalUserId": [
                "wmrRhyBgAAvwB*****GkAYsUo6XzCQ"
            ]
        }
    ],
    "type": 1
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://zan-hub.xiaoshunai.com/api/v2/wecomMessage/batchSend?token=d12195ec829f4********9e79f1c0bc7' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "test_name",
    "messages": [
        {
            "type": 7,
            "payload": {
                "text": "test"
            }
        }
    ],
    "members": [
        {
            "botUserId": "zhangsan",
            "externalUserId": [
                "wmrRhyBgAAvwB*****GkAYsUo6XzCQ"
            ]
        }
    ],
    "type": 1
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "code": 0,
    "msg": "",
    "data": {
        "id": "6868b8e458a375be80547cc6",
        "orgId": "646d818ba****175124fabde",
        "nameId": "ASLQF202507051332204371",
        "name": "【api创建】test_name",
        "count": 1,
        "successCount": 0,
        "failedCount": 0,
        "lostCount": 0,
        "botIds": [
            "66a77970*****76b879ef868"
        ],
        "groupIds": [
            "64758f02111f3bf9615998f1"
        ],
        "createdAt": 1751693540763,
        "updatedAt": 1751693540763,
        "startAt": 1751693540726,
        "finishAt": 0,
        "cancelCount": 0,
        "sendAnnouncement": false,
        "memberNumber": 1,
        "scheduledTimestamp": 1751693540726
    },
    "failedMembers": []
}

修改于 2025-12-19 06:32:27

获取表单素材详情

极速群发回调