Slack と連携すると、ワークフローの実行結果や AI 要約完了通知などを Slack チャンネルへ送信できます。
始める前に
- Stockwork 側で接続設定を行うには 管理者 ロールが必要です。
- Slack 側では次の準備物を用意します。
- 連携先の Slack ワークスペースに対してアプリをインストールできる権限
- 通知を送りたいチャンネル（パブリック・プライベートを問わず、Stockwork Bot の招待が必要です）
Slack と接続する
- Stockwork の 設定 > 組織設定 > 外部連携 > Slack を開きます。
- Slack と連携する をクリックします。
- Slack の OAuth 認証画面がポップアップで表示されます。連携先のワークスペースを選び、リクエストされる権限を確認して 許可する をクリックします。
- Stockwork に戻り、ワークスペース名と 接続済み バッジが表示されれば連携完了です。
- 接続テスト で Bot Token が有効であることを確認します。
通知先チャンネルに Bot を招待する
通知先として選べるのは、Stockwork Bot が参加しているチャンネルだけです。 パブリックチャンネルであっても、招待していないチャンネルは一覧に表示されません。
Stockwork Bot は招待されていないチャンネルへ投稿できないため、招待前のチャンネルを一覧に出しても選んだ時点で送信に失敗します。そのため、一覧には最初から送信できるチャンネルのみを表示しています。
Slack で対象のチャンネルを開き、次のコマンドを実行してください。
<Bot名> の部分には、Stockwork の 通知チャンネル設定 に表示されている実際の Bot 名を入れます。画面上のヒントには入力すべきコマンドがそのまま表示されるので、コピーして使えます。
通知したいチャンネルが複数ある場合は、先に Slack 側でまとめて招待しておくと、Stockwork 側の読み込みが 1 回で済みます。
通知チャンネルを設定する
通知チャンネル設定 の デフォルトチャンネル ドロップダウンで、通知の既定の送信先を選択します。設定を解除する場合は 設定なし を選びます。
デフォルトチャンネルはワークフローで送信先が明示されていない場合の既定値として使用されます。ワークフローごとに個別のチャンネルを指定することもできます。
ドロップダウンは検索に対応しています。チャンネル名を入力して絞り込めるほか、チャンネル ID を貼り付けて検索することもできます。
デフォルトチャンネルを設定したら、テスト通知送信 をクリックし、実際に Slack へメッセージが届くことを確認します。
チャンネル一覧を更新する
チャンネル一覧は Slack との連携が完了した時点で自動的に読み込まれます。その後、Slack 側で Bot を新しいチャンネルへ招待した場合は、Stockwork 側で読み込み直す必要があります。
- 設定 > 組織設定 > 外部連携 > Slack を開きます。
- 通知チャンネル設定 の チャンネルを再読み込み をクリックします。
- 読み込んだチャンネル数がメッセージで表示されます。ボタンの左側には 最終読み込み の日時が表示されます。
チャンネルを再読み込み は管理者ロールのみが実行できます。通知先ドロップダウンを開いても Slack への再取得は行われないため、招待したチャンネルが表示されない場合は管理者に再読み込みを依頼してください。
同期の仕組み
- Slack への通知送信は、主に ワークフロー の Slack 通知 アクションから行います。
- 送信できる対象はパブリックチャンネルまたはプライベートチャンネルです。Slack DM への通知はサポートしていません。
- チャンネル一覧は Stockwork 側に保存されており、通知先ドロップダウンはこの保存済みの一覧を表示します。Slack への問い合わせは、連携完了時と チャンネルを再読み込み を押したときだけ行われます。
うまくいかないとき
関連ページ
