DeepSeek で WeCom カスタマーサービス の AI ボットを作る
LangBot で DeepSeek を使った WeCom カスタマーサービス の AI ボットを動かす手順:モデル設定、ボットの認証情報、ネットワーク、テスト、トラブルシューティング。
このレシピでは DeepSeek のモデルを WeCom カスタマーサービス のボットにつなぎます。LangBot が WeCom カスタマーサービス のメッセージを受け取り、パイプラインで処理して返信するので、プラットフォーム連携のコードは不要です。
LangBot の内蔵エージェントから DeepSeek のモデルを直接使います。別のエージェント基盤は不要で、ナレッジベース、MCP ツール、Skills も追加できます。
必要なもの
- 稼働中の LangBot:LangBot Cloud(サーバー不要)、または Docker や
uvx langbotによるセルフホスト。 - LangBot から呼び出せる DeepSeek のアカウントまたはサーバー。
- API を有効にした WeCom カスタマーサービス(WeChat Kefu):企業 ID、Secret、コールバック用 Token と EncodingAESKey。
ネットワーク
カスタマーサービスはコールバック URL にイベントを送るため、LangBot には公開 HTTPS アドレスが必要です。LangBot Cloud には用意されています。
1. DeepSeek のモデルを追加する
- DeepSeek のコンソールで API キーを作成します。
- LangBot の モデル で LLM モデルを追加し、プロバイダーに DeepSeek、リクエスト URL に
https://api.deepseek.comを指定して、API キーとモデル ID を入力します。 - モデルが関数呼び出しに対応していれば ツール使用 を有効にします。MCP ツール、Skills、サンドボックスに必要です。
- 代表的なモデル ID は
deepseek-chatとdeepseek-reasonerです。最新の一覧は DeepSeek のドキュメントで確認してください。
2. パイプラインを作成する
LangBot WebUI の パイプライン でパイプラインを作成(または既定のものを編集)し、AI を次のように設定します。
| 項目 | 設定値 |
|---|---|
| ランナー | Local Agent(内蔵エージェント) |
| モデル | 追加したモデル。予備モデルも指定できます。 |
| プロンプト | ボットの役割、口調、してはいけないこと。 |
| ナレッジベース | 任意。ナレッジベースを付けると資料に基づいて回答します。 |
3. WeCom カスタマーサービス のボットを作成する
- WeCom カスタマーサービスの 開発者設定 で Token と EncodingAESKey を生成し、企業 ID とともに WeCom カスタマーサービス アダプターのボットに入力します。
- ボットを有効化して Webhook コールバック URL を管理画面に貼り、Secret を入力してボットを再起動します。ユーザーが会話を始めるためのリンクや QR コードを発行します。
4. 紐付けてテストする
ボットを開いて作成したパイプラインを選び、保存してボットが有効になっていることを確認します。
WeChat でカスタマーサービスのリンクを開くか QR コードを読み取り、メッセージを送ります。
トラブルシューティング
- 401 エラーは、API キーの誤りか DeepSeek アカウントの残高不足です。
- ウェルカムメッセージは WeChat が
welcome_codeを渡したときだけ、期限内に 1 回だけ送れます。 - WebUI の モニタリング に、すべてのメッセージ、パイプラインの実行、エラーが記録されます。
よくある質問
WeCom カスタマーサービス には公開 IP のあるサーバーが必要ですか?
必要です。または LangBot Cloud を使えます。カスタマーサービスはコールバック URL にイベントを送るため、LangBot には公開 HTTPS アドレスが必要です。LangBot Cloud には用意されています。
WeCom カスタマーサービス のボットはストリーミング返信に対応していますか?
対応状況はプラットフォーム機能一覧で確認してください。AI 側の生成が終わってから返信が送られます。
同じ DeepSeek の設定を他のプラットフォームでも使えますか?
はい。1 つのパイプラインを複数のボットに紐付けられるので、同じ設定で複数のプラットフォームに同時に応答できます。
関連ガイド
- WeCom カスタマーサービス の詳しい設定ガイド
- モデルの設定
- WeCom カスタマーサービス で使える他の AI:Dify · n8n · Coze · Langflow · OpenAI (ChatGPT models)
- DeepSeek を他のプラットフォームで使う:Telegram · Discord · Slack · Lark(Feishu) · DingTalk · WeCom(社内アプリ)
