TgSpark帮助中心自动回复

HELP CENTER

自动回复使用帮助

配置关键词、时段、群内提及与人工接管暂停。

入口为“设置 → 自动回复”,由工作区所有者或管理员配置。自动回复根据新收到的消息匹配规则并发送固定文字,回复模板与人工聊天使用的“消息模板”分别管理。

配置流程

  1. 打开“回复模板”页签,新建模板并命名。
  2. 添加关键词规则,选择包含、完全或正则匹配,填写命中后的回复文字。
  3. 调整规则顺序。系统从前往后匹配,使用第一个命中规则。
  4. 按需填写兜底回复;未命中规则或收到图片、语音、文件时可使用它,留空则不回复。
  5. 到“托管账号”页签,打开对应账号的“配置”,选择回复模板和运行时段。
  6. 开启自动回复总开关并保存,确认账号连接和监听就绪。

例如把“完全匹配:营业时间”的回复设为固定营业说明;把范围较宽的包含规则放在更具体的规则之后,避免覆盖。

每个模板最多 50 条规则,每条最多 30 个关键词,固定回复文字上限为 4000 字符。正则规则由熟悉表达式的人员维护。

时段和群内提及

运行时段可选全天或指定时段,按工作区时区执行。账号开启总开关但尚未连接时,页面会提示等待;离线期间的消息不会补发回复。

默认只处理私聊。需要群内回复时,在账号配置中额外开启“群内被 @ 时自动回复”。普通群、超级群中,只有 Telegram 识别为提及当前账号的新消息触发,包括直接提及和被识别的消息回复;频道广播、普通群消息、历史和编辑事件不会因此触发。

群内回复会在原群引用触发消息,不会转为私信。匹配前会去掉消息实体中对当前账号的提及,因此 @客服 营业时间 可以匹配“营业时间”。

人工接管与冷却

人工发言后,该会话暂停自动回复 30 分钟,其他会话继续处理。可在托管账号的“人工接管中的会话”列表点击“立即恢复”。这是自动回复暂停机制,独立人工接单和转接功能仍未开放。

同一会话内,同一关键词规则有 10 分钟冷却,兜底有 30 分钟冷却,避免反复刷屏。排除的聊天不触发自动回复。

同一 Telegram 账号不能在多个工作区同时获得自动回复托管。提示“已由其他工作区托管”时,需要协调现有托管,不要反复切换总开关。

未回复或结果不明时

按以下顺序检查:

  1. 当前工作区和账号是否正确,是否被其他工作区托管。
  2. 是否选择了模板并开启总开关,当前是否处于运行时段。
  3. 账号是否连接、监听是否就绪。
  4. 是否命中更靠前的规则、冷却或人工接管暂停。
  5. 群消息是否开启群内提及且确实提及当前账号,聊天是否被排除。

结果不确定时,系统不会自动重发,并暂停对应会话 30 分钟。先在 Telegram 核对,再决定是否恢复;不要用重复触发规则来验证上一条是否发出。

删除模板前先解除使用该模板的账号配置。首次启用时,应由有权限的人员在自有测试会话中核对规则和时段。

对应实现:自动回复页面、规则与限制。上线需执行 make migrate.autoReply 并更新主服务、Worker 和前端,详见群内提及自动回复。

返回模块帮助