Slack 連携

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

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

接続する#

Settings, Notifications を開く

Slack Integration カードは通知設定の隣にあります。owner と admin が管理できます。

Add to Slack をクリックする

Slack に移動して Latchkey を認可し、認可自体の中でチャネルを選択します。コピー＆ペーストする webhook URL はありません。完了すると Slack が設定ページに戻します。

接続を確認する

カードにはチャネル名とともに Connected が表示され、さらに Test、Reconnect、Remove のボタンが表示されます。テストメッセージを送信して、届くことを確認してください。

Slack に投稿する内容を選ぶ

通知マトリックスで、チームがチャネル内で見たいイベントタイプについて Slack チャネルを有効にします（多くのチームは Critical 階層に free-tier とトライアルの警告を加えたものから始めます）。マトリックス内の Slack トグルは admin 専用です。メンバーは個人のメール、プッシュ、ダイジェストの選択を保持します。

チャネルに届くもの#

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

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

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

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

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