QQ Bot

Der QQ-Bot-Kanal empfängt Ereignisse vom offiziellen WebSocket-Gateway und sendet Antworten über die Plattform-API. Das residente Gateway hält die Protokollsitzung verfügbar.

Voraussetzungen

• eine QQ-Bot-Anwendung;
• die App-ID;
• das App-Geheimnis (in Anyy als client_secret eingegeben);
• optionale Bot-Benutzer-ID; und
• der Gateway-Intent für C2C- und Gruppen-@-Nachrichten.

Siehe aktuelle QQ-Bot-Ereignisabonnement-Dokumentation.

Im Dashboard verbinden

1. Öffnen Sie Dashboard → Kanal → Hinzufügen.
2. Wählen Sie QQ Bot, dessen Standardeintrag WebSocket-Gateway verwendet.
3. Geben Sie App-ID und App-Geheimnis ein.
4. Ergänzen Sie Bot-Benutzer-ID nur bei passender Plattformidentität.
5. Speichern Sie Kontozugangsdaten und verwenden Sie dann den CLI-Assistenten für Richtlinienänderungen.
6. Aktivieren Sie den erforderlichen C2C-/Gruppen-@-Nachrichten-Intent in der QQ-Bot-Konsole.

Die Standard-Konto-ID ist bot. Für dieses Profil ist kein öffentlicher eingehender Webhook erforderlich.

Zugriffsrichtlinien

Direktnachrichten verwenden standardmäßig pairing, Gruppen mention. Unterstützte Richtlinien sind:

• DM: pairing, open, allowlist, disabled;
• Gruppe: mention, open, allowlist, disabled.

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

Die Verbindung prüfen

anyy channel doctor qqbot
anyy channel reload

Wählen Sie QQ Bot im interaktiven Assistenten anyy setup channel zur Richtlinienbearbeitung. Dashboard hat weder Richtlinieneingabe noch Kopplungsbestätigungsliste; aktuelle Einrichtungsaktionen bearbeiten keine QQ-Zulassungslisteneinträge. Antworten benötigen ursprünglichen eingehenden Nachrichtenkontext; ein historisches Gespräch ermächtigt nicht zu beliebigem proaktivem Versand.

Testen Sie eine C2C-Nachricht und eine Gruppenerwähnung. Halten Sie diese Prüfungen getrennt, da sie von unterschiedlichen Ereigniswegen und Richtlinien abhängen.

Intent-Probleme vor Zugangsdaten prüfen

Sind Identitätsprüfungen erfolgreich, aber es kommen keine Nachrichten, prüfen Sie Gateway-Intent und Ereignisabonnement, bevor Sie das App-Geheimnis rotieren.

Fehlerbehebung

Problem	Prüfung
Gateway-Authentifizierung schlägt fehl	App-ID und App-Geheimnis
Verbunden, aber keine Ereignisse	C2C-/Gruppen-@-Nachrichten-Intent und App-Verfügbarkeit
Direktnachricht ignoriert	DM-Richtlinie und Kopplung/Zulassungsliste
Gruppennachricht ignoriert	Gruppenrichtlinie und explizite Bot-Erwähnung
Empfang funktioniert, Versand scheitert	Bot-Identität und Plattform-Sendeautorisierung