商业消息模板¶
商业消息模板是一组可重复使用的预设消息。您可以先把常用回复整理为模板,再在商业关键词回复等功能中引用它们。
商业模板按个人商业账号保存,与群组消息模板相互独立。两者可以使用相同的编辑界面,但不会互相读取或覆盖。
适合场景¶
- 常见问题回复,例如价格、发货、营业时间、售后说明;
- 欢迎语或引导语,在多个关键词规则中复用;
- 活动期间的固定说明、优惠链接、按钮入口;
- 需要保留格式、链接预览或内容保护的正式回复。
创建模板¶
- 打开 CNBot 面板,进入「商业」。
- 点击「消息模板」。
- 点击底部工具条的
+新建模板。 - 填写模板名称、消息类型和内容。
- 可选设置解析模式、链接预览、按钮及按钮颜色、静音发送、内容保护。
- 保存后,模板会出现在商业关键词回复的「选择模板」列表中。
免费用户最多可创建 6 条商业消息模板;CNBot+ 用户最多可创建 12 条。
消息类型¶
| 类型 | 用途 | 关键字段 |
|---|---|---|
| 文本 | 发送普通文本、带格式文本、链接和按钮 | 消息文本、解析模式、链接预览 |
| 语音消息 | 发送固定语音文件,可附带描述文本 | 语音文件 ID、描述文本 |
| 贴纸 | 发送固定贴纸 | 贴纸文件 ID |
| 拷贝消息 | 从指定 Telegram 消息来源依次拷贝发送 | 消息链接或 chatId:messageId |
语音文件 ID 和贴纸文件 ID 可以通过把对应消息发给 CNBot,再回复 /id 获取。在群组中查询时,结果会优先私发给操作人;首次使用前请先打开机器人私聊并点击 Start。
拷贝消息要求 CNBot 能访问来源对话;如果来源消息启用了内容保护,Telegram 可能不允许拷贝。
变量与占位符¶
商业模板在发送给客户时支持以下客户信息变量:
| 变量 | 替换内容 |
|---|---|
{username} |
客户用户名,没有用户名时为空 |
{userFirstName} |
客户名 |
{userLastName} |
客户姓 |
{userUserName} |
客户用户名 |
无法取得值的变量会自动替换为空,不会把原始占位符发送给客户。
解析模式¶
文本模板可以选择解析模式:
- 无(默认):按纯文本发送,最稳妥。
- MarkdownV2:适合需要粗体、链接、代码块等格式的模板,但特殊字符需要转义。
- HTML:适合熟悉 Telegram Bot API HTML 标签的用户。
- Markdown:兼容旧格式,不建议用于新模板。
如果消息格式错误,Telegram 会拒绝发送。包含 \!、\+、下划线、括号、链接等特殊字符时,请优先使用 MarkdownV2 并确认转义。
发送预览¶
编辑文本或语音模板时,可以点击「发送预览消息」,让 CNBot 把当前模板发送到您与机器人的私信中。建议在正式引用模板前先预览一次,确认格式、链接和按钮都符合预期。
按钮、链接预览与发送选项¶
文本模板可以附加 URL 按钮。按钮适合放置客服入口、商品链接、表单链接或频道链接。编辑按钮时可以选择默认、蓝色、绿色或红色样式;颜色分别适合普通、主要、成功或风险操作,最终显示效果以 Telegram 客户端支持为准。
链接预览会为消息中的链接生成预览卡片。您可以按需要启用、关闭或调整预览图像大小。
发送选项包括:
- 禁用通知:消息静音发送到对话中;
- 启用内容保护:不允许转发、复制或保存消息。
这些选项最终是否生效,仍以 Telegram 客户端和 Bot API 的实际支持为准。
在关键词回复中引用¶
编辑商业关键词回复时,在「回复」区域选择模板即可引用。命中关键词后,如果选择了多条模板,CNBot 会从已选模板中随机发送 1 条。
您也可以同时保留文本回复作为补充。保存规则前,至少需要填写文本回复或选择一条模板。
排查¶
模板没有出现在关键词回复里¶
请确认模板属于商业消息模板,不是群组消息模板;同时确认模板处于启用状态。
发送失败¶
常见原因包括:
- 解析模式格式错误;
- 语音或贴纸 File ID 无效;
- 拷贝消息来源不可访问;
- 商业机器人缺少回复消息权限;
- 当前客户聊天不在 Telegram 允许代发的时间窗口内。
建议先发送预览,再把模板引用到关键词规则中。