> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stockwork.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack

Slack と連携すると、ワークフローの実行結果や AI 要約完了通知などを Slack チャンネルへ送信できます。

## 始める前に

* Stockwork 側で接続設定を行うには **管理者** ロールが必要です。
* Slack 側では次の準備物を用意します。
  * 連携先の Slack ワークスペースに対してアプリをインストールできる権限
  * 通知を送りたいチャンネル（パブリック・プライベートを問わず、Stockwork Bot の招待が必要です）

## Slack と接続する

1. Stockwork の **設定 > 組織設定 > 外部連携 > Slack** を開きます。
2. **Slack と連携する** をクリックします。

<img src="https://mintcdn.com/medium-3cf2b5dd/QzOCFOru8OkByNMR/guide/integrations/images/slack-step4-add-to-slack-button.png?fit=max&auto=format&n=QzOCFOru8OkByNMR&q=85&s=c400e3f95109c767bf292411e16b9975" alt="Slack連携ボタン" width="1512" height="862" data-path="guide/integrations/images/slack-step4-add-to-slack-button.png" />

3. Slack の OAuth 認証画面がポップアップで表示されます。連携先のワークスペースを選び、リクエストされる権限を確認して **許可する** をクリックします。

<img src="https://mintcdn.com/medium-3cf2b5dd/QzOCFOru8OkByNMR/guide/integrations/images/slack-step5-oauth-permission.png?fit=max&auto=format&n=QzOCFOru8OkByNMR&q=85&s=00e2af8c892c603885f0ad6d61c8c187" alt="Slack認可画面" width="670" height="732" data-path="guide/integrations/images/slack-step5-oauth-permission.png" />

4. Stockwork に戻り、ワークスペース名と **接続済み** バッジが表示されれば連携完了です。

<img src="https://mintcdn.com/medium-3cf2b5dd/QzOCFOru8OkByNMR/guide/integrations/images/slack-step6-connected.png?fit=max&auto=format&n=QzOCFOru8OkByNMR&q=85&s=ea5981fed95e92663bdc4346c6816bc1" alt="Slack連携完了画面" width="1512" height="862" data-path="guide/integrations/images/slack-step6-connected.png" />

5. **接続テスト** で Bot Token が有効であることを確認します。

## 通知先チャンネルに Bot を招待する

**通知先として選べるのは、Stockwork Bot が参加しているチャンネルだけです。** パブリックチャンネルであっても、招待していないチャンネルは一覧に表示されません。

Stockwork Bot は招待されていないチャンネルへ投稿できないため、招待前のチャンネルを一覧に出しても選んだ時点で送信に失敗します。そのため、一覧には最初から送信できるチャンネルのみを表示しています。

Slack で対象のチャンネルを開き、次のコマンドを実行してください。

```
/invite @<Bot名>
```

`<Bot名>` の部分には、Stockwork の **通知チャンネル設定** に表示されている実際の Bot 名を入れます。画面上のヒントには入力すべきコマンドがそのまま表示されるので、コピーして使えます。

<Tip>
  通知したいチャンネルが複数ある場合は、先に Slack 側でまとめて招待しておくと、Stockwork 側の読み込みが 1 回で済みます。
</Tip>

## 通知チャンネルを設定する

**通知チャンネル設定** の **デフォルトチャンネル** ドロップダウンで、通知の既定の送信先を選択します。設定を解除する場合は **設定なし** を選びます。

デフォルトチャンネルはワークフローで送信先が明示されていない場合の既定値として使用されます。ワークフローごとに個別のチャンネルを指定することもできます。

ドロップダウンは検索に対応しています。チャンネル名を入力して絞り込めるほか、チャンネル ID を貼り付けて検索することもできます。

デフォルトチャンネルを設定したら、**テスト通知送信** をクリックし、実際に Slack へメッセージが届くことを確認します。

## チャンネル一覧を更新する

チャンネル一覧は Slack との連携が完了した時点で自動的に読み込まれます。その後、Slack 側で Bot を新しいチャンネルへ招待した場合は、Stockwork 側で読み込み直す必要があります。

1. **設定 > 組織設定 > 外部連携 > Slack** を開きます。
2. **通知チャンネル設定** の **チャンネルを再読み込み** をクリックします。
3. 読み込んだチャンネル数がメッセージで表示されます。ボタンの左側には **最終読み込み** の日時が表示されます。

<Warning>
  **チャンネルを再読み込み** は管理者ロールのみが実行できます。通知先ドロップダウンを開いても Slack への再取得は行われないため、招待したチャンネルが表示されない場合は管理者に再読み込みを依頼してください。
</Warning>

再読み込みの際、Bot が退出させられたチャンネルは一覧から削除されます。そのチャンネルがデフォルトチャンネルに設定されていた場合は、送信できない宛先を指したままにしないため、デフォルトチャンネルの設定も自動的に解除されます。この場合はメッセージでその旨が通知されるので、改めてデフォルトチャンネルを設定してください。

## 同期の仕組み

* Slack への通知送信は、主に [ワークフロー](/guide/workflows) の **Slack 通知** アクションから行います。
* 送信できる対象はパブリックチャンネルまたはプライベートチャンネルです。Slack DM への通知はサポートしていません。
* チャンネル一覧は Stockwork 側に保存されており、通知先ドロップダウンはこの保存済みの一覧を表示します。Slack への問い合わせは、連携完了時と **チャンネルを再読み込み** を押したときだけ行われます。

## うまくいかないとき

| 症状                            | 主な原因と対処                                                                                                        |
| ----------------------------- | -------------------------------------------------------------------------------------------------------------- |
| チャンネルが一覧に表示されない               | パブリック・プライベートを問わず、Stockwork Bot が参加しているチャンネルのみ表示されます。Slack で `/invite @<Bot名>` を実行し、管理者が **チャンネルを再読み込み** を実行します |
| 招待したのに一覧に出てこない                | 招待後に **チャンネルを再読み込み** を実行したか確認します。ドロップダウンを開き直すだけでは Slack から再取得されません                                             |
| 「Botが参加しているチャンネルがありません」と表示される | Bot がどのチャンネルにも招待されていない状態です。Slack で招待してから再読み込みします。連携解除後に再連携した直後もこの状態になります                                       |
| テスト通知で「Bot がチャンネルに参加していません」   | 対象チャンネルで `/invite @<Bot名>` を実行してから、再度テスト通知を送信します                                                               |
| デフォルトチャンネルが未設定に戻っていた          | 再読み込み時に Bot がそのチャンネルから退出済みだったため自動解除されています。Slack で招待し直し、再読み込み後にデフォルトチャンネルを設定します                                 |
| 通知が届かない                       | ワークフローが **有効** になっているか、送信先チャンネルと Slack 連携状態を確認します。必要に応じて **接続テスト** で Bot Token の有効性を確認します                      |
| 再連携したい                        | 一度 **連携解除** し、改めて Slack と接続します。連携解除するとデフォルトチャンネル設定はリセットされます。再連携後は Bot をチャンネルへ招待し直す必要があります                      |

## 関連ページ

* [ワークフロー](/guide/workflows)
* [AI要約](/guide/ai/meeting-summary)
* [コールログAI要約](/guide/ai/call-summary)