配置 Telegram 通知

1. 打开通知设置#

Telegram 通知让管理员离开 ChatHub 后仍能在手机上收到提醒。通知机器人与收件箱中用于联系客户的 Telegram 渠道独立配置，无须把通知机器人添加到“渠道”列表。

1. 1

   使用有权查看和管理系统设置的账户登录 ChatHub。

2. 2

   打开顶部的 管理 → 设置 → 左侧的 Telegram 通知。也可在你的 ChatHub 域名下打开 /settings?tab=notifications。

3. 3

   准备一个专用 Telegram 机器人、它的 token，以及接收通知的个人或管理群组的 Chat ID。

2. 准备通知机器人#

1. 1

   通过下方链接打开 @BotFather，核对用户名及认证标记，点击 START BOT 在 Telegram 中打开。

2. 2

   在 Telegram 中向 BotFather 发送 /newbot，按提示设置机器人的名称及 username。

3. 3

   复制 BotFather 提供的 token，稍后填写到 ChatHub。个人 Telegram 的 API ID/API Hash 或账户密码不能替代机器人 token。

4. 4

   打开新机器人的聊天，点击 Start 或发送 /start。如需发往管理群组，把此机器人加入该群，并确保它可以发送消息。

在 Telegram 中打开 BotFather ↗

Telegram：通过 BotFather 创建机器人 ↗

3. 确定接收通知的 Chat ID#

1. 1

   个人接收：按 ChatHub 中的提示打开 @userinfobot，在 Telegram 中点击 Start，从回复中读取自己的账户 ID。它是第三方机器人，请勿向它发送机器人 token 或客户内容。

2. 2

   使用该 ID 作为接收位置，同时确认已向新建的通知机器人发送 /start。仅打开 userinfobot 不会让通知机器人获得向你发消息的条件。

3. 3

   群组接收：向群管理员取得该群的 Chat ID。群组 ID 以负号开头，不要用个人 ID 或群显示名称代替。

4. 4

   如果管理员需要通过 Bot API 查询群 ID：把机器人加入群，向它发送群内命令，再使用可信的内部 API 工具从 getUpdates 更新中读取 message.chat.id。不要把 token 粘贴到第三方 ID 查询网站。启用 webhook 时不能同时使用 getUpdates。

5. 5

   多个接收 ID 用逗号分隔，例如 123456789, -100123456789。保留群组 ID 开头的负号。

打开 userinfobot 查看个人 ID ↗

Telegram Bot API：通过 getUpdates 读取机器人更新 ↗

4. 填写 token、通用接收位置并设置总开关#

1. 1

   机器人 token：粘贴 BotFather 提供的完整 token。已经保存 token 时，将机器人 token（已保存）字段留空会保留现有值；更换机器人或更新 token 时才填写。

2. 2

   通用接收 Chat ID：至少输入一个位置。未设置独立 Chat ID 的事件使用这些位置，测试消息也发往这里。

3. 3

   如需自动提醒，打开“启用 Telegram 通知”。启用并保存时，必须同时具备 token 和通用接收 Chat ID，即使每个事件已经设置独立接收位置。

4. 4

   如需先测试连接，可保持总开关关闭，保存 token 和通用接收位置后发送测试。测试完成后打开总开关并保存，即开始自动提醒。

服务器会加密 token，保存后不再显示其原值。“已配置”仅表示已保存 token，并不保证能够发送消息。如需暂停自动提醒，关闭“启用 Telegram 通知”并保存，原配置仍会保留。

5. 选择事件、独立接收位置和消息模板#

每种通知都有独立开关。打开后会显示独立 Chat ID 和消息内容字段；关闭后隐藏这些字段，保存后停止发送该类提醒。总开关仍控制所有自动发送。

新消息：客户向渠道发送消息。可用变量：{contact} 为客户姓名，{channel} 为渠道名称，{preview} 为最多 200 个字符的文本预览。只有文件或图片的消息可能没有文本预览。

新会话：客户首次发起会话，或重新打开已关闭的会话。可用变量：{contact}、{channel}。

会话分配：将会话分配给员工或团队。可用变量：{contact}、{assignee}；{assignee} 为被分配的员工或团队名称。取消分配不会发送此提醒。

1. 1

   选择需要接收的事件。例如只关注新消息和渠道状态时，可关闭新会话或会话分配以减少提醒。

2. 2

   独立 Chat ID 留空时使用通用接收位置。填写后，该列表会替代此事件的通用列表，不会自动向通用列表额外发送。多个 ID 可用逗号分隔。

3. 3

   在已有模板基础上修改消息内容。例如新消息可写成：💬 {contact} 通过 {channel} 发来消息，换行后添加 {preview}。

4. 4

   保持变量名称及花括号准确，仅使用字段下方列出的变量。消息以纯文本发送，不进行 HTML/Markdown 格式解析。清空内容并保存即可使用默认模板。

渠道断开连接：渠道反复掉线并需要检查时提醒。渠道重新连接：此前已报告故障的渠道恢复连接时提醒。两者均仅支持 {channel} 变量。

6. 保存并发送测试消息#

1. 1

   核对 token、全部接收位置和开关后，点击表单底部的保存。等待 Telegram 通知配置已保存的提示。

2. 2

   在测试区域点击发送测试。此操作使用已保存的 token，向通用接收 Chat ID 发送真实消息，即使总开关关闭也会发送。

3. 3

   阅读结果，并在每个接收位置打开 Telegram 检查。成功结果会显示发送到的聊天数量；测试消息不使用各事件的独立模板。

4. 4

   如有独立事件接收位置，启用并保存配置后，再通过对应的真实事件验证。通用接收位置测试成功不代表所有独立接收位置均已验证。

7. 排查问题并重新验证#

无法打开设置、保存或测试：检查账户是否具有管理系统设置的权限（settings.manage）。打开设置页面、保存配置及发送测试均需要此权限。

Token 无效或配置缺失：填写完整的 BotFather token 和通用接收 Chat ID。格式正确的 token 也可能已被撤销，需要发送测试确认。

Chat ID 无效：使用数字 ID，保留群组负号，多个接收位置用逗号分隔。不要在此字段填写手机号、显示名称或 t.me 链接。

Telegram 拒绝请求：检查 token 是否有效、是否向正确的通知机器人发送过 /start、机器人是否被屏蔽或已离开群组，并确认它有发送权限。阅读测试结果下的错误详情，定位需要修正的接收位置。

无法连接 Telegram：检查 ChatHub 服务器的互联网连接、DNS，以及防火墙是否允许访问 api.telegram.org，然后重试。

测试成功但收不到自动提醒：确认总开关及对应事件开关均已启用并保存、确实发生了匹配的新事件，且独立 Chat ID 没有把消息发送到其他位置。仅含文件或图片的消息没有文本预览可能是正常情况。