连接 Telegram:分步指南
通过您自己的机器人发送失败警报(设置 NEXUS_TELEGRAM_NOTIFY=true 时,每个测试各发送一条),以及您选择分享的报告和文件。不使用共享机器人。本指南将带您从零开始完成连接并验证,同时列出可能遇到的错误、原因和解决方法。
最后更新:
请妥善保管您的凭据。切勿将令牌、密钥、密码或 Webhook URL 粘贴到聊天中。请仅在 Studio → 设置 → 集成中输入,凭据会保存到工作区的 .env 文件中,并以圆点显示。对 AI 助手也是如此: 它可以指导您完成本指南中的步骤,但绝不需要您的令牌。
所需准备
- 一个 Telegram 账号。
- 一个通过 @BotFather 创建的自有机器人及其令牌,只需创建一次。
- 用于扫描配对二维码的手机或 Telegram 应用。
- 启用前请注意:Telegram 可以接收报告和 PDF 等文件,这些文件会发送到 Telegram 的服务器。如果您所在的环境受监管,请先咨询合规团队。
获取凭据
- 在 Telegram 中打开 https://t.me/BotFather 并发送 /newbot。为机器人设置名称和用户名。
- BotFather 会回复机器人令牌(例如 123456:ABC…)。请复制该令牌。
- 将其保留在剪贴板中。除 Studio (下一步) 外,请勿粘贴到任何其他位置。
在 Studio 中连接
- 在 Studio 中,打开设置 → 集成 → 连接 Telegram。
- 粘贴机器人令牌并保存。配对二维码随即显示。
- 用手机扫描二维码,然后在 Telegram 中点击开始。几秒钟内,Studio 会显示 "警报将发送到聊天 …",机器人会回复 "已连接到 Nexus StudioQA。"
- 启用
TELEGRAM_ENABLED。如需每个失败的测试各发送一条警报,还需启用NEXUS_TELEGRAM_NOTIFY。
验证连接是否正常
- 扫描后,机器人会向您的聊天发送 "已连接到 Nexus StudioQA。失败的测试将在此报告。"
- Studio 显示 "警报将发送到聊天",聊天信息会被部分隐藏。
常见错误
| 你看到的现象 | 原因 | 解决方法 |
|---|---|---|
| "Telegram 已关闭" | TELEGRAM_ENABLED 为 false,配对需要将其启用。 | 启用 TELEGRAM_ENABLED,然后再次点击连接 Telegram。 |
| "未提供机器人令牌" | TELEGRAM_TOKEN 为空。 | 在设置 → 集成中粘贴从 BotFather 获取的令牌并保存。 |
| "Telegram: 未授权" (或 "未找到") | 机器人令牌有误、已在 BotFather 中撤销,或复制时不完整。 | 向 BotFather 发送 /token 以重新获取令牌 (或创建新机器人),然后保存令牌。 |
| "二维码在扫描前已过期" | 二维码仅在几分钟内有效。 | 点击连接 Telegram 以生成新的二维码,并立即扫描。 |
| 已扫描二维码,但 Studio 仍在等待 | 扫描后打开了聊天,但未点击开始,或 Studio 窗口已关闭。 | 在机器人的聊天中点击开始。如果仍在等待,请生成新的二维码。 |
| "无法连接 Telegram (ENOTFOUND)" 或 "未在 20 秒内响应" | 此电脑无法连接 api.telegram.org: 可能是 VPN、防火墙或代理导致,或没有网络连接。 | 在同一台电脑上检查网络,然后重试。 |
| 失败后未收到警报 | TELEGRAM_ENABLED 为 false、未配对聊天,或未开启逐项测试警报 (NEXUS_TELEGRAM_NOTIFY)。 | 配对聊天,并开启这两个开关。 |
设置键
| 键 | 功能 | 有效值 | 如何检查 |
|---|---|---|---|
TELEGRAM_ENABLED | 向 Telegram 发送警报 | true 或 false | 需要开启此开关才能生成配对二维码。 |
TELEGRAM_TOKEN | Telegram 机器人访问码 (保密,仅保存在此电脑上) | 从 BotFather 获取的机器人令牌,例如 123456:ABC…,仅一行 | 只有 Telegram 接受该令牌后,才会显示二维码。 |
TELEGRAM_CHAT_ID | 用于接收警报的 Telegram 聊天 | 通过二维码配对自动填写;请勿手动输入 | Studio 显示 "警报将发送到聊天 …"。 |
NEXUS_TELEGRAM_NOTIFY | 每次失败时发送 Telegram 警报 | true 或 false | 每个失败的测试都会发送一条警报。 |
更多: 所有集成, 设置指南, 故障排查. 其他指南: Jira Cloud, Azure Boards, Slack, Microsoft Teams, GitHub Issues.
仍然遇到问题?请发送邮件至 [email protected],附上 Studio 显示的完整错误行。请勿包含令牌。