QQ Bot

Le canal QQ Bot reçoit les événements du Gateway WebSocket officiel et répond via l’API de la plateforme. Le Gateway résident maintient la session du protocole disponible.

Prérequis

• une application QQ Bot ;
• l’App ID ;
• l’App Secret (saisi dans Anyy sous client_secret) ;
• éventuellement le Bot User ID ;
• l’intent Gateway pour les messages C2C et les messages de groupe @.

Consultez la documentation actuelle des abonnements aux événements QQ Bot.

Connexion dans Dashboard

1. Ouvrez Dashboard → Channel → Add.
2. Choisissez QQ Bot, dont l’entrée par défaut utilise WebSocket Gateway.
3. Saisissez App ID et App Secret.
4. Ajoutez Bot User ID uniquement si vous disposez de l’identité correspondante sur la plateforme.
5. Enregistrez les identifiants du compte, puis utilisez l’assistant CLI pour modifier les règles.
6. Activez l’intent requis des messages C2C/groupes @ dans la console QQ Bot.

L’identifiant de compte par défaut est bot. Aucun webhook public entrant n’est nécessaire pour ce profil.

Règles d’accès

Les messages privés utilisent pairing par défaut ; les groupes, mention. Les règles prises en charge sont :

• messages privés : pairing, open, allowlist, disabled ;
• groupes : mention, open, allowlist, disabled.

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

Vérifier la connexion

anyy channel doctor qqbot
anyy channel reload

Choisissez QQ Bot dans l’assistant interactif anyy setup channel pour modifier les règles. Dashboard ne propose ni champ de règle ni liste d’approbation des associations, et les actions actuelles ne modifient pas les listes d’autorisation QQ. Les réponses exigent le contexte du message entrant d’origine ; une conversation historique n’autorise pas l’envoi proactif arbitraire.

Testez un message C2C et une mention dans un groupe séparément : ils dépendent de chemins d’événements et de règles différents.

Diagnostiquer les intents avant les identifiants

Si les sondes d’identité réussissent mais qu’aucun message n’arrive, vérifiez l’intent Gateway et l’abonnement aux événements avant de renouveler l’App Secret.

Dépannage

Problème	Points à vérifier
Échec d’authentification Gateway	App ID et App Secret
Connecté, mais aucun événement n’arrive	Intent des messages C2C/groupes @ et disponibilité de l’application
Message privé ignoré	Règle privée et association/liste d’autorisation
Message de groupe ignoré	Règle des groupes et mention explicite du bot
Réception fonctionnelle, envoi impossible	Identité du bot et autorisation d’envoi de la plateforme