群组消息模板¶

群组消息模板是一组可重复使用的预设消息，先把常用内容整理成模板，再在定时任务等发送消息的功能里引用它们，一处编辑、多处生效。

群组消息模板按群保存，与「商业消息模板」相互独立——两者用的是同一套编辑界面，但不会互相读取或覆盖。

入口：群组管理 → 消息模板（也可以在编辑定时任务时，从「发送提示消息」区直接新建 / 编辑）。

免费可用

群组消息模板对所有群管理员开放，无需 CNBot+ 会员；每个群最多可创建 30 条模板。

适合场景¶

定时任务要按点发布的群公告、活动提醒、群规复读；
需要保留格式、链接预览、URL 按钮的正式通知；
一段内容被多个定时任务共用，改一次全部生效。

创建模板¶

打开 CNBot 面板，进入群组管理 → 消息模板。
点击底部工具条的 + 新建模板。
填写模板名称（最多 30 字）、消息类型和内容。
可选设置解析模式、链接预览、URL 按钮及按钮颜色、静音发送、内容保护。
保存后，模板会出现在定时任务「发送提示消息」的可选列表里。

消息类型¶

类型	用途	关键字段
文本	发送普通文本、带格式文本、链接和按钮	消息文本、解析模式、链接预览
语音消息	发送固定语音文件，可附带描述文本	语音文件 ID、描述文本
贴纸	发送固定贴纸	贴纸文件 ID
拷贝消息	从指定 Telegram 消息来源依次拷贝发送	消息链接或 `chatId:messageId`

语音 / 贴纸的 File ID 可以把对应消息发给 CNBot，再回复 /id 获取。在群组中查询时，CNBot 会优先把 ID 信息私发给您；如果尚未使用过机器人，请先打开私聊并点击 Start。拷贝消息要求 CNBot 能访问来源对话；来源启用了内容保护时，Telegram 可能不允许拷贝。

解析模式¶

文本模板可以选择解析模式：

无（默认）：按纯文本发送，最稳妥。
MarkdownV2：适合需要粗体、链接、代码块等格式的模板，特殊字符需转义。
HTML：适合熟悉 Telegram Bot API HTML 标签的用户。
Markdown：兼容旧格式，不建议用于新模板。

格式错误时 Telegram 会拒绝发送。包含 \!、\+、下划线、括号、链接等特殊字符时，请优先用 MarkdownV2 并确认转义。

按钮、链接预览与发送选项¶

URL 按钮：文本模板可附加按钮，常用于放客服入口、活动链接、频道入口。编辑按钮时可以选择默认、蓝色、绿色或红色样式；颜色用于表达普通、主要、成功或风险操作，最终显示效果以 Telegram 客户端支持为准。
链接预览：为消息里的链接生成预览卡片，可启用 / 关闭 / 调整预览图大小。
发送选项：可选「禁用通知」（静音发送）与「启用内容保护」（不允许转发 / 复制 / 保存）。

这些选项最终是否生效，仍以 Telegram 客户端与 Bot API 的实际支持为准。

发送预览¶

编辑文本或语音模板时，可以点「发送预览消息」，让 CNBot 把当前模板发到你与机器人的私信里。建议在正式引用前先预览一次，确认格式、链接和按钮都符合预期。

在定时任务中引用¶

编辑定时任务时，在「发送提示消息」区选择模板即可引用，一个任务最多可选 6 条模板，到点时按顺序依次发送。

删除某条模板时，正在引用它的定时任务会自动取消选择该模板，不会残留失效引用。

与配置备份¶

群组消息模板会随配置备份一起导出，导入到另一个群时整组替换；定时任务里对模板的引用也会自动重新指向新群的对应模板。

排查¶

模板没出现在定时任务里：确认它是群组消息模板（不是商业消息模板），且处于启用状态。

发送失败：常见原因有解析模式格式错误、语音 / 贴纸 File ID 无效、拷贝来源不可访问，或 CNBot 在群里缺少发送 / 发媒体权限。建议先发预览再引用。