Langflow を WeCom(社内アプリ) に接続する
LangBot で Langflow アプリを WeCom(社内アプリ) のボットとして動かす手順:Langflow の設定、ボットの認証情報、ネットワーク、テスト、トラブルシューティング。
このレシピではお使いの Langflow アプリを WeCom(社内アプリ) のボットにつなぎます。LangBot が WeCom(社内アプリ) のメッセージを受け取り、パイプラインで処理して返信するので、プラットフォーム連携のコードは不要です。
Langflow はドラッグ&ドロップでエージェントやフローを作れます。LangBot はメッセージごとに Langflow API でフローを実行します。
必要なもの
- 稼働中の LangBot:LangBot Cloud(サーバー不要)、または Docker や
uvx langbotによるセルフホスト。 - LangBot からネットワーク経由で到達できる Langflow のアカウントまたはインスタンス。
- WeCom の自社開発アプリ:企業 ID、アプリの Secret、連絡先同期 Secret、コールバック用の Token と EncodingAESKey。
ネットワーク
WeCom はコールバック URL にメッセージを送るため、LangBot には公開ドメインと HTTPS が必要です(リバースプロキシと SSL を参照)。LangBot Cloud にはすぐ使える公開 URL があります。
1. Langflow を準備する
- Langflow でフローを作成します(Simple Agent テンプレートから始めると簡単です)。
- Settings で API キーを作成します。
- Share → API access のサンプルコードから Flow ID を取得します。
2. パイプラインを作成する
LangBot WebUI の パイプライン でパイプラインを作成(または既定のものを編集)し、AI を次のように設定します。ランナーが一覧にない場合は、プラグイン または LangBot Space マーケット から公式ランナープラグインをインストールします。
| 項目 | 設定値 |
|---|---|
| ランナー | Langflow(公式 Langflow Agent ランナープラグイン) |
| Base URL | LangBot から到達できる Langflow のアドレス |
| API Key | Langflow の API キー |
| Flow ID | 実行するフローの ID |
3. WeCom(社内アプリ) のボットを作成する
- WeCom アダプターでボットを作成し、企業 ID、アプリ Secret、連絡先同期 Secret を入力して有効化し、Webhook コールバック URL をコピーします。
- WeCom 管理画面の メッセージ受信 → API 受信の設定 に URL を貼り、Token と EncodingAESKey を生成して、先に LangBot、次に WeCom で保存します。LangBot の送信元 IP を 企業の信頼 IP に追加します。
4. 紐付けてテストする
ボットを開いて作成したパイプラインを選び、保存してボットが有効になっていることを確認します。
WeCom クライアントでアプリを開き、メッセージを送ります。
トラブルシューティング
- 接続が拒否される場合、
http://localhost:7860が使えるのは Langflow と LangBot が同じホスト・同じネットワーク名前空間にあるときだけです。 - コールバック保存時に request URL failed となる場合は、URL が公開 HTTPS で到達できないか、LangBot の Token/EncodingAESKey が一致していません。
- 返信が送れない場合は、LangBot の送信元 IP を企業の信頼 IP に追加します。
- WebUI の モニタリング に、すべてのメッセージ、パイプラインの実行、エラーが記録されます。
よくある質問
WeCom(社内アプリ) には公開 IP のあるサーバーが必要ですか?
必要です。または LangBot Cloud を使えます。WeCom はコールバック URL にメッセージを送るため、LangBot には公開ドメインと HTTPS が必要です(リバースプロキシと SSL を参照)。LangBot Cloud にはすぐ使える公開 URL があります。
WeCom(社内アプリ) のボットはストリーミング返信に対応していますか?
対応状況はプラットフォーム機能一覧で確認してください。AI 側の生成が終わってから返信が送られます。
同じ Langflow の設定を他のプラットフォームでも使えますか?
はい。1 つのパイプラインを複数のボットに紐付けられるので、同じ設定で複数のプラットフォームに同時に応答できます。
関連ガイド
- WeCom(社内アプリ) の詳しい設定ガイド
- Langflow ランナーの詳しいガイド
- WeCom(社内アプリ) で使える他の AI:Dify · n8n · Coze · DeepSeek · OpenAI (ChatGPT models)
- Langflow を他のプラットフォームで使う:Telegram · Discord · Slack · Lark(Feishu) · DingTalk · WeCom インテリジェントボット
