n8n を WeCom（社内アプリ）に接続する

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

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

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

必要なもの

稼働中の LangBot：LangBot Cloud（サーバー不要）、または Docker や uvx langbot によるセルフホスト。
LangBot からネットワーク経由で到達できる n8n のアカウントまたはインスタンス。
WeCom の自社開発アプリ：企業 ID、アプリの Secret、連絡先同期 Secret、コールバック用の Token と EncodingAESKey。

WeCom はコールバック URL にメッセージを送るため、LangBot には公開ドメインと HTTPS が必要です（リバースプロキシと SSL を参照）。LangBot Cloud にはすぐ使える公開 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 アダプターでボットを作成し、企業 ID、アプリ Secret、連絡先同期 Secret を入力して有効化し、Webhook コールバック URL をコピーします。
WeCom 管理画面の メッセージ受信 → API 受信の設定 に URL を貼り、Token と EncodingAESKey を生成して、先に LangBot、次に WeCom で保存します。LangBot の送信元 IP を 企業の信頼 IP に追加します。

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

WeCom クライアントでアプリを開き、メッセージを送ります。

返信が空の場合は、Respond to Webhook のキー名が LangBot の出力キー名と一致しているか確認します。
テスト URL はエディターが待ち受けている間しか使えません。有効化したワークフローの本番 URL を使います。
コールバック保存時に request URL failed となる場合は、URL が公開 HTTPS で到達できないか、LangBot の Token/EncodingAESKey が一致していません。
返信が送れない場合は、LangBot の送信元 IP を企業の信頼 IP に追加します。
WebUI の モニタリング に、すべてのメッセージ、パイプラインの実行、エラーが記録されます。