创建极速群发任务

POST

/api/v2/wecomMessage/batchSend

功能说明：

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

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

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

当部分外部联系人不存在时，支持创建并返回不存在的联系人信息

💡

注意：该接口主要作用是相同的消息批量发送给多个人，如果只需要给一个人发消息，不要调用该接口，调用发送消息接口！！！
注意：该接口主要作用是相同的消息批量发送给多个人，如果只需要给一个人发消息，不要调用该接口，调用发送消息接口！！！
注意：该接口主要作用是相同的消息批量发送给多个人，如果只需要给一个人发消息，不要调用该接口，调用发送消息接口！！！

请求参数

Query 参数

Body 参数application/json

示例

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

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://ae-bg.ddregion.com/hub-api/api/v2/wecomMessage/batchSend?token=d12195ec829f4********9e79f1c0bc7' \
--header 'Content-Type: application/json' \
--data '{
    "name": "test_name",
    "messages": [
        {
            "type": 7,
            "payload": {
                "text": "test"
            }
        }
    ],
    "members": [
        {
            "botUserId": "zhangsan",
            "externalUserId": [
                "wmrRhyBgAAvwB*****GkAYsUo6XzC1",
                "wmrRhyBgAAvwB*****GkAYsUo6XzC2",
                "wmrRhyBgAAvwB*****GkAYsUo6XzC3",
                "wmrRhyBgAAvwB*****GkAYsUo6XzC4"
            ]
        }
    ],
    "type": 1
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "msg": "",
    "data": {
        "id": "69fd5dc6a1b45d1017930794",
        "orgId": "646d818baf71f175124fabde",
        "nameId": "ASLQF202605081151344743",
        "name": "【api创建】test_batchSend_mixed",
        "count": 1,
        "successCount": 0,
        "failedCount": 0,
        "lostCount": 0,
        "botIds": [
            "69cc8b857054bcf3f964226a"
        ],
        "groupIds": [
            "693d318f0ea5e7b74773c2e7"
        ],
        "createdAt": 1778212294157,
        "updatedAt": 1778212294157,
        "startAt": 1778212294152,
        "finishAt": 0,
        "cancelCount": 0,
        "sendAnnouncement": false,
        "memberNumber": 1,
        "scheduledTimestamp": 1778212294152
    },
    "failedMembers": [
        {
            "botUserId": "",
            "externalUserId": null,
            "wecomChatId": null,
            "imBotId": "1688855304816409",
            "wxids": [
                "fake_wxid_not_exist_001"
            ],
            "failReason": "联系人不存在或该联系人和bot不是好友关系"
        }
    ]
}

修改于 2026-06-29 08:29:57

获取表单素材详情

极速群发回调