Microsoft Teams の接続: 手順ガイド
Teams のチャンネルに実行結果の概要を投稿します。NEXUS_TEAMS_NOTIFY=true にすると、失敗したテストごとにメッセージも投稿します。このガイドでは、初期設定から接続確認までの手順と、発生しうるエラーの原因および解決方法を説明します。
最終更新日:
認証情報は非公開にしてください。 トークン、キー、パスワード、Webhook URL をチャットに貼り付けないでください。入力先は Studio → 設定 → 連携のみにしてください。認証情報はワークスペースの .env ファイルに保存され、画面上では点で表示されます。AI アシスタントにも同じことが当てはまります。このガイドに沿って手順を案内することはできますが、トークンを伝える必要はありません。
必要なもの
- ワークフローを追加できる Teams チャンネル。
- そのチャンネル用の Workflows の Webhook URL 1 つ。
認証情報を取得する
- Teams で、チャネルの ··· メニュー → ワークフローを開き、"Webhook 要求を受信したときにチャネルに投稿する"を追加します。
- 表示された Webhook URL をコピーします。ドメインは logic.azure.com (旧コネクタの場合: webhook.office.com) です。URL 自体が秘密情報です。
- クリップボードに保持してください。Studio (次の手順) 以外には貼り付けないでください。
Studio で接続する
- Studio で、設定 → 連携 → Microsoft Teams を開きます。
- Webhook URL を貼り付け、保存 & テスト送信を押します。チャンネルにテストメッセージが送信されます。
TEAMS_ENABLEDを有効にします。失敗したテストごとにメッセージを送信するには、NEXUS_TEAMS_NOTIFYも有効にします。
動作を確認する
- テストメッセージを送信すると "送信しました。" と表示され、チャンネルにメッセージが届きます。
- 任意のテストを実行します。チャンネルに実行結果の概要が届きます。
よくあるエラー
| 確認できる結果 | 原因 | 解決方法 |
|---|---|---|
| "Webhook がありません" | TEAMS_WEBHOOK_URL が空です。 | 設定 → 連携に Webhook URL を貼り付けて保存します。 |
"TEAMS_WEBHOOK_URL は Teams の Webhook ではありません" | 値が logic.azure.com または webhook.office.com の https URL ではありません。 | ワークフローの"Webhook 要求を受信したときにチャネルに投稿する"トリガーから URL をもう一度コピーします。 |
| Teams からの HTTP 4xx または 5xx 応答 | ワークフローが無効化または削除されたか、所有者が組織を離れたかライセンスを失ったため、実行されなくなっています。 | Teams でワークフローを開き (ワークフロー → 管理)、有効にするか新しく作成して、新しい URL を保存します。 |
| "Teams に接続できませんでした (ENOTFOUND)" または "20 秒以内に応答がありませんでした" | VPN やプロキシ、またはネットワーク未接続のため、この PC から Microsoft に接続できません。 | 同じ PC でネットワーク接続を確認して再試行します。 |
| テスト送信は成功するが、失敗の通知が投稿されない | TEAMS_ENABLED が false であるか、実行概要のみが有効になっています: テストごとのメッセージ送信には NEXUS_TEAMS_NOTIFY=true が必要です。 | 両方のスイッチを有効にします。 |
設定キー
| キー | 主な機能 | 有効な値 | 確認方法 |
|---|---|---|---|
TEAMS_ENABLED | Microsoft Teams に通知を送信 | true または false | テストメッセージが届いてから有効にします。 |
TEAMS_WEBHOOK_URL | 通知先のTeamsチャネル (機密情報、このコンピューターにのみ保存) | https://…logic.azure.com または …webhook.office.com の URL | テストメッセージを送信すると、チャンネルに投稿されます。 |
NEXUS_TEAMS_NOTIFY | 失敗ごとに Teams に通知 | true または false | 実行結果の概要だけでなく、失敗したテストごとにメッセージが届きます。 |
詳細: すべての連携, 設定ガイド, 問題の解決方法. その他のガイド: Jira Cloud, Azure Boards, Slack, Telegram, GitHub Issues.
まだ解決しませんか? Studioに表示されるエラー行をそのまま添えて、[email protected]までご連絡ください。トークンは記載しないでください。