ヘルプドキュメント

WeCom 連携設定ガイド

WeCom の「インテリジェントボット」の API モードを使って Kocoro のエージェントを WeCom に接続し、チームメンバーが個別チャットやグループチャットでエージェントと直接会話できるようにします。所要時間は約 3 分です。

始める前に

WeCom の「スーパー管理者」アカウント、または「管理ツール」権限を持つサブ管理者アカウント。
インストールと初期設定が完了した Kocoro と、作成済みのエージェントが 1 つ以上あること。
常時稼働する Mac（常時接続をホストするため。グローバル IP やドメインは不要）。

1
WeCom の「インテリジェントボット」管理ページを開く
管理者アカウントで WeCom 管理コンソールにログインし、左側のナビゲーションから「セキュリティと管理」→「管理ツール」と進み、右側の「AI スマートゾーン」カテゴリにある「インテリジェントボット」カードをクリックします。
- WeCom の「スーパー管理者」、または「管理ツール」権限を持つサブ管理者アカウントが必要です。
- 管理コンソール：https://work.weixin.qq.com/wework_admin/
図 1：「セキュリティと管理 → 管理ツール」で「インテリジェントボット」の入口を見つけます。
2
「手動で作成」を選ぶ
「インテリジェントボット」ページで「ボットを作成」ボタンをクリックします。表示される「どんなボットが必要ですか」ダイアログの左下にある「手動で作成」を選びます。
- ダイアログの「AI 自動生成」は使わないでください。使うと、後の API モードに必要な設定項目が表示されません。
図 2：ボット作成ダイアログの左下にある「手動で作成」をクリックします。
3
「API モードで作成」に切り替える
「インテリジェントボットを作成」設定ページで、右側の設定パネルを一番下までスクロールし、「保存 / キャンセル」ボタンのすぐ上にある「API モードで作成」のリンクをクリックします。
- API モードでは Kocoro が応答生成を引き継ぐため、ページ上の「プラグイン」「ワークフロー」「ウェルカムメッセージ」などの設定は入力不要です。
図 3：右側の設定パネルを一番下までスクロールし、「API モードで作成」をクリックします。
4
常時接続を選び、Bot ID と Secret をコピーする
「API 設定」エリアで「接続方式」を「常時接続を使用」に設定します（ドメインやグローバル IP は不要）。次に、その下に自動生成された「Bot ID」をコピーし、「Secret」の右側にある「取得」をクリックして鍵を生成し、コピーします。
- Secret は安全に保管してください。ページを閉じると再表示できず、再生成するしかありません。
- ページ上部でボットの「公開範囲」を設定して「保存」をクリックするのを忘れないでください。設定しないとメンバーが WeCom でボットと会話できません。
図 4：「常時接続を使用」を選び、「Bot ID」と、取得をクリックした後の「Secret」をコピーします。
5
Kocoro で WeCom ボットを追加する
Kocoro を開き、「機能 → 連携」ページに移動して「WeCom」コネクタを見つけ、「+ ボットを追加」をクリックします。ダイアログで、前のステップでコピーした内容をそれぞれ「Bot ID」と「Bot Secret」に入力し、メッセージに応答させる「エージェント」を選択します。必要に応じて分かりやすい「表示名」を入力し、最後に「ボットを登録」をクリックすると接続が完了します。
- 登録に成功すると、ボットは常時接続で即座に Kocoro に接続されます。WeCom でそのボットにメッセージを送ると、選択したエージェントが返信します。
- 「連携」ページでいつでも「更新」をクリックして接続状態を確認したり、ゴミ箱アイコンをクリックしてボットを削除したりできます。
図 5：Kocoro の「連携」ページに Bot ID と Secret を入力し、ボットの登録を完了します。