“群发”用于通过一个有群发权限的 Telegram 账号，向明确选中的私聊、群组或频道发送固定内容。当前支持立即和一次性定时发送，不包含循环定时、账号轮换或已读率统计。
群发已有实现，但真实 Telegram 目标、多进程和部分故障场景仍有待验收项。正式启用前由部署负责人完成相应验证，不能仅凭页面可打开判断发送链路已可用。
新建与提交
- 进入“群发”，新建任务并填写便于识别的名称。
- 选择有群发权限且运行就绪的发送账号。
- 从当前或归档会话中明确勾选目标，使用类型和搜索筛选辅助选择。筛选本身不等于选中全部目标。
- 编写正文、添加附件，或插入已有消息模板。
- 保存草稿并执行预检查，处理不可发送目标、权限、排除、容量和内容限制等问题。
- 选择目标查看变量预览。需要核对实际接收效果时，使用独立试发并确认目标。
- 选择立即发送，或按页面时区安排一次性发送时间；核对截止等策略后确认提交。
- 在任务详情查看目标结果和发送尝试，不以提交成功代替发送成功。
“Telegram 真机模拟预览”只展示内容；“独立真实试发”会实际向所选目标发送 Telegram 消息。真实试发不推进正式任务的成功进度。
内容与目标规则
每个任务绑定一个发送账号。目标是否可写仍受 Telegram 的群组、频道和个人权限限制，拥有平台群发权限不能保证所有目标可发送。
模板插入群发时，会复制正文和附件为独立内容，复制的附件额外占用工作区容量。提交后内容和目标固定；后续修改原模板不会改动已提交任务。
正文支持 {{客户}}、{{我}}、{{账号}}、{{日期}} 等既有变量，服务端按目标生成内容。目标数、附件和正文限制以页面从后端取得的限制为准。
定时与后台运行
确认计划时间时核对工作区时区。提交后的调度在后台执行，关闭浏览器不会取消任务。主服务、queue 和 Worker 必须正常运行；只启动 HTTP 不构成完整群发链路。
计划时间是开始安排发送的时间，不保证所有目标同时收到。账号冷却、并发预算、目标错误和截止策略都会影响进度。
任务控制与结果
| 操作 | 作用和限制 |
|---|---|
| 暂停 | 阻止后续未派发操作，已经进入 Telegram 调用的操作仍可能完成 |
| 继续 | 在允许继续的状态下恢复后续处理，仍需通过当前权限及发送检查 |
| 取消 | 取消尚未执行部分，不能撤回已发送内容 |
| 核对 | 查询结果不明的原任务，不新发消息 |
| 重试失败 | 只重试确定失败的消息单元；成功和未知结果不会重发 |
| 复制为新草稿 | 生成独立草稿，重新检查内容和目标后再提交 |
| 创建续发草稿 | 依据可续发部分生成新草稿，排除已成功和结果未知单元 |
详情中的目标结果和历史尝试可以按状态、原因筛选。一个目标可对应多条消息；部分成功时应查看消息单元和尝试记录，避免误把整个目标重新发一遍。
结果未知意味着系统无法证明成功或失败。先核对原任务和 Telegram 实际结果，不能把未知当作失败重试。
常见问题
| 现象 | 处理方法 |
|---|---|
| 没有可选发送账号 | 检查工作区、账号群发授权及运行状态 |
| 预检查过期或提示版本变化 | 刷新任务，重新执行预检查后提交 |
| 任务一直不推进 | 由运维检查 queue、Worker、定时条件及 HTTP/queue 配置一致性 |
| 某些目标失败 | 查看具体原因，区分 Telegram 权限、排除、限流和内容错误 |
| 暂停后成功数仍增加 | 已派发调用可能在暂停后返回结果，不代表新操作继续派发 |
| 旧任务不能重试或下载附件 | 查看保留和清理提示；历史内容并非永久保留 |
| 暂时不接受新任务 | 可能处于维护入口关闭状态，联系运维；已有任务不会因此自动取消 |
对应实现：群发编辑、任务详情、接口契约。