LangBot Docs
n8n

n8n を Slack に接続する

LangBot で n8n アプリを Slack のボットとして動かす手順:n8n の設定、ボットの認証情報、ネットワーク、テスト、トラブルシューティング。

このレシピではお使いの n8n アプリを Slack のボットにつなぎます。LangBot が Slack のメッセージを受け取り、パイプラインで処理して返信するので、プラットフォーム連携のコードは不要です。

n8n がワークフローを実行し、LangBot がチャットプラットフォーム、セッション、配信を担当します。メッセージごとに Webhook でワークフローを呼び出します。

必要なもの

  • 稼働中の LangBot:LangBot Cloud(サーバー不要)、または Docker や uvx langbot によるセルフホスト。
  • LangBot からネットワーク経由で到達できる n8n のアカウントまたはインスタンス。
  • アプリをインストールできる Slack ワークスペースと、Slack アプリページ で発行した App Configuration Tokens(クイックセットアップ用)。

ネットワーク

Socket Mode では LangBot から Slack へ接続するため公開イベント URL は不要です。Webhook モードでは公開 HTTPS エンドポイントが必要です。

1. n8n を準備する

  1. ワークフローを Webhook または On chat message トリガーで開始します。ストリーミング返信には Response Mode を Streaming にします。
  2. AI Agent ノード(ストリーミング)か Respond to Webhook ノードで応答し、応答キー名を LangBot の出力キー名と一致させます。
  3. Active でワークフローを有効にし、本番用 Webhook URL をコピーします。

2. パイプラインを作成する

LangBot WebUI の パイプライン でパイプラインを作成(または既定のものを編集)し、AI を次のように設定します。ランナーが一覧にない場合は、プラグイン または LangBot Space マーケット から公式ランナープラグインをインストールします。

項目設定値
ランナーn8n(公式 n8n ワークフローランナープラグイン)
Webhook URLワークフローの本番用 Webhook URL
認証方式なし、Basic Auth、JWT、Header のいずれか(トリガーノードと同じ設定)

3. Slack のボットを作成する

  1. Slack アダプターでボットを作成し、Slack クイックセットアップ を使います。アプリ、スコープ、イベント購読が自動で作成されます。
  2. Socket Mode(推奨)を選んで App-Level Token(xapp-...)を追加するか、LangBot に公開 HTTPS アドレスがあれば Webhook を選びます。設定を反映してボットを有効にします。

4. 紐付けてテストする

ボットを開いて作成したパイプラインを選び、保存してボットが有効になっていることを確認します。

アプリの メッセージ タブから話しかけるか、追加済みのチャンネルでメンションします。

トラブルシューティング

  • 返信が空の場合は、Respond to Webhook のキー名が LangBot の出力キー名と一致しているか確認します。
  • テスト URL はエディターが待ち受けている間しか使えません。有効化したワークフローの本番 URL を使います。
  • App Configuration のアクセス/リフレッシュトークンを App-Level Token 欄に入れないでください。同じアプリの xapp- トークンが必要です。
  • App-Level Token のトークンローテーションは無効のままにします。
  • WebUI の モニタリング に、すべてのメッセージ、パイプラインの実行、エラーが記録されます。

よくある質問

Slack には公開 IP のあるサーバーが必要ですか?

必ずしも必要ではありません。Socket Mode では LangBot から Slack へ接続するため公開イベント URL は不要です。Webhook モードでは公開 HTTPS エンドポイントが必要です。

Slack のボットはストリーミング返信に対応していますか?

対応状況はプラットフォーム機能一覧で確認してください。AI 側の生成が終わってから返信が送られます。

同じ n8n の設定を他のプラットフォームでも使えますか?

はい。1 つのパイプラインを複数のボットに紐付けられるので、同じ設定で複数のプラットフォームに同時に応答できます。

関連ガイド

On this page