Weixin / WeChat
AnyyのWeixinチャンネルは、QR確認による対話型ロングポーリングセッションを使用します。ダイレクトメッセージ、メディアの送受信、入力中状態、ライブプローブ、チャンネル制御の/voiceに対応します。
現在の接続プロファイルはPreviewです。確認コード、リダイレクト先ホスト、すでに紐付け済みのアカウントの一部、識別情報の更新、リモートのライフサイクルに関するケースには対応していません。復旧用に別のAnyy操作画面を利用可能にしておいてください。
1. QR認証を開始する
Dashboard → Channel → Add → Weixin / WeChatを開きます。この項目はIlinkロングポーリングを使用します。アカウントページから認証を開始してください。
Dashboardには対話操作用のQRコードが表示されます。使用するWeixinアカウントでスキャンし、スマートフォン上で確認します。認証のタイムアウトは5分で、キャンセルもできます。
返されたログイントークンはProfileの認証情報参照として保存され、通常のチャンネル設定では再表示されません。
CLIとTUIの設定も同じ認証フローを使用します。単独のスキャンに成功した後、アカウント保存前にキャンセルすると、Anyyは未使用のローカルログイン下書きを破棄します。キャンセルしても、すでに保存されたアカウントの接続は解除されません。
2. ダイレクトメッセージのアクセスを選ぶ
WeixinのDMポリシーはopen、allowlist、disabledに対応します。現在の既定値はopenです。
QR紐付け後にアカウント設定を開き、DMポリシーを選んでallow_fromを編集します。既知の送信者だけがAnyyにアクセスすべき場合はallowlistを選びます。項目にはチャンネルが観測したWeixin送信者識別情報を使います。設定を保存しても現在のログインは維持され、新しいQRコードは要求されません。空のリストを保存すると全項目が削除されます。
現在のWeixinプロファイルはダイレクトメッセージ専用で、グループポリシーはありません。
3. アカウントを検証する
QRフローの完了後に実行します。
anyy channel reload
anyy channel doctor weixin
許可されたアカウントから同じ会話にダイレクトメッセージを2通送ります。それぞれに1件の返信が届き、2通目でも会話のコンテキストが維持されることを確認します。実際の通信後には、Doctorに現在の認証情報と送受信トランスポートの証拠が表示されるはずです。2通目の後もWebの会話ページとChannel詳細ページが開くことを確認してください。
返信の成功により最後の受理済み送信時刻が更新され、以前の送信失敗が解消されることがあります。準備状態が変わらなくても、時刻の更新が止まるべきという意味ではありません。実際のメッセージが動作しても、一部のPreviewプローブ軸は利用できません。利用不可のプローブを全機能の失敗の証拠とせず、報告された軸と診断を確認します。
メッセージ、メディア、コマンド
アダプターはテキストを送受信し、対応する受信メディアを配置し、設定上限内で画像、動画、音声、ボイス、ファイル添付を配信できます。現在のアカウントと相手用の返信コンテキストトークンを永続化・更新します。このトークンはAnyyに管理させてください。一般的な送信失敗だけでは認証情報の期限切れとは判断できません。新しいQRフローを始めたり、成否不明の返信を繰り返したりする前に、診断とプラットフォーム側の会話を確認します。
Weixinでよく使うコマンドは次のとおりです。
/status
/stop
/new
/voice
TTSが設定されている場合、/voiceはそのチャンネル会話の音声返信を管理します。
コマンドの返信配信でエラーが起きても、完了したローカル操作は取り消されません。手動でコマンドを再実行する前に、現在の会話とアカウント状態を確認してください。
期限切れセッションを再認証する
リモート認証情報が期限切れになると、チャンネル状態はcredential-expiredとなり、対処として新しいQRスキャンを求められます。Dashboard → Channel → Weixinに戻り、再び認証を開始してスキャン・確認を行い、Doctorを再実行します。
別のアカウントから取得したトークンを貼り付けたり、手動編集したりしないでください。Anyyは確定済みのリモート識別情報と認証情報のライフサイクルを、設定済みチャンネルアカウントに結び付けます。
Gatewayの再起動で実行中のQRポーリングハンドルが失われると、試行はunknownまたはexpiredで終了します。新しいQRは自動要求されません。チャンネルページから新しいスキャンを開始してください。
ログイン要求の応答だけが失われた場合は、再試行またはログインページの再読み込みで同じ要求を復旧できます。新しいQRには明示的な更新が必要です。Dashboardは各要求を10分間復旧可能な状態に保ちますが、QRの有効期間5分は延長されません。10分を過ぎたらアカウント設定に戻ってください。
トラブルシューティング
| 症状 | 確認する項目 |
|---|---|
| QRコードが期限切れ | 新しい認証を開始し、5分以内にスキャン |
| スマートフォンで未対応の検証経路を求められる | キャンセルして対応済みのQR確認フローを使用。プロファイルはPreview |
| 状態が認証情報の期限切れを示す | チャンネルページで新しいQRコードをスキャン |
| メッセージは届くが返信に失敗する | 送信トランスポート、コンテキストトークン状態、メディア制限、ロングポーリングの健全性 |
| 想定外の送信者がAnyyにメッセージを送れる | 紐付け済みアカウントの設定でallowlistを選び、許可する送信者識別情報を入力して保存 |
共通のチャンネル診断は、メッセージングプラットフォームを参照してください。