WeChat カスタマーサービスを接続

始める前に

有効な Agent と WeCom 管理者アカウントを用意します。

WeCom 管理画面のアプリ管理から自作アプリを作成または選択し、名前・アイコン・公開範囲を設定します。

「企業情報」で Corp ID をコピーします。

アプリの「メッセージ受信 → API 受信設定」で Token と EncodingAESKey を生成して控えます。URL は後で保存します。

項目	値
Token	生成した 3〜32 文字の検証文字列
EncodingAESKey	生成した 43 文字の暗号化キー全体

AIP のチャネルで WeChat カスタマーサービスを追加し、名前、Corp ID、Token、EncodingAESKey を入力します。作成後のインストール設定でコールバック URL、ドメイン検証アドレス、信頼済み IP を確認します。

ドメイン検証を求められた場合

WeCom の WW_verify_*.txt を変更せずに AIP のインストール設定へアップロードします（4 KiB 以下）。公開 URL で内容を確認してから WeCom で検証します。ドメイン欄に /webhooks/ パスは含めません。

AIP のインストール設定に表示される IP をすべてアプリの信頼済み IP に登録し、保存します。

API メッセージ受信設定に戻り、次の項目を入力して保存します。

項目	設定
URL	`/webhooks/wechat_kf/` を含む AIP の完全なコールバック URL
Token、EncodingAESKey	AIP チャネル作成時と同じ値
受信イベント	WeChat カスタマーサービスのメッセージとイベント

保存後の画面

WeChat カスタマーサービスでアカウントを作成または選択し、名前とアイコンを設定します。

サービスアカウントの API 設定を開き、API を呼び出せるアプリの変更から先ほどのアプリを選びます。

企業内開発で対象サービスアカウントをアプリに関連付け、管理対象になっていることを確認します。

認可済みアプリの詳細で Secret の表示を選び、WeCom の案内に従ってクライアントで取得します。

AIP のインストール設定に Secret を入力し、サービスアカウント一覧を取得して名前で選択します。検証を完了し、有効な Agent を割り当てます。管理可能なアカウントが 1 つの場合は自動選択されます。

顧客用の WeChat でサービスリンクまたは QR コードを開きます。メッセージを送って Agent の返信を確認し、画像や音声も試します。

ドメイン・コールバック検証に失敗する

検証ファイルの公開アクセスと内容を確認します。完全なコールバック URL を使い、両側の Token と EncodingAESKey を一致させます。

サービスアカウントを取得できない

Corp ID と Secret の所属企業・アプリ、カスタマーサービスの認可、必要な信頼済み IP を確認します。

メッセージは届くが返信がない

カスタマーサービスイベント、Agent の状態、利用認可、プラットフォームの返信制限を確認します。管理者にサービス名・送信時刻・エラーコードを伝えます。