> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langbot.app/llms.txt
> Use this file to discover all available pages before exploring further.

# WeCom インテリジェントボット

> LangBot で WeCom（企業微信）AI ボットを構築し、組織に LLM チャットを導入。

## 一键設定（おすすめ）

LangBot は WeCom ボットのワンクリック作成と BotId/Secret の自動入力に対応しています。手動でのコピペは不要です。

1. LangBot WebUI を開き、**ボット > ボットを作成** に移動
2. ボット名を入力し、プラットフォーム/アダプターで `企业微信智能机器人` を選択
3. 表示される **一键创建机器人** エリアで **開始** ボタンをクリック

<img src="https://mintcdn.com/langbot/2gQAELt1nN3_kQMs/images/zh/deploy/bots/wecom/wecombot/wecombot_oneclick.png?fit=max&auto=format&n=2gQAELt1nN3_kQMs&q=85&s=e10580a27d33723e497e8496290fba31" alt="一键创建机器人" width="1900" height="906" data-path="images/zh/deploy/bots/wecom/wecombot/wecombot_oneclick.png" />

4. 企業微信で QR コードをスキャンし、手机端で **一键创建智能机器人** をタップ

<img src="https://mintcdn.com/langbot/2gQAELt1nN3_kQMs/images/zh/deploy/bots/wecom/wecombot/wecombot_scan_create.png?fit=max&auto=format&n=2gQAELt1nN3_kQMs&q=85&s=9907bbd322eac4d3e77a4c4a4a7e40df" alt="手机端一键作成" width="1563" height="922" data-path="images/zh/deploy/bots/wecom/wecombot/wecombot_scan_create.png" />

5. 認証成功後、BotId と Secret がフォームに**自動入力**されます
6. **ボット名を手動で入力** — 企業微信のボット名と一致させる必要があります

<img src="https://mintcdn.com/langbot/2gQAELt1nN3_kQMs/images/zh/deploy/bots/wecom/wecombot/wecombot_fill_name.png?fit=max&auto=format&n=2gQAELt1nN3_kQMs&q=85&s=52eb3254f4b5aa97ca50a335ded59036" alt="ボット名の入力" width="1612" height="923" data-path="images/zh/deploy/bots/wecom/wecombot/wecombot_fill_name.png" />

7. **送信** をクリックして完了

<Warning>
  企業微信インテリジェントボットは**既存のボットを使用できない**ため、一键設定は新規作成のみ対応しています。既存のボットを使用する場合は、下記の手動設定を参照してください。
</Warning>

***

## 手動設定

### ボットの作成

まず、[WeCom Admin Console](https://work.weixin.qq.com/wework_admin/frame#/)にログインします。

<img src="https://mintcdn.com/langbot/ccEfWQOd_I5kaF_t/images/zh/deploy/bots/wecom/wecombot/wecombot_1.png?fit=max&auto=format&n=ccEfWQOd_I5kaF_t&q=85&s=0a849fb8503d1307fe02279b560ef691" alt="Homepage" width="1970" height="1094" data-path="images/zh/deploy/bots/wecom/wecombot/wecombot_1.png" />

左側のサイドバーの「セキュリティと管理」をクリックし、次に「管理ツール」の下の「インテリジェントボット」をクリックします。

以下のように：

<img src="https://mintcdn.com/langbot/ccEfWQOd_I5kaF_t/images/zh/deploy/bots/wecom/wecombot/wecombot_2.png?fit=max&auto=format&n=ccEfWQOd_I5kaF_t&q=85&s=22f2721d7712fe9b1891456266dad28d" alt="Intelligent Bot" width="2750" height="904" data-path="images/zh/deploy/bots/wecom/wecombot/wecombot_2.png" />

「ボットを作成」をクリックし、「手動作成」を選択して、ページの一番下までスクロールして「API モードで作成」をクリックし、ページに入ります：

<img src="https://mintcdn.com/langbot/UfIG5LRrzfzmD9Of/images/zh/deploy/bots/wecom/wecombot/wecombot_3.png?fit=max&auto=format&n=UfIG5LRrzfzmD9Of&q=85&s=28aa447b19ec6f921bf3e4af32f08495" alt="Create via API Mode" width="1645" height="872" data-path="images/zh/deploy/bots/wecom/wecombot/wecombot_3.png" />

### ロングコネクション設定

#### ロングコネクション API モードの有効化

WeCom 管理コンソールで、インテリジェントボットの設定ページに移動し、「API モード」を有効にして「ロングコネクション」を選択します：

<img src="https://mintcdn.com/langbot/UfIG5LRrzfzmD9Of/images/zh/deploy/bots/wecom/wecombot/wecombot_9.png?fit=max&auto=format&n=UfIG5LRrzfzmD9Of&q=85&s=48cdf05d8ef7219f728fe762a71ed04f" alt="ロングコネクションモード" width="668" height="451" data-path="images/zh/deploy/bots/wecom/wecombot/wecombot_9.png" />

#### 認証情報の取得

ロングコネクション API モードを有効にした後、接続を確立するために以下の認証情報を取得する必要があります：

| 認証情報   | 説明                                |
| ------ | --------------------------------- |
| BotID  | インテリジェントボットの一意の識別子で、ボットの識別に使用されます |
| Secret | ロングコネクション専用の秘密鍵で、本人確認に使用されます      |

<Warning>
  注意：

  * Secret はロングコネクション専用の秘密鍵であり、コールバック URL モードで使用される Token/EncodingAESKey とは異なります
  * Secret を安全に保管し、漏洩を避けてください
  * モード切り替えの影響：API モードは一つの方式のみ使用できます（ロングコネクションまたはコールバック URL）。「コールバック URL」モードに切り替えると、既存のロングコネクションが無効になります。逆に、「コールバック URL」から「ロングコネクション」モードに切り替えると、元のコールバック URL は無効になります
</Warning>

#### ボットの設定

LangBot メインプログラムを起動し、アダプター「WeCom Intelligent Bot」を選択し、設定項目を入力します。
ロングコネクションの BotID、Secret、およびボット名を入力し、保存して有効化をクリックします。

> ボット名は新しく作成したボットの名前と一致している必要があります。一致しない場合、グループチャットで応答しません。

<img src="https://mintcdn.com/langbot/3NDJgZr-XlIS_TL6/images/zh/deploy/bots/wecom/wecombot/wecombot_10.png?fit=max&auto=format&n=3NDJgZr-XlIS_TL6&q=85&s=c6f168df4aa5305e29dd2321cb8851b5" alt="ロングコネクション設定" width="1390" height="720" data-path="images/zh/deploy/bots/wecom/wecombot/wecombot_10.png" />

### URL コールバック設定

Token と EncodingAESKey をランダムに生成するためにクリックし、次に上部に基本的なボット情報を入力します。**表示範囲の設定に注意してください**。

<img src="https://mintcdn.com/langbot/UfIG5LRrzfzmD9Of/images/zh/deploy/bots/wecom/wecombot/wecombot_11.png?fit=max&auto=format&n=UfIG5LRrzfzmD9Of&q=85&s=ab33783927a5d237b08c6416af1fe1a2" alt="パラメータ取得" width="1647" height="867" data-path="images/zh/deploy/bots/wecom/wecombot/wecombot_11.png" />

左側のサイドバーの「私の会社」をクリックし、下部の会社 ID を保存します。

#### コールバック URL の設定

LangBot メインプログラムを起動し、アダプター「WeCom Intelligent Bot」を選択し、設定項目を入力します。
その中で、token は Token、Encoding-AESKey は EncodingAESKey、Bot ID は xxx として入力できます（またはランダムに入力でき、後で変更されます）。入力後、
「保存」をクリックし、ロボットを「有効化」します。

<img src="https://mintcdn.com/langbot/ccEfWQOd_I5kaF_t/images/zh/deploy/bots/wecom/wecombot/wecombot_4.png?fit=max&auto=format&n=ccEfWQOd_I5kaF_t&q=85&s=ce2cf6c830e8f459e605dbd1c1c917e5" alt="WeCom Intelligent Bot Adapter" width="1136" height="728" data-path="images/zh/deploy/bots/wecom/wecombot/wecombot_4.png" />

LangBot ホームページで、対応するボットを有効にして選択し、設定ページをクリックして入り、Webhook コールバックアドレスをコピーします

<Info>
  まず、[HTTP リバースプロキシの設定](/ja/workshop/production/proxy-and-ssl)を参照して LangBot コールバックアドレスを設定することをお勧めします。
</Info>

<img src="https://mintcdn.com/langbot/ccEfWQOd_I5kaF_t/images/zh/deploy/bots/wecom/wecombot/wecombot_8.png?fit=max&auto=format&n=ccEfWQOd_I5kaF_t&q=85&s=191a56bdf13d1ca8b10bdb1e2fd27635" alt="Webhook Callback Address" width="792" height="683" data-path="images/zh/deploy/bots/wecom/wecombot/wecombot_8.png" />

WeCom ロボット設定ページに戻り、コピーした webhook アドレスを「URL Callback」に入力します。作成が成功すると、詳細ページにジャンプします。「Request URL Failed」というメッセージが表示された場合は、上記の手順が 1 つずつ完了しているかどうかを再度確認してください。

作成成功後の詳細ページ：

<img src="https://mintcdn.com/langbot/ccEfWQOd_I5kaF_t/images/zh/deploy/bots/wecom/wecombot/wecombot_5.png?fit=max&auto=format&n=ccEfWQOd_I5kaF_t&q=85&s=cd1741894f405c516228cf35ed7d38e7" alt="Creation Successful" width="2804" height="920" data-path="images/zh/deploy/bots/wecom/wecombot/wecombot_5.png" />

WeCom ロボット詳細ページから「Bot ID」とボット名をコピーし、LangBot 管理ページに戻り、デプロイされたインテリジェントロボットの Bot ID をコピーした ID に変更し、ボット名を入力して、ロボットを再起動します。

### ストリーミングの有効化

ローカルでデプロイされたモデルやストリーミングをサポートしていないモデル向けに、ストリーミングのオン・オフスイッチが追加されました。

<img src="https://mintcdn.com/langbot/3NDJgZr-XlIS_TL6/images/zh/deploy/bots/wecom/wecombot/wecombot_12.png?fit=max&auto=format&n=3NDJgZr-XlIS_TL6&q=85&s=9259390f540b57997ced7a5999378f9d" alt="ストリーミングスイッチ" width="1449" height="748" data-path="images/zh/deploy/bots/wecom/wecombot/wecombot_12.png" />

### 使用開始

WeCom に入り、「➕」をクリックします。以下のように：

<img src="https://mintcdn.com/langbot/ccEfWQOd_I5kaF_t/images/zh/deploy/bots/wecom/wecombot/wecombot_6.png?fit=max&auto=format&n=ccEfWQOd_I5kaF_t&q=85&s=b8e836de273237d44ede77ffc0ecb317" alt="Add Bot" width="1902" height="274" data-path="images/zh/deploy/bots/wecom/wecombot/wecombot_6.png" />

「会社作成」をクリックし、作成したボットを選択し、チャットインターフェイスに入ります。

同様に、ボットをグループチャットに招待したい場合は、グループチャットでメンバーを追加ボタンをクリックし、そこからボットを追加します。

### 効果の画像

<img src="https://mintcdn.com/langbot/ccEfWQOd_I5kaF_t/images/zh/deploy/bots/wecom/wecombot/wecombot_7.png?fit=max&auto=format&n=ccEfWQOd_I5kaF_t&q=85&s=a3d69036cccb4728052ff2d12a78918e" alt="Effect Image 1" width="1256" height="454" data-path="images/zh/deploy/bots/wecom/wecombot/wecombot_7.png" />
