功能介绍

群发消息功能支持向客户批量发送消息，可以创建群发任务、管理群发模板、查看发送统计。支持立即发送和定时发送两种模式。

操作流程

CRM ＞ 企业微信 ＞ 客户管理 ＞ 客户群发

功能说明

群发类型

系统支持两种群发类型：

类型	说明	适用场景
客户群发（type=0）	直接向客户发送消息	促销活动、新品通知
群主群发（type=1）	向群主发送消息，由群主转发	社群运营、活动通知

代码来源：app/controller/admin/v1/work/GroupTemplate.php:59

创建群发任务

创建群发任务需要设置以下信息：

1. 任务名称：便于任务管理
2. 选择群发账号：选择发送消息的成员（支持多选）
3. 选择客户：
   • 全部客户
   • 指定标签客户（where_label）
   • 排除指定标签客户（where_not_label）
4. 群发内容：
   • 文字内容
   • 图片
   • 小程序
5. 发送类型：
   • 立即发布（template_type=0）
   • 定时发布（template_type=1，需设置 send_time）

代码来源：app/controller/admin/v1/work/GroupTemplate.php:59

群发模板管理

群发模板可以保存常用的群发内容，方便重复使用：

操作	说明	方法
查看列表	查看所有群发模板	index
新建模板	创建新的群发模板	save
查看详情	查看模板详细信息	read
删除模板	删除不需要的模板	delete

代码来源：app/controller/admin/v1/work/GroupTemplate.php:43-121

发送统计

群发任务创建后，可以查看以下统计：

成员发送统计

查看每个成员的发送状态：

• 已发送
• 未发送
• 发送失败

代码来源：app/controller/admin/v1/work/GroupTemplate.php:141

客户接收统计

查看每个客户的接收状态：

• 已接收
• 未接收
• 已读

代码来源：app/controller/admin/v1/work/GroupTemplate.php:161

群聊接收统计

查看群聊的接收状态：

• 已发送到群
• 未发送
• 发送失败

代码来源：app/controller/admin/v1/work/GroupTemplate.php:181

发送提醒

对于定时发布的群发任务，系统会在发送时间到达时自动执行。如果需要手动提醒成员发送，可以：

1. 进入群发任务详情
2. 点击"发送提醒"
3. 系统会向成员发送企业微信应用消息提醒

代码来源：app/controller/admin/v1/work/GroupTemplate.php:262

消息发送机制

应用消息发送

群发消息通过企业微信应用消息接口发送：

• 消息类型：文本、图片、小程序
• 接收方：指定成员（toUser）、指定部门（toParty）、指定标签（toTag）
• 安全标识：safe=1 表示保密消息
• 幂等控制：防止重复发送

内部知识：

• 事件：work.message → MessageSendListener
• 触发时机：群发任务定时执行时
• 发送接口：Work::sendMessage()

代码来源：app/listener/work/MessageSendListener.php:31

定时任务

群发任务通过定时任务自动执行：

• 监听器：AutoGroupTask（继承 Cron，1秒 tick）
• 执行逻辑：检查到期的群发任务，自动发送消息

代码来源：app/listener/work/AutoGroupTask.php:16

常见问题

Q: 群发消息有数量限制吗？

A: 企业微信对群发消息有频率限制，具体限制取决于企业微信版本。建议合理安排群发时间，避免触发限制。

Q: 如何查看群发效果？

A: 在群发任务详情页面，可以查看成员发送统计、客户接收统计、群聊接收统计等数据。

Q: 定时发布失败怎么办？

A: 检查定时任务是否正常运行。如果任务执行失败，可以在群发任务详情中手动触发发送提醒。

Q: 如何取消已创建的群发任务？

A: 对于未发送的群发任务，可以直接删除。对于已发送的任务，无法取消。