n8n を WeChat 公式アカウントに接続する

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

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

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

必要なもの

稼働中の LangBot：LangBot Cloud（サーバー不要）、または Docker や uvx langbot によるセルフホスト。
LangBot からネットワーク経由で到達できる n8n のアカウントまたはインスタンス。
WeChat 公式アカウントまたはサービスアカウント：AppID、AppSecret、サーバー設定の Token と EncodingAESKey。LangBot サーバーの IP を IP ホワイトリスト に追加します。

公式アカウントには公開ドメインと HTTPS が必要で、コールバックには 5 秒以内に応答しなければなりません。AI の応答が遅い場合は passive または auto を使います。LangBot Cloud には公開ドメインがあります。

ワークフローを 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 のいずれか（トリガーノードと同じ設定）

WeChat 公式アカウント アダプターでボットを作成し、返信モードを選びます：drop（5 秒のコールバック内で返信）、passive、または auto（企業認証済みアカウントならカスタマーサービス API で後から返信）。
ボットのコールバック URL をアカウントのサーバー設定に貼り付けて保存します。

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

WeChat でアカウントをフォローし、メッセージを送ります。