n8n を DingTalk に接続する

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

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

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

必要なもの

稼働中の LangBot：LangBot Cloud（サーバー不要）、または Docker や uvx langbot によるセルフホスト。
LangBot からネットワーク経由で到達できる n8n のアカウントまたはインスタンス。
DingTalk アプリロボット（Client ID と Client Secret）。ワンクリック設定でスマートフォンから認可すると自動入力されます。

Stream モードでは LangBot から DingTalk へ接続するため、公開コールバック 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 のいずれか（トリガーノードと同じ設定）

DingTalk アダプターでボットを作成して ワンクリック設定 を使うか、ロボットを手動で作成して認証情報を入力します。
イベント配信は Stream モード を使います。ストリーミング返信には LangBot の dingtalk_stream_card.json カードテンプレートをインポートし、カード返信を使用 を有効にしてテンプレート ID を入力します。

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

まずロボットと個別チャットし、次にグループへ追加してメンションします。