# Slack 連携

> OAuth で Latchkey を Slack チャネルに接続し、投稿内容を選択し、接続をテストします。

Source: https://latchkey.dev/ja/documentation/slack-integration

## Summary

- owner/admin が **Settings, Notifications** で OAuth 経由で接続します: Add to Slack、認可中にチャネルを選択、完了。貼り付ける webhook はありません。
- Test、Reconnect（チャネルの変更）、Remove で接続を管理します。
- 通知マトリックスで、どのイベントタイプを Slack に投稿するかを選択します。

Slack 連携は、チームがすでに見ているチャネルに Latchkey の通知を投稿します。セットアップは、ワークスペースの owner または admin が行う一度きりの OAuth フローです。

## 接続する

1. **Settings, Notifications を開く** Slack Integration カードは通知設定の隣にあります。owner と admin が管理できます。
2. **Add to Slack をクリックする** Slack に移動して Latchkey を認可し、認可自体の中でチャネルを選択します。コピー＆ペーストする webhook URL はありません。完了すると Slack が設定ページに戻します。
3. **接続を確認する** カードにはチャネル名とともに **Connected** が表示され、さらに **Test**、**Reconnect**、**Remove** のボタンが表示されます。テストメッセージを送信して、届くことを確認してください。
4. **Slack に投稿する内容を選ぶ** 通知マトリックスで、チームがチャネル内で見たいイベントタイプについて Slack チャネルを有効にします（多くのチームは Critical 階層に free-tier とトライアルの警告を加えたものから始めます）。マトリックス内の Slack トグルは admin 専用です。メンバーは個人のメール、プッシュ、ダイジェストの選択を保持します。

> ****
> 対象チャネルを変更するには、**Reconnect** を使い、Slack の認可中に別のチャネルを選択します。**Remove** は連携を完全に切断します。ダッシュボードの通知履歴には影響しません。

## チャネルに届くもの

概念的には、すべてのメッセージは同じ方法で組み立てられます: どのイベントが発生したか、そして詳細が存在するダッシュボードへ戻るリンクです。Slack には見出しが届き、ダッシュボードにはストーリーがあります: 実行、数値、レポートです。チャネル内にデータの壁が来るのではなく、クリックして先に進むよう促されると考えてください。

そのため、書式よりもチャネルの選択の方が重要です。チームが実際に見ているチャネルを選んでください: 混雑した general チャネルに投稿されたアラートはスクロールで流れ去りますが、専用のアラートチャネルは CI のシグナルを見える状態に保ちます。Slack は他のすべてのチャネルと同じタイプごとのマトリックスとタイプごとのクールダウンに従うため、うるさいパイプラインがチャネルを重複で埋め尽くすことはありません。

## トラブルシューティング

| 症状 | 対処法 |
| --- | --- |
| テストメッセージが届かない | カードに、想定するチャネルとともに **Connected** が表示されていることを確認し、別のテストを送信します。それでも失敗する場合は、**Reconnect** を使って認可をやり直します。 |
| メッセージが届かなくなった | **Reconnect** を使い、Slack の認可中に現在のチャネルを選択します。これで接続がエンドツーエンドで更新されます。 |
| 特定のイベントタイプが決して投稿されない | Slack はイベントタイプごとに有効化されます: 通知マトリックスで、そのタイプについて Slack チャネルがオンになっているか確認します。 |
| Slack カードが表示されない | Slack の設定は owner と admin 専用です。メンバーは連携を管理しません。 |
| Latchkey を Slack から完全に外したい | **Remove** は連携を切断します。ダッシュボードの通知履歴には影響しません。 |

Slack にルーティングできるイベントタイプと階層の完全な一覧については、[通知](/documentation/notifications) を参照してください。

### Slack と Latchkey を連携するには?

owner または admin が Settings の Notifications を開き、Add to Slack を選びます。チャンネルは Slack 側の認可画面で選択し、設定はそれだけです。Webhook URL を生成したり貼り付けたりする必要はありません。

### メッセージを受け取る Slack チャンネルを変えるには?

Reconnect を使うと OAuth フローが再実行され、別のチャンネルを選べます。Test はメッセージを送信するので、運用に組み込む前に接続を確認できます。Remove でワークスペースの連携を解除します。

### すべての通知が Slack に送られますか?

通知マトリクスで選択したイベント種別のみです。Slack はメールやブラウザのプッシュと並ぶチャネルの 1 つで、イベントごとに選べるため、重要なイベントだけをチャンネルに送り、情報系のイベントは送らないという設定ができます。

---

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