基于 QiweAPI 的原生协议能力，支持向外部联系人或群聊执行高并发、多形式的消息群发任务，助力企业实现标准化 SOP 推送。
能力介绍
- 全对象覆盖：支持针对选定的外部联系人（私聊群发）或指定的外部群（群发助手）进行批量投递。
- 内容多样化：不限于纯文本，支持一键群发图片、视频、文件、网页链接及小程序卡片。
- 自动化任务调度：支持设置任务开始时间与发送间隔（频率控制），模拟人工操作轨迹，降低风控风险。
- 发送状态回执：接口实时返回每条消息的发送结果（成功、失败、非好友等），方便业务系统进行数据统计与二次补发。
10 分钟接入 Demo
- 筛选目标人群：通过 API 获取外部联系人列表，或根据标签（Tag）筛选出目标用户 ID 集合。
- 创建群发任务：构造包含目标 ID 列表和素材内容的 JSON 数据包。
- 调用接口执行：请求 QiweAPI 的群发接口，系统将进入自动化队列进行分发。
API 示例代码
以下展示了如何向指定标签的客户批量发送产品画册：
import requests
import time
# QiweAPI 群发接口
BATCH_SEND_URL = "http://api.qiweapi.com/batch_send_text"
MY_API_KEY = "YOUR_API_KEY"
def start_batch_marketing(user_ids, message):
for uid in user_ids:
payload = {
"to_user": uid,
"content": message,
"api_key": MY_API_KEY
}
# 调用发送接口
response = requests.post(BATCH_SEND_URL, json=payload).json()
if response.get("code") == 200:
print(f"✅ 已向用户 {uid} 发送成功")
else:
print(f"❌ 用户 {uid} 发送失败: {response.get('msg')}")
# 重要：设置随机间隔，模拟人工频率
time.sleep(3)
# 目标客户 ID 列表
target_users = ["external_id_1", "external_id_2", "external_id_3"]
start_batch_marketing(target_users, "您好！这是本季度最新的产品目录，请查收 📕")
使用场景说明
- 大促活动通知：在双 11、直播开启前，通过 API 快速触达存量客户，引导进入直播间或领券页面。
- 标准化 SOP 执行：新客加入后的第 3 天、第 7 天，系统自动根据时间节点触发群发，完成客户转化培育。
- 紧急业务通知：针对停电通知、系统升级或物流变更，实现全量客户的极速告知，提升服务体验。
- 社群批量维护：通过群发接口向数百个外部群同步发送早报或晚间总结，确保社群内容供给的稳定性。
FAQ
-
Q：群发接口会被限制吗？
- A：企业微信官方对群发频率有天然限制。QiweAPI 建议通过接口设置合理的发送间隔（如 2-5 秒/条），并分批次进行，以确保账号权重稳定。
-
Q：支持通过标签一键群发吗？
- A：支持。您可以先调用
get_tags接口获取用户 ID，再将结果喂给群发接口，实现基于标签的精准营销。
- A：支持。您可以先调用
-
Q：群发的消息，客户一定能收到吗？
- A：只要客户未删除员工、未屏蔽消息且账号状态正常，消息会准时触达。接口会返回发送状态，您可以针对“非好友”等失败原因进行名单清洗。
