# 通知

> Latchkey が送信できるすべての通知、配信チャネル、重要度の階層、およびイベントタイプごとの調整方法。

Source: https://latchkey.dev/ja/documentation/notifications

## Summary

- Critical、Important、Informational の階層にまたがる11のイベントタイプ。
- イベントごとのチャネル: メール、Slack、ブラウザプッシュ。informational イベントは週次の Digest トグルを使い、すべてはアプリ内のベルに届きます。
- トライアル警告のメールを除き、すべてはデフォルトでオフから始まります。マスタートグルと一括ボタンで調整は素早く済みます。

Latchkey は、注意が必要なときに通知します: パイプラインが繰り返し壊れている、AI スキャンがあなたの承認を待っている、トライアルや無料分の残りが少なくなっている、レビューする価値のある新しいインサイトがある、などです。すべては **Settings, Notifications** で設定します。

## チャネル

- **メール** イベントタイプごと。"Trial ending soon" と "Trial expired" を除き、デフォルトでオフです。
- **Slack** OAuth で一度接続するチャネルへ（[設定ガイド](/documentation/slack-integration)）。
- **ブラウザプッシュ** Notifications 設定タブで許可を付与した後。
- **週次ダイジェスト** informational イベントはイベントごとのメールの代わりに Digest トグルを使い、1通の週次メールにまとめられます。

すべては、チャネル設定に関わらず、ダッシュボードヘッダーのアプリ内 **通知ベル** にも届きます。パネルは未読数を添えた "Notifications" ヘッダーの下に開き、**Mark all read** はワンクリックで未読の山を片付け、フッターは期待値をまっすぐに保ちます: "Showing the last 7 days - Manage preferences in Settings"。

## 重要度の階層とデフォルト

イベントタイプは 3 つの階層に分類されます: **Critical**、**Important**、**Informational**。すべてのチャネルはデフォルトで **オフ** ですが、例外が 2 つあります: 「トライアル終了間近」と「トライアル期限切れ」はメールがオンなので、期限切れのトライアルが黙って過ぎることはありません。また Informational 階層の **週次ダイジェスト** もオンなので、オプトインしなくても週次のサマリーが届きます。階層ごと、チャネルごとのマスタートグルで、グループ全体を一度に切り替えられます。

うるさめのタイプには独自の頻度上限もあります: "Managed runner blocked" は1日に最大1回、"Free tier running out" はしきい値ごとに1日に最大1回送信され、"Pipeline is broken" は赤い実行のたびに知らせるのではなく、7回連続の失敗で発火し、20回でもう一度だけエスカレートします。最初の通知がすべてのシグナルを運びます。繰り返しはチャネルを無視するように仕向けるだけです。

## 通知される可能性のあるもの

| 通知 | 発生条件 | 階層 |
| --- | --- | --- |
| Pipeline is broken | 7回以上連続したワークフローの失敗が検出された。20回でもう一度エスカレート | Critical |
| Scan failed | AI スキャンが完了しなかった。runners ページから再試行 | Critical |
| AI scan runner build didn't finish | AI スキャンランナーイメージのビルドが失敗した。タップして再試行 | Critical |
| Managed runner blocked | サブスクリプションまたは使用上限のためにマネージドランナーが起動できなかった。1日に最大1回 | Critical |
| Trial expired | 無料トライアルが終了した。ランナーを維持するにはプランを追加 | Critical |
| Scan ready for review | AI リポジトリスキャンが完了し、ランナー構成があなたの承認を必要としている | Important |
| AI scan runner is ready | AI がビルドしたランナーイメージが完成し、使用可能になった | Important |
| Free tier running out | 含まれるランナー分の80%、次に100%を超えた。しきい値ごとに1日に最大1回、支払い方法が登録されていない場合のみ | Important |
| Trial ending soon | トライアルの残りが3日以下 | Important |
| New insights found | 夜間スキャンがレビューすべき新しい節約またはリスクを発見した | Informational |
| Insight applied | 適用されたインサイトのプルリクエストがマージされた | Informational |

## 推奨される基準

ほぼすべてがオフから始まるため、受け取りたかったと悔やむアラートを待つのではなく、意図的に姿勢を選んでください。これがほとんどのチームで有効です:

| 階層 | 推奨されるルーティング | 理由 |
| --- | --- | --- |
| Critical | メールに加えて Slack | 今すぐ対応すべきイベント: 壊れたパイプライン、失敗したスキャン、ブロックされたランナー起動、期限切れのトライアル。これらはチームが最初に見る場所に属します。 |
| Important | メール。free-tier とトライアルの警告には Slack を追加 | 日単位の緊急度。トライアルのメールはすでにデフォルトでオンです。予算の警告は、ブロックが起きた後ではなく前に、チーム全体の目に触れさせる価値があります。 |
| Informational | 週次の Digest トグル | 新しいインサイトと適用されたインサイトは、単発メールが少しずつ届くよりも、1つの週次バッチにまとまっている方が読みやすいです。 |

適用する際の2つの注意点。Slack のルーティングは admin 専用ですが、各メンバーは自分自身のメール、プッシュ、ダイジェストの選択を保持します。そのため基準は実際には2つの別々の決定です: 共有の Slack チャネルと、あなた個人のチャネルです。そしてブラウザプッシュは個人的なものとして扱うのが最適です: CI の問題に最初に対応する人が自分であれば、Notifications 設定タブで許可を付与した後、自分自身に対して有効にします。

## 週次ダイジェストの動作

ダイジェストは informational 階層の居場所です。緊急度の低いイベント（夜間スキャンが発見した新しいインサイト、適用されたインサイトのプルリクエストのマージ）は、1つずつ届く代わりに1通の週次メールにまとめられます。これが、informational タイプが設定マトリックスでイベントごとのメールトグルではなく **Digest** トグルを表示する理由でもあります: あなたが行っている選択は、そのタイプがまとめに参加するかどうかです。

推奨される習慣: ダイジェストを週次レビューのキューとして扱います。その中に当日の対応を必要とするものはありませんが、レビューされていないインサイトは、誰も見なければ積み重なっていきます。次のタブに [最適化インサイト](/documentation/optimization-insights) を開いた状態で、短い週次の流し読みをすれば通常は十分です。

## 設定の調整

- 各イベントタイプには設定マトリックスにチャネルごとのトグルがあります。informational タイプはイベントごとのメールの代わりに Digest トグルを公開します。
- **Shortcuts** は大まかな変更をカバーします: マスタートグルは階層全体またはチャネル列全体を一度に切り替え、**Mute all email** はワンクリックでメールを無音化し、**Critical only** はページに値するアラートだけを残し、**Reset to defaults** は標準設定を復元します。
- **Save changes** をクリックするまで何も適用されません。ページは "Preferences saved." と表示して確認します。
- Slack の設定は admin 専用です。メンバーは個人のメール、プッシュ、ダイジェストの選択を保持します。
- すべての通知メールには、受信トレイ側からオプトアウトしたい場合のための **unsubscribe link** も含まれています。

### 既定で有効になっている通知は?

トライアル警告のメールを除き、すべて無効から始まります。新しいワークスペースは意図的に静かな状態です。マトリクスでイベントごとに必要なものを有効にするか、マスタートグルと一括ボタンで素早く初期設定できます。

### 各イベントで使えるチャネルは?

メール、Slack、ブラウザのプッシュ通知を、Critical・Important・Informational の各層のイベント種別ごとに選べます。Informational のイベントは個別に発火せず週次ダイジェストにまとめられ、チャネルに関わらずすべてアプリ内のベルにも届きます。

### イベントの種類はいくつありますか?

11 種類あり、3 つの重要度層に分かれています。Critical は人の作業を中断させる価値があるもの、Informational は週次でまとめて読む方が適しており、そのためにダイジェストがあります。

---

Latchkey runs CI/CD that repairs its own failures. Agent entry points: https://latchkey.dev/agent.txt, https://latchkey.dev/openapi.json, https://latchkey.dev/llms.txt