Telegram への接続: 手順ガイド
ご自身のボットを通じて、失敗時の通知 (NEXUS_TELEGRAM_NOTIFY=true の場合はテストごとに1件) と、共有対象に選んだレポートやファイルを送信します。共有ボットはありません。このガイドでは、最初の準備から接続確認までの手順を説明し、発生しうるエラーとその原因、解決方法を紹介します。
最終更新日:
認証情報は非公開にしてください。 トークン、キー、パスワード、Webhook URL をチャットに貼り付けないでください。入力先は Studio → 設定 → 連携のみにしてください。認証情報はワークスペースの .env ファイルに保存され、画面上では点で表示されます。AI アシスタントにも同じことが当てはまります。このガイドに沿って手順を案内することはできますが、トークンを伝える必要はありません。
必要なもの
- Telegram アカウント。
- @BotFather で一度作成した自分専用のボットと、そのトークン。
- ペアリング用 QR コードを読み取るためのスマートフォンまたは Telegram アプリ。
- 有効にする前に: Telegram はレポートや PDF などのファイルを受信でき、それらは Telegram のサーバーに送信されます。規制対象の環境では、事前にコンプライアンス担当部門に確認してください。
認証情報を取得する
- Telegram で https://t.me/BotFather を開き、/newbot を送信します。ボットに名前とユーザー名を設定します。
- BotFather からボットのトークン (例: 123456:ABC…) が返信されます。これをコピーします。
- クリップボードに保持してください。Studio (次の手順) 以外には貼り付けないでください。
Studio で接続する
- Studio で、設定 → 連携 → Telegram に接続を開きます。
- ボットのトークンを貼り付けて保存します。ペアリング用 QR コードが表示されます。
- スマートフォンで QR コードを読み取り、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を送信してトークンを再取得し (または新しいボットを作成し)、保存します。 |
| "読み取る前にQRコードの有効期限が切れました" | QRコードの有効期間は数分間のみです。 | 「Telegramに接続」を押して新しいQRコードを作成し、すぐに読み取ってください。 |
| QRコードを読み取ったのにStudioが待機したままになる | 読み取りでチャットは開きましたが「開始」が押されていないか、Studioのウィンドウが閉じられています。 | ボットのチャットで「開始」を押してください。まだ待機したままの場合は、新しいQRコードを作成してください。 |
| "Telegramに接続できませんでした (ENOTFOUND)" または "20秒以内に応答がありませんでした" | このPCはapi.telegram.orgに接続できません: VPN、ファイアウォール、プロキシの影響か、ネットワークに接続されていないことが原因です。 | 同じ PC でネットワーク接続を確認して再試行します。 |
| 失敗しても通知が届かない | TELEGRAM_ENABLEDがfalse、チャットが未連携、またはテストごとの通知 (NEXUS_TELEGRAM_NOTIFY) が無効になっています。 | チャットを連携し、両方のスイッチを有効にしてください。 |
設定キー
| キー | 主な機能 | 有効な値 | 確認方法 |
|---|---|---|---|
TELEGRAM_ENABLED | Telegramに通知を送信 | true または false | 連携用QRコードを表示するには有効にする必要があります。 |
TELEGRAM_TOKEN | Telegramボットのアクセスコード (機密情報、このコンピューターにのみ保存) | BotFatherから取得したボットのトークンを1行で入力、例: 123456:ABC… | Telegramがトークンを受け付けた場合にのみQRコードが表示されます。 |
TELEGRAM_CHAT_ID | 通知先のTelegramチャット | QRコードでの連携時に自動入力されます。手動で入力しないでください | Studioに"通知先チャット …"と表示されます。 |
NEXUS_TELEGRAM_NOTIFY | 失敗ごとにTelegramに通知 | true または false | 失敗したテストごとに1件の通知が届きます。 |
詳細: すべての外部連携, 設定ガイド, 問題の解決方法. その他のガイド: Jira Cloud, Azure Boards, Slack, Microsoft Teams, GitHub Issues.
まだ解決しませんか? Studioに表示されるエラー行をそのまま添えて、[email protected]までご連絡ください。トークンは記載しないでください。