Integrations

Slack 連携

SlackとPigeon Workflowを連携することで、チャンネルのメッセージをワークフローの入力として使ったり、処理結果をSlackに自動投稿することができます。

組織共有の連携です。Slack連携は組織の管理者（オーナー）が設定します。設定後は組織内の全メンバーがワークフローで利用できます。管理者の方は管理者ガイド › サービス連携管理を参照してください。

連携でできること

スコープ	用途
`chat:write`	テキストメッセージの投稿
`files:write`	添付ファイルのアップロード（本文との 1 メッセージ統合に必須）
`channels:read` / `groups:read`	送信先チャンネル一覧の取得
`im:write`	DM 投稿

既存連携で添付ファイル送信時に「権限不足」エラーが出る場合、設定画面から再認証してください（files:write スコープが付与されます）。

連携設定画面を開く

Pigeon Workflowダッシュボードの「設定」→「サービス連携」→「Slack」を選択します。

「Slackで認証」をクリック

「Slackで認証」ボタンをクリックすると、SlackのOAuth認証画面が開きます。

ワークスペースを選択して許可する

連携したいSlackワークスペースを選択し、「許可する」をクリックします。メッセージの読み取りと送信に必要な権限を許可します。

連携完了を確認

「Slack連携完了」と表示されれば設定完了です。ワークフローのSLACKノードでチャンネルを選択できるようになります。

プライベートチャンネルの場合

プライベートチャンネルを使う場合は、Slack側でそのチャンネルにPigeon Workflowボットを招待してください。チャンネルのメンバー招待メニューから「Pigeon Workflow」を追加できます。

「投稿があった瞬間にワークフローを実行する」リアルタイム起動は、Slack と連携するだけで利用できます。 Slack App 側での URL 登録などの設定は不要です。

Slack と連携する

上記の手順で Slack 連携を済ませます（組織で 1 回）。

対象チャンネルに Bot を招待する

投稿を検知したいチャンネルを Slack で開き、/invite で Pigeon Workflow ボットを招待します。

ワークフローでトリガーを設定する

ワークフローに Slack トリガーノード（または Slack 入力ノードのイベント受信モード）を置き、ワークスペース・チャンネル・受け取りたいイベント種別を選びます。これで投稿があるたびにワークフローが自動実行されます。

以前は Slack App 側で Event Subscriptions URL を手動登録する必要がありましたが、現在は不要です。連携と Bot 招待だけでリアルタイム受信できます。

Bot が対象チャンネルに参加しているか：Bot が参加していないチャンネルの投稿は届きません。Slack で対象チャンネルを開き /invite で Bot を招待してください。
トリガーノードのチャンネル・イベント種別：ワークフローのトリガーノードで、対象チャンネルと受け取りたいイベント種別（メッセージ投稿・メンションなど）が選択されているか確認します。
ワークフローが有効になっているか：ワークフローが有効（実行可能）な状態になっているか確認します。
Bot メッセージの除外設定：「Bot メッセージを除外」が有効な場合、ほかの Bot や Webhook の自動投稿には反応しません（通常は有効のままで問題ありません）。

認証時に以下の機能の利用を許可します。許可した権限はいつでもSlackの設定から取り消せます。

困ったときは: チャンネルが選択肢に表示されない場合は、 Slack側でPigeon Workflowボットをチャンネルに招待してください。