n8n を WeCom インテリジェントボットに接続する

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

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

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

必要なもの

稼働中の LangBot：LangBot Cloud（サーバー不要）、または Docker や uvx langbot によるセルフホスト。
LangBot からネットワーク経由で到達できる n8n のアカウントまたはインスタンス。
長期接続 API モードの WeCom インテリジェントボット：BotID と長期接続用 Secret。ワンクリック設定で自動入力できます。

長期接続モードでは公開コールバック URL は不要です。もう一方のコールバック URL モードでは必要で、両モードは同時に使えません。

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

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

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

WeCom インテリジェントボット アダプターでボットを作成して ワンクリック設定 を使うか、WeCom でボットを作って API モードを 長期接続 に切り替え、BotID と Secret を入力します。
ボットの公開範囲を設定し、保存して有効化します。

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

WeCom クライアントでボットを見つけて個別に話しかけ、グループに追加してメンションします。

返信が空の場合は、Respond to Webhook のキー名が LangBot の出力キー名と一致しているか確認します。
テスト URL はエディターが待ち受けている間しか使えません。有効化したワークフローの本番 URL を使います。
長期接続の Secret はコールバックモードの Token/EncodingAESKey とは別物です。API モードをコールバック URL に切り替えると既存の長期接続は無効になります。
WebUI の モニタリング に、すべてのメッセージ、パイプラインの実行、エラーが記録されます。