消息模板把常用正文、变量和附件保存为可复用回复;存储页显示这些平台文件与工单、群发文件占用的工作区容量。
创建消息模板
入口为“设置 → 消息模板”。新建时填写名称、正文、可见范围和可选快捷指令,需要时上传附件并调整顺序,保存后即可在聊天输入框调用。
| 范围 | 谁能使用 | 谁能修改 |
|---|---|---|
| 个人模板 | 创建者本人 | 创建者 |
| 共享模板 | 当前工作区有相应访问条件的成员 | 创建者;管理员不能因此代改他人的模板 |
共享意味着成员可读取内容,切换为共享前确认正文和附件适合团队使用。共享转个人后,其他成员会失去后续访问;已经看过或发出的内容不能收回。
保存内容修改会生成新版本。聊天中插入后临时修改正文,不会改动原模板;已提交的群发使用独立内容快照,不随原模板后续编辑变化。
在聊天中调用
可以点击输入框的模板入口搜索名称或快捷指令,也可以在词边界输入 /greet 这样的指令,选择候选后插入。
默认动作是插入到待发内容,核对后再发送。候选中的“直接发送”是单独动作,点击会实际发送。附件会进入待发附件区。
快捷指令保存时不带 /,只使用英文字母、数字和下划线,按小写匹配。共享指令在工作区内唯一;个人指令在本人的当前工作区内唯一。个人与共享允许同名,候选中注意选择具体模板。
这是 TgSpark 编辑器快捷功能,不会注册成 Telegram Bot 命令,也不会改变手机 Telegram 的输入行为。
使用变量
| 写法 | 插入聊天时的含义 |
|---|---|
{{客户}} |
当前聊天对象的显示名称 |
{{我}} |
当前客服的显示名称 |
{{账号}} |
当前发送 Telegram 账号的显示名称 |
{{日期}} |
工作区当地当天日期 |
例如保存 你好,{{客户}},我是{{我}}。,插入后检查实际替换结果再发送。无法识别的变量会保留并提示;手填业务变量如订单号不会自动从业务系统读取,需要人工补齐。
人工聊天在插入时替换变量,群发在服务端按目标生成内容,群发提交前应检查目标预览。
附件和容量
当前平台文件常用限制为单文件 10 MiB;每模板最多 10 个文件、合计 50 MiB。文件类型及各模块限制由后端校验,模板页面从服务端读取限制。
“设置 → 账单与存储”可查看总配额、已用、上传预占、可用容量、分类用量及有权限访问的文件明细。新工作区默认额度由部署配置决定,示例为 5 GiB,调整默认值不会追溯改变已有工作区额度。
| 用量名称 | 含义 |
|---|---|
| 已用 | 已确认保存且尚未释放的平台文件 |
| 上传预占 | 上传尚未结算时先占用的容量,防止并发上传超过额度 |
| 待释放或待清理 | 已安排清理,物理删除成功后才释放容量 |
| 可用 | 总配额扣除已用和预占后的剩余容量 |
同一文件重新上传会形成新资产并分别计量;群发复制模板附件也会额外占用空间。看得到总量不代表能下载别人的个人模板文件,文件访问仍按业务权限检查。
清理与常见问题
清理前先确认文件是否仍被模板版本、群发快照或工单引用。有引用的文件不能靠文件明细直接绕过业务关系删除;删除后显示待释放时,需要等待后台清理,容量不一定立即变化。
| 问题 | 处理方法 |
|---|---|
| 搜不到模板 | 检查工作区、可见范围、启用状态和搜索词 |
| 快捷指令冲突 | 修改同一范围内重复的指令,注意不区分大小写 |
| 只能使用不能编辑共享模板 | 只有创建者可编辑,联系创建者修改 |
| 上传失败 | 检查类型、单文件和总大小、工作区可用容量;运维检查目录和代理限制 |
| 删除后空间未恢复 | 检查引用与待清理状态,持续不释放时由运维查看清理错误 |
| 想充值、扣费或改套餐 | 当前页面提供用量功能,未实现自动计费与扣款 |
对应实现:消息模板、存储用量、模板接口、文件接口。

