能力介绍
外部群发消息的核心逻辑并不是“直接发送消息”，而是先创建群发任务，再由系统异步执行发送。整体流程一般包含：选择发送对象、构造消息内容、提交群发任务、以及结果回查。
理解这一点之后，你会发现群发接口本质上是一个“任务触发型接口”，而不是即时发送接口。
10分钟接入 Demo
- 获取接口调用凭证（access_token）
- 准备外部联系人列表（user_id / external_userid）
- 构造消息内容（文本 / 图文 / 图片等）
- 调用群发接口，创建发送任务
- 记录返回的 task_id，用于后续状态查询
API 示例代码
import requests
def create_mass_send(access_token, user_list, content):
url = f"https://xxx/api/mass/send?access_token={access_token}"
payload = {
"touser": "|".join(user_list),
"msgtype": "text",
"text": {
"content": content
}
}
response = requests.post(url, json=payload)
return response.json()
实际调用中通常会返回 task_id，用于后续查询发送状态，而不是一次性完成所有发送结果。
使用场景说明
- 活动通知批量触达客户
- 新品上线统一推送
- 客户分组运营消息发送
- 节点型（节日/周期）自动群发
- 标签人群定向触达
FAQ：高频问题解答
Q1：调用成功是不是就代表消息全部发出？
A1：不是，接口成功只代表“任务创建成功”，发送是异步执行的，需要看任务状态。
Q2：为什么有些客户收不到消息？
A2：可能原因包括：客户状态异常、被限制、频率限制、或消息类型不支持等。
Q3：可以实时知道发送结果吗？
A3：一般需要通过任务查询接口或回调机制获取最终结果，而不是同步返回。
