WeChat カスタマーサービス

WeCom の自建アプリを「微信客服（WeCom Customer Service）」アカウントにバインドすることで、CowAgent は外部 WeChat ユーザーからの問い合わせを引き受けることができます。WeChat ミニプログラム、公式アカウント、ビデオチャンネル、ビデオチャンネルストアなどから、リンクや QR コードで WeChat ユーザーに到達できます。

WeChat カスタマーサービスは Docker デプロイまたはサーバー Python デプロイのみサポートしており、外部からアクセス可能なコールバック URL が必要です。ローカル実行モードには対応していません。

1. 前提条件

必要なリソース：

パブリック IP を持つサーバー
登録済みかつ認証済みの WeCom アカウント
「微信客服」機能が有効になっていること

カスタマーサービス専用に 新たな 企業微信自建アプリを作成することを推奨します。既存の wechatcom_app アプリを流用すると、2 つのチャネルが同じコールバック URL を奪い合うことになります。

2. 企業微信自建アプリの作成

WeCom 管理コンソールで アプリ管理 → アプリ作成 をクリックします：

自社情報 をクリックし、ページ下部で 企業ID（Corp ID） を確認します（wechat_kf_corp_id に設定します）：

上で作成したアプリに入り、Secret の隣の「表示」をクリックします。Secret は管理者のスマートフォンの WeCom アプリに送られ、そこで確認できます：

アプリの メッセージ受信 → API 受信設定 に入り、右側の「ランダム生成」をクリックして Token と EncodingAESKey を生成し、保存します：

プログラムがまだ起動していないため、この時点では API 受信設定を保存できません。プロジェクトが動作した後に戻って保存してください。

3. 設定と起動

前のステップで収集した 4 つのフィールド（Corp ID / Secret / Token / EncodingAESKey）を入力します：

Web コンソール
設定ファイル

Cow プロジェクトを起動した後、Web コンソールを開きます。チャネル メニューを選択し、接入チャネル をクリックし、微信客服 を選択して、Corp ID / Secret / Token / AES Key を入力し（ポートはデフォルト 9888、変更可能）、接入をクリックします。

config.json に以下の設定を追加します（各パラメータと WeCom コンソールの対応関係は上のスクリーンショットを参照してください）：

{
  "channel_type": "wechat_kf",
  "wechat_kf_corp_id": "YOUR_CORP_ID",
  "wechat_kf_secret": "YOUR_SECRET",
  "wechat_kf_token": "YOUR_TOKEN",
  "wechat_kf_aes_key": "YOUR_AES_KEY",
  "wechat_kf_port": 9888
}

パラメータ	説明
`wechat_kf_corp_id`	企業 ID
`wechat_kf_secret`	カスタマーサービスにバインドした企業微信自建アプリの Secret
`wechat_kf_token`	API 受信設定の Token
`wechat_kf_aes_key`	API 受信設定の EncodingAESKey
`wechat_kf_port`	リスンポート、デフォルトは 9888

接入完了後、プログラムを起動します（Web コンソール方式ではチャネルが自動的に再起動されます）。ログに Listening on http://0.0.0.0:9888/wxkf/ と表示されれば、プログラムは正常に動作しています。このポートを外部に公開する必要があります（例：クラウドサーバーのセキュリティグループで許可します）。続いて、WeCom 管理コンソールの メッセージ受信 → API 受信設定 に戻り、コールバック URL に http://<your-host>:9888/wxkf/ を入力して保存します。保存が成功したら、サーバー IP を 企業の信頼済み IP に追加する必要もあります。追加しないとメッセージの送受信ができません：

URL のコールバック検証が通らない、または設定がうまくいかない場合：

サーバーのファイアウォールが無効になっており、セキュリティグループでリスンポート（デフォルト 9888）が許可されていることを確認してください
Token、Secret、EncodingAESKey などのパラメータが一致しているか、URL の形式が正しいか慎重に確認してください
認証済みの WeCom アカウントは、法人に対応する届け出済みドメインを設定する必要があります

4. 微信客服アカウントとのバインド

WeCom 管理コンソールの 微信客服 ページに入り、カスタマーサービスアカウントを作成し、上で作成した企業微信自建アプリとバインドします：

バインド完了後、微信客服 → 微信客服アカウント詳細 に入り、「接入リンク」の項目で：

「リンクをコピー」をクリックすると、https://work.weixin.qq.com/kfid/kfcd83e5896b9ba07be のような接入リンクが取得できます
「QR コード生成」をクリックすると、対応する QR コードが取得できます

リンクまたは QR コードを WeChat 顧客に配布してください：

5. 使い方

WeChat ユーザーがリンクや QR コードからカスタマーサービス対話に入った後、AI とテキスト・画像・音声などのマルチターン対話が可能です：

これに加え、WeChat 公式エコシステムの機能に基づき、微信客服を公式アカウント、ミニプログラム、ビデオチャンネルなどの場面でも使用できます。詳細は WeCom 管理コンソールの 微信客服 → 接入シナリオ を参照してください：

FAQ

以下の依存パッケージがインストールされていることを確認してください：

pip install websocket-client pycryptodome

Documentation Index

​1. 前提条件

​2. 企業微信自建アプリの作成

​3. 設定と起動

​4. 微信客服アカウントとのバインド

​5. 使い方

​FAQ

1. 前提条件

2. 企業微信自建アプリの作成

3. 設定と起動

4. 微信客服アカウントとのバインド

5. 使い方

FAQ