Support X Bot : dépannage, FAQ & guide de contact

La plupart des problèmes se résolvent avec une seule action /setup. La première moitié de cette page vous guide à travers le flux d'auto-diagnostic ; la seconde moitié est une FAQ. Si aucune des deux ne résout le problème, le formulaire de contact en bas de page route directement vers le canal de support des développeurs BWS.

D'abord — flux d'auto-diagnostic

Ouvrez /setup → ℹ️ À propos dans votre chat.
└─ Copiez ce texte. C'est tout ce dont le support a besoin pour trier.

Puis demandez-vous, dans l'ordre :

  1. Le bot répond-il à /setup ?
     ├─ Non → le bot a été expulsé ou démis de son statut admin → repromouvez et réessayez
     └─ Oui → continuez.

  2. Est-ce que /setup → 📊 Rapports → ⚡ Générer un rapport maintenant a
     produit quelque chose dans les 3 minutes ?
     ├─ Aucun DM, aucune publication → passez à la question suivante.
     ├─ DM « aucun post trouvé »  → filtre trop restrictif ou aucun post
                                pertinent ; /setup → 🎯 Filtres pour voir
                                la requête littérale de l'API X.
     ├─ DM « crédits épuisés » → /setup → 💳 Achat de crédits → 💰 Acheter.
     ├─ La publication est arrivée mais l'image semble incorrecte → relancez ; si
                                persistant, contactez le support avec l'ID du chat.
     └─ La publication est correcte → tout va bien.

  3. Les rapports planifiés arrivent-ils ?
     ├─ Non → l'écran principal de /setup affiche le cron. Comparez à l'heure UTC réelle.
              Le premier déclenchement planifié du bot survient APRÈS le prochain tick cron,
              pas immédiatement après la configuration.
     └─ Oui → tout va bien.

Si rien de tout cela ne vous mène à une solution, passez au-delà de la FAQ jusqu'au lien de contact.

FAQ

Installation & configuration

Q. Le bot ne répond pas quand je l'ajoute. Confirmez qu'il est promu administrateur, pas juste « membre ». Telegram → paramètres du groupe → Administrateurs. La repromotion est instantanée ; le bot n'a pas besoin d'être réinstallé.

Q. Puis-je déplacer le bot vers un autre groupe ? Oui — ajoutez-le au nouveau groupe, lancez /setup là-bas. Les deux chats sont indépendants (IDs de chat différents = paramètres, planifications, scores différents). Il n'y a pas de migration de données entre chats.

Q. Le bot rapporte dans le fil principal, mais mon groupe a des sujets — puis-je rediriger ? Depuis l'intérieur du sujet forum souhaité, envoyez :

/set_topic Rapports

Les futurs rapports sont routés vers ce sujet. Réinitialisez avec /set_topic clear.

Q. Comment désinstaller ?

• Arrêtez d'abord les rapports : /setup → ⏰ Planification → ✕ Désactiver la planification.
• Retirez le bot : Telegram → groupe → admins → expulsez @BWS_X_Bot.
• Les paramètres restent dans la base de données. Réajouter le bot au même ID de chat reprend tout. Demandez au support une suppression définitive.

Rapports & filtrage

Q. Pourquoi mes chiffres diffèrent-ils des outils de suivi tiers ? X Bot puise directement dans l'API X officielle. La plupart des outils tiers scrappent ou extrapolent — nous avons mesuré des écarts de 20 à 50 %. Le chiffre de l'API X fait foi.

Q. Le classement affiche des utilisateurs que je ne m'attendais pas à suivre. Les filtres sont additifs. Si un chat suit le cashtag $VOTRE_TOKEN, quiconque tweete ce cashtag est classé, pas seulement les comptes que vous avez listés. Pour exiger à la fois un compte et un cashtag, utilisez la forme from:@x cashtags:$VOTRE_TOKEN via /set_x_filtering (la sémantique ET-de-tout des filtres nommés).

Q. Le rapport dit « 0 posts » — que faire maintenant ? Trois possibilités, par ordre de probabilité :

1. Filtre trop restrictif — /setup → 🎯 Filtres affiche la requête littérale de l'API X. Faute de frappe courante : $BTC (espace en fin) vs $BTC.
2. Période trop restrictive — si vous avez défini une période personnalisée, les posts hors de cette fenêtre ne comptent pas. /setup → 📊 Rapports → 🗑 Effacer la période revient à la fenêtre glissante de 24h.
3. Les comptes suivis n'ont vraiment rien posté de pertinent en 24 h — élargissez avec des cashtags ou mots-clés pour un signal de secours.

Q. Puis-je suivre un compte X privé/protégé ? Non — l'API X ne renvoie que les posts publics.

Q. Puis-je exclure des utilisateurs spécifiques du classement d'un chat (ex. des bots spam) ? Oui : /setup → 🎯 Filtres → 🙈 Ignorer → ➕ Ajouter. Les identifiants listés sont retirés des résultats après récupération.

Q. Pourquoi mon chat a-t-il plusieurs déclenchements de rapport par jour ? Soit vous avez défini un cron multi-déclenchement (cron(0 14,22 ? * * *)), soit vous avez plusieurs filtres nommés fonctionnant sur la même planification. Chaque filtre nommé produit son propre rapport.

Q. Le choix du « Meilleur tweet » semble étrange. Le sélecteur IA choisit le post avec le meilleur engagement qui n'a pas été choisi récemment. Si les résultats semblent constamment décalés, contactez le support — le prompt est ajustable.

Relais automatique des posts X

Q. Le relais a transféré un fil de 6 posts d'un coup. Je voulais seulement le premier. C'est parce que le exclude=replies de l'API X ne filtre que les réponses à d'autres utilisateurs ; les auto-réponses (suites de fil) le contournent. /setup → 📡 Relais automatique des posts X → @compte → désactivez ☐ Suites de fil. Le bot garde alors uniquement la tête de chaque fil.

Q. Le relais a cessé de transférer en milieu de journée. Vérifiez l'écran par relais — si Aujourd'hui : 10/10 relayés, vous avez atteint le plafond quotidien. Appuyez sur ✏️ Plafond pour l'augmenter. Le plafond se réinitialise automatiquement à minuit UTC.

Q. Le relais affiche ⏸ En pause mais je ne l'ai jamais mis en pause. Le bot se met automatiquement en pause en cas d'erreurs de chat disparu Telegram (expulsé / bloqué / chat mis à niveau) et arrête le calendrier d'interrogation. /setup → 📡 Relais automatique des posts X affiche la ligne au cas où vous réajouteriez le bot.

Facturation & crédits

Q. Qu'est-ce qu'un « crédit » exactement ? Un crédit = un post renvoyé par l'API X. Les chats FREE obtiennent 100 crédits gratuits/mois ; les chats PRO sont facturés via Stripe (abonnement) ou ETH (pack de crédits).

Q. Où puis-je voir mon solde de crédits ?/setup → 💳 Achat de crédits. Affiche utilisé / restant / date de réinitialisation.

Q. Je viens de payer mais mon solde / plan ne s'est pas mis à jour.

• Voie Stripe (abonnement carte) : le webhook active généralement PRO en quelques secondes. Si après 5+ minutes vous ne voyez toujours pas PRO ✓ dans /setup → 💳 Achat de crédits, contactez le support avec votre reçu Stripe et l'ID du chat.
• Voie ETH (pack de crédits) : la confirmation on-chain peut prendre 1 à 3 minutes. Si après 10 minutes les crédits n'apparaissent pas, contactez le support avec le hash de la transaction et l'ID du chat.

Q. Puis-je avoir à la fois un abonnement Stripe ET des crédits ETH sur le même chat ? Oui — ils se combinent. Un chat PRO·crédits qui s'abonne conserve son solde ETH existant, et la facturation par récupération consomme d'abord les crédits ETH avant que l'allocation mensuelle de l'abonnement n'intervienne. Effet pratique : si vous avez 5 000 crédits ETH et que vous vous abonnez, les 5 000 premières récupérations ne touchent pas du tout Stripe ; les récupérations suivantes utilisent l'allocation de 1 000/mois de l'abonnement ; tout ce qui dépasse est mesuré à 0,02 $/post. Le solde ETH n'expire jamais.

La seule contrainte : un chat déjà sur PRO·abonnement ne peut pas ajouter un nouveau pack ETH depuis le même flux d'achat aujourd'hui (la commande d'achat le bloque). Annulez d'abord l'abonnement si vous voulez repasser en crédits uniquement.

Q. Que se passe-t-il quand mon solde PRO·crédits atteint zéro ? La licence est automatiquement rétrogradée en FREE. Le bot continue de récupérer sous le plafond FREE de 100/mois jusqu'à ce que cela soit aussi épuisé. Le prochain /setup → 💳 → 💰 Acheter propose alors à nouveau les deux voies.

Q. Le solde de crédits est-il par chat ou par utilisateur ? Par chat. Chaque groupe Telegram a ses propres crédits et sa propre licence.

Tableau de bord public

Q. Mon projet n'apparaît pas sur xbot.ninja. Trois seuils doivent tous être atteints dans le mois en cours :

• Score du meilleur utilisateur ≥ 300
• Posts suivis ≥ 5
• Utilisateurs actifs ≥ 2

Le premier mois est généralement le facteur limitant. L'URL directe https://xbot.ninja/?chatId=<votre-id> fonctionne dans tous les cas.

Q. Comment trouver mon ID de chat ?/setup → ℹ️ À propos. Le grand entier préfixé par un signe négatif.

Q. Puis-je personnaliser la carte publique xbot.ninja ?/setup → 🎨 Personnalisation. Définissez Nom, Description, Logo, URLs. La carte s'actualise au prochain cycle de rapport.

Particularités de l'API X

Q. Pourquoi certains posts plus anciens qu'attendu sont-ils comptabilisés ? Le bot utilise tweets/search/all (le point de terminaison d'archive complète). Lorsque vous définissez une période, le bot peut récupérer des posts de n'importe quel moment à l'intérieur de celle-ci. La valeur par défaut est une fenêtre glissante de 24h, mais une période personnalisée peut être antidatée.

Q. Parfois un post met plus de 5 minutes à apparaître dans un relais. Le relais automatique des posts X interroge toutes les 5 minutes. La latence peut atteindre un intervalle d'interrogation (~2,5 min en moyenne / ~5 min dans le pire des cas). Plus une brève latence de livraison de l'API X + Telegram.

Q. L'API X a renvoyé une erreur — que voit l'opérateur ? Les compteurs d'erreurs internes s'incrémentent, les administrateurs désignés reçoivent un DM privé (/setup → 👥 Admins pour configurer qui). Codes 4xx courants : 401/403 (identifiants côté opérateur), 402 (crédits épuisés), 429 (limité en débit — le bot réessaie avec un délai croissant).

Ce qu'il faut inclure dans une demande de support

Copiez et collez ce modèle :

Projet : <nom de votre projet>
ID du chat : <depuis /setup → ℹ️ À propos>
Plan : FREE / PRO·crédits / PRO·abonnement
Ce qui ne va pas : <1–2 phrases>
Ce que vous avez essayé : </setup → … → … étapes suivies>
Quand c'est apparu : <heure UTC approximative>
Changement récent : <tout nouveau filtre / planification / paiement dans les 24 h>

L'ID du chat à lui seul donne au support 80 % des informations de triage — veuillez toujours l'inclure.

Délais de réponse attendus

• Critique : bot hors ligne pour toute la plateforme, échecs de facturation → réponse sous 1 heure ouvrée pendant le chevauchement des heures ouvrées EU+US
• Élevée : rapport non livré pour un seul chat → même jour ouvré
• Normale : questions sur les fonctionnalités, aide à la configuration → 1–2 jours ouvrés

Liens utiles

• Bot Telegram : @BWS_X_Bot
• Tableau de bord public : xbot.ninja
• Documentation : /docs/
• Issues GitHub : blockchain-web-services/bws-api-telegram-xbot
• Support direct : bws.ninja — le formulaire de contact route vers le support des développeurs BWS

Avant de contacter le support, parcourez le flux d'auto-diagnostic de Dépannage — la plupart des problèmes se résolvent aux deux premières vérifications.