QQ Bot

QQ Bot Channelは公式WebSocket Gatewayからイベントを受信し、プラットフォームAPIで返信します。常駐Gatewayがプロトコルセッションを維持します。

必要なもの

• QQ Botアプリケーション。
• App ID。
• App Secret（Anyyではclient_secretとして入力）。
• 任意のBot User ID。
• C2Cとグループ@メッセージ用のGatewayインテント。

最新のQQ Botイベント購読ドキュメントを参照してください。

Dashboardで接続する

1. Dashboard → Channel → Addを開きます。
2. QQ Botを選びます。既定の項目はWebSocket Gatewayです。
3. App IDとApp Secretを入力します。
4. 対応するプラットフォーム識別情報がある場合だけBot User IDを追加します。
5. アカウントの認証情報を保存し、ポリシーはCLIウィザードで変更します。
6. QQ Botコンソールで必要なC2C／グループ@メッセージのインテントを有効にします。

既定のアカウントIDはbotです。このプロファイルでは公開の受信Webhookは不要です。

アクセスポリシー

ダイレクトメッセージの既定値はpairing、グループはmentionです。対応するポリシーは次のとおりです。

• DM：pairing、open、allowlist、disabled。
• グループ：mention、open、allowlist、disabled。

anyy channel pairing list
anyy channel pairing approve --request REQUEST_ID

接続を検証する

anyy channel doctor qqbot
anyy channel reload

対話型のanyy setup channelウィザードでQQ Botを選んでポリシーを編集します。Dashboardにはポリシー入力やペアリング承認の一覧がなく、現在の設定アクションではQQの許可リスト項目も編集できません。返信には元の受信メッセージのコンテキストが必要です。過去の会話が存在しても、任意の先行送信を行う権限にはなりません。

C2Cメッセージとグループでのメンションをそれぞれ1件ずつテストします。イベント経路とポリシーが異なるため、別々の確認として扱ってください。

認証情報の前にインテントを診断する

識別情報のプローブには成功するのにメッセージが届かない場合は、App Secretを更新する前にGatewayインテントとイベント購読を確認します。

トラブルシューティング

問題	確認する項目
Gateway認証に失敗する	App IDとApp Secret
接続済みだがイベントが届かない	C2C／グループ@メッセージのインテントとアプリの利用可否
ダイレクトメッセージが無視される	DMポリシーとペアリング／許可リスト
グループメッセージが無視される	グループポリシーと明示的なボットメンション
受信できるが送信に失敗する	ボット識別情報とプラットフォームの送信認可