GetMyBot 知识库

项目与渠道

创建项目、连接机器人并查看运行状态;了解多渠道、令牌更换、暂停与冻结。

本页内容

项目汇集一项机器人或服务的设置、反应规则和数据。渠道是具体的沟通入口,例如 Telegram 机器人、网站聊天或其他消息平台。一所学校可以用同一个项目同时服务 Telegram 和网站。

在项目中创建项目,再添加渠道。连接 Telegram 需要 @BotFather 提供的令牌。您可在后台顶部切换项目。还可将 WhatsApp 和 VK 接入同一项目,共用反应规则。参见渠道和 WhatsApp。

连接机器人

  1. 在项目点击添加项目,然后在卡片上点添加渠道,选择 Telegram。第一台机器人也可以跟随初次使用向导操作。
  2. 粘贴 @BotFather 发来的令牌,点击验证。页面显示找到的 @username,便于确认令牌属于正确的机器人。
  3. 点击连接。令牌会加密保存,系统立即开始接收更新。

项目卡片列出 Telegram 及其他渠道、项目名称、机器人 @username、用户数、启用的规则数和今日请求数。请求余额见付款或统计。

多台机器人

一个账号可管理多个项目和机器人,数量受套餐的“最多机器人”限制。在顶部或项目页切换项目;“反应”“聊天”和“统计”只显示当前项目的数据。

机器人如何接收消息

连接后,GetMyBot 自动接收 Telegram 的消息、按钮点击、入群及支付事件,无需另行设置。令牌须有效。根据服务器配置,Telegram 可将事件推送到平台地址(webhook),也可由平台定时向 Telegram 拉取(long polling)。

开启和关闭

在设置中的机器人状态卡片可开启 / 关闭机器人。关闭后不会响应消息,修改立即生效,无需重新连接。

项目状态与渠道可用性

项目列表分别显示项目状态运行中、已暂停或已冻结,以及每个渠道的状态在线、无信号、已配置、已关闭或项目未运行。项目状态本身并非 Telegram 投递检查;只有网页聊天而没有 Telegram 的活跃项目也不应显示为停止。

如果活跃项目恰有一个已开启的 Telegram 渠道,在线表示负责它的进程最近有心跳;否则显示无信号。若有多个已开启的 Telegram 渠道,显示已配置,因为项目级心跳无法可靠归给其中一个。其他平台的已开启渠道显示已配置,不代表每条消息一定送达。

平台有多个同等的工作进程,每个进程每 30 秒报告自己负责的机器人。90 秒内的心跳视为新鲜,漏报一次不会导致状态闪烁。

  • 状态有延迟。连接或平台重启后,可能要等到上述时间窗口内才显示“在线”。
  • 已开启的 Telegram 渠道持续几分钟“无信号”时,检查令牌及设置中的机器人健康状况。除非您暂停项目或套餐导致冻结,项目仍保持活跃。
  • 心跳由进程共同报告,与响应后台页面请求的是哪台服务器无关;多个 Telegram 渠道的共同心跳无法证明每个渠道都可用。

机器人离线时会发生什么

平台每分钟检查一次心跳。已开启的机器人没有新鲜心跳时,会创建一次故障事件,分析原因并尝试自动恢复。设置中的机器人健康状况可见四类原因:

  • webhook:Telegram 无法向平台地址投递更新,平台重新注册地址。
  • 令牌已撤销:getMe 返回 401;不会靠重启解决,需要在 @BotFather 换令牌,再通过更换令牌填写。
  • 没有服务进程:无人处理更新,平台重启机器人。
  • 原因不明:Telegram 未响应检查。

重启与同步按钮做同样的事:用 getMe 检查令牌并重新注册 webhook。尝试之间的等待时间逐渐增长;每次尝试的时间、结果及错误会记入故障的重启日志,下一次尝试时间也显示在卡片上。

当机器人静默超过健康卡片中的阈值(默认 5 分钟),所有者会在通知铃及邮箱收到“机器人离线”,通知接收列表中的聊天会收到机器人发出的消息。每次故障只通知一次;心跳恢复后会发送“机器人重新上线”及中断时长。历史故障及其时长、原因保留在同一张卡片。

套餐导致的冻结

除开关状态外,机器人还可能被平台冻结,原因只有两种:

  • 超过机器人数限制:切换到允许机器人更少的套餐。
  • 订阅未续费:付费套餐到期后改用免费套餐及其限制。

冻结的机器人不接收消息;接收更新会被关闭,而不只是显示一个标记。数据、规则及订阅用户均保留,可以恢复。

解冻方法:购买足以覆盖所需机器人数的套餐。付费套餐激活时,平台按机器人创建时间从最旧开始恢复,直到达到新套餐上限。不能单独挑选要恢复的机器人。如需优先保留较新的机器人,请先移除多余连接,再购买套餐。

账号整体也可能单独被冻结,此时全部机器人和群发都暂停,后台出现“账号已冻结”横幅。仅支持团队可解除。参见付款与余额。

资料与同步

在设置中点击同步,可从 Telegram 更新机器人名称(例如在 @BotFather 改名后)。机器人头像会自动获取。

更换令牌

如果你在 @BotFather 中重新生成了令牌(Bot Settings → Revoke / New token),请在设置 → 渠道 → Telegram 🔑中更新。新令牌必须属于同一个机器人(Telegram 内部 ID 相同)——这样可保留所有反应、订阅者和数据。 如果未显示 Telegram 频道,请在同一窗口中选择«更换令牌»。

将机器人交给其他账号

设置 → 更换所有者会按邮箱向另一个 GetMyBot 账号发送项目转移邀请,有效期 72 小时。对方接受前,项目仍属于您,也可取消邀请;接受后,所有者改变,您会失去项目访问权。适用于移交给客户或同事。

机器人模板

模板是机器人设置与全部反应规则的快照,可用于其他机器人:

  • 设置中的创建模板会保存当前机器人的快照并命名。
  • 应用模板会用模板设置替换目标机器人的设置,并将模板中的规则添加到原有规则中。

可用来为多个项目建立同类机器人。

从目录安装现成方案

现成方案目录提供安装向导:填写参数,检查兼容性和所需连接,再核对即将创建的资源。安装后完成剩余步骤,并用测试请求检查流程。它与应用上述机器人快照不同。安装前检查可指出缺失参数或功能;清单上完成某一步,不等于外部服务已正常运行。

现成方案的指标

选择评估已安装方案的时间范围。比较时选择可用的比较方式,并查看样本量和诊断信息。数据不足或没有比较,与指标值为零是不同情况。

接下来