This commit is contained in:
oss-sync
@@ -3,7 +3,7 @@ id: notifications
|
||||
title: 通知を受け取る
|
||||
category: basic
|
||||
order: 70
|
||||
keywords: [通知, ブラウザ通知, Web Push, プッシュ通知, Service Worker, VAPID]
|
||||
keywords: [通知, ブラウザ通知, Web Push, プッシュ通知, Service Worker, VAPID, Webhook, Discord, Slack, Teams, Microsoft Teams]
|
||||
---
|
||||
|
||||
# 通知を受け取る
|
||||
@@ -67,3 +67,45 @@ V2 が利用できる環境では、「通知にタスクの詳細（タイト
|
||||
## 管理者向けの設定
|
||||
|
||||
V2（Web Push）の有効化には、サーバー側で `config.yaml` の `notifications.push.enabled: true` 設定と VAPID 鍵が必要です（鍵は初回起動時に自動生成されます）。サーバー側設定の概要は [設定](17-settings.md)、管理操作は [管理者向け](19-admin.md) を参照してください。
|
||||
|
||||
## ワークスペースの Webhook 通知（Discord / Slack / Microsoft Teams）
|
||||
|
||||
上記の V1/V2 は **個人向け**（自分が owner のタスクのみ）の通知ですが、Webhook 通知は **ワークスペース単位の共有通知** です。チームが使っている Discord・Slack・Microsoft Teams のチャンネルへ、タスクの完了・失敗・回答待ちを流せます。
|
||||
|
||||
### 設定手順（Discord）
|
||||
|
||||
1. ワークスペースを開き、設定 → 「Webhook 通知」タブを開く（編集権限のあるメンバーのみ操作可能）
|
||||
2. 「送信先」で Discord を選ぶ
|
||||
3. Discord のチャンネル設定 → 連携サービス から Incoming Webhook の URL を発行する
|
||||
4. ラベル・発行した URL・通知したいイベント（完了 / 失敗 / 回答待ち）を入力して追加する
|
||||
5. 「テスト送信」で疎通を確認する
|
||||
|
||||
### 設定手順（Slack）
|
||||
|
||||
1. ワークスペースを開き、設定 → 「Webhook 通知」タブを開く（編集権限のあるメンバーのみ操作可能）
|
||||
2. 「送信先」で Slack を選ぶ
|
||||
3. Slack の [Incoming Webhooks](https://api.slack.com/messaging/webhooks) アプリをワークスペースに追加し、通知したいチャンネル向けの Webhook URL（`https://hooks.slack.com/services/...`）を発行する
|
||||
4. ラベル・発行した URL・通知したいイベント（完了 / 失敗 / 回答待ち）を入力して追加する
|
||||
5. 「テスト送信」で疎通を確認する
|
||||
|
||||
### 設定手順（Microsoft Teams）
|
||||
|
||||
1. ワークスペースを開き、設定 → 「Webhook 通知」タブを開く（編集権限のあるメンバーのみ操作可能）
|
||||
2. 「送信先」で Microsoft Teams を選ぶ
|
||||
3. 通知したい Teams チャンネルの「コネクタ」（Connectors）から従来の **Incoming Webhook** を追加し、URL（`https://xxx.webhook.office.com/webhookb2/...`）を発行する
|
||||
4. ラベル・発行した URL・通知したいイベント（完了 / 失敗 / 回答待ち）を入力して追加する
|
||||
5. 「テスト送信」で疎通を確認する
|
||||
|
||||
> Microsoft は従来の Incoming Webhook コネクタ（MessageCard 形式）を段階的に非推奨化し、新しい「ワークフロー」（Power Automate、Adaptive Card 形式）への移行を進めています。現時点ではまだ広く使われている従来のコネクタ形式のみに対応しており、ワークフロー経由の URL は登録しても届きません。
|
||||
|
||||
通知本文にはデフォルトでタスクタイトル・piece 名・ワークスペース名・タスク ID・タスク詳細へのリンクが含まれます。「詳細を含める」を OFF にすると、これらを省いた最小限の通知になります。
|
||||
|
||||
### URL の扱い
|
||||
|
||||
Webhook URL は保存後に画面へ再表示されません（secret として暗号化保存）。URL を変更したい場合は「URL を変更」から新しい URL を再入力してください。
|
||||
|
||||
### 失敗時の挙動
|
||||
|
||||
- 送信に成功すると連続失敗回数は 0 に戻ります
|
||||
- **3 回連続失敗** すると設定画面に警告バッジが表示されます
|
||||
- **10 回連続失敗** すると自動的に無効化されます（「自動停止中」バッジが表示される）。編集権限のあるメンバーが「再有効化」するか、URL を再設定してください
|
||||
|
||||
Reference in New Issue
Block a user