Dépanner X Bot : rapports, filtres, planifications, facturation
Un index consolidé de chaque parcours « quelque chose ne va pas, que faire maintenant ». Les matrices de l'installation / du menu setup / du support vivent aussi ici afin que vous puissiez chercher sur une seule page au lieu de trois.
Commencez ici : ouvrez
/setup→ ℹ️ À propos dans votre groupe. Les quatre lignes de cet écran (ID du chat, plan, planification, nom du projet) sont ce dont le support a besoin pour trier. Copiez-les avant de faire quoi que ce soit d'autre.
Flux d'auto-diagnostic
Parcourez ces questions dans l'ordre. La plupart des problèmes se résolvent à l'une des deux premières vérifications.
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
produit une publication dans les 3 minutes ?
├─ Aucun DM, aucune publication → voir la matrice §« Rapports qui n'arrivent pas »
├─ DM « aucun post trouvé » → voir §« Filtre / aucun post »
├─ DM « crédits épuisés » → voir §« Facturation et crédits »
├─ La publication est arrivée mais s'affiche mal → voir §« Qualité du rendu »
└─ La publication est correcte → tout va bien.
3. Les rapports planifiés arrivent-ils à l'heure ?
├─ Non → voir §« La planification ne se déclenche pas »
└─ Oui → tout va bien.
4. Problèmes avec le relais automatique des posts X ?
└─ Voir §« Relais automatique des posts X »Si aucune des matrices ci-dessous ne vous mène à une solution, allez à Escalade.
Rapports qui n'arrivent pas
| Symptôme | Cause probable | Solution |
|---|---|---|
| Le bot était actif avant, soudainement silencieux | Le bot a été démis de son statut admin / expulsé silencieusement | Telegram → administrateurs du groupe → repromouvez. Si toujours silencieux, contactez le support — la désactivation automatique sur chat disparu a peut-être été déclenchée. |
| La génération manuelle ne produit rien | Le bot est admin mais n'a plus de crédits | /setup → 💳 Achat de crédits. Si FREE « 100/100 utilisés » — attendez la réinitialisation mensuelle (1er du mois UTC). Si PRO·crédits avec REMAINING=0 — le chat est déjà rétrogradé automatiquement en FREE ; /setup → 💳 → 💰 Acheter pour recharger. |
| Génération manuelle : DM admin « aucun post trouvé » | Filtre trop restrictif OU aucun post dans la fenêtre | /setup → 🎯 Filtres. Vérifiez les fautes de frappe dans la requête littérale de l'API X. Essayez d'élargir ou de supprimer la période. |
| L'image s'affiche mais le texte est vide | Le commentaire IA a expiré | Relancez ; c'est transitoire. Persistant = contactez le support. |
| L'image ne se rend pas du tout | Accroc de rendu transitoire | Relancez. Si l'échec persiste pour un chat, contactez le support avec l'ID du chat. |
| Erreur « Unauthorized » / « Forbidden » dans le DM admin | Problème de jeton de l'API X (côté opérateur) | Contactez le support ; rien que l'utilisateur puisse corriger. |
Filtre / aucun post
| Symptôme | Cause probable | Solution |
|---|---|---|
| Le rapport affiche « 0 posts » partout | Le filtre ne correspond à rien dans la période configurée | Étape 1 : /setup → 🎯 Filtres — confirmez la requête. Étape 2 : /setup → 📊 Rapports → 🗑 Effacer la période (la fenêtre glissante de 24h est plus tolérante). Étape 3 : élargissez les filtres (ajoutez un cashtag de secours, supprimez les groupes de mots-clés stricts). |
| Le classement affiche des utilisateurs que je n'ai pas ajoutés au filtre | Les filtres sont additifs — quiconque tweete un cashtag/mot-clé suivi compte | Pour exiger à la fois un compte et un cashtag, utilisez /set_x_filtering nom from:@x cashtags:$Y (filtre nommé, ET-des-catégories). |
| Le même utilisateur a spammé le classement | Le bot a légitimement scoré chaque post | /setup → 🎯 Filtres → 🙈 Ignorer → ➕ Ajoutez @spammer — ils sont retirés des résultats après récupération. |
| Un cashtag avec des caractères étranges ne correspond pas | L'API X normalise la casse ; les espaces en début/fin comptent dans la saisie du filtre | Réajoutez via /setup → 🎯 Filtres → 💵 Cashtags → ➕ Ajouter → pas de $ nécessaire, pas d'espaces. |
Un cashtag préfixé par un nombre (ex. $1INCH) n'est pas suivi | Le comportement de recherche de l'API X avec des nombres en tête peut être incohérent | Utilisez-le comme mot-clé plutôt que comme cashtag : "$1INCH" dans 🔍 Mots-clés avec des guillemets. |
| Le choix du « Meilleur tweet » semble étrange | La déduplication IA a récemment choisi un tweet similaire | Attendez un cycle. Si le décalage persiste, signalez-le ; le prompt est ajustable. |
La planification ne se déclenche pas
| Symptôme | Cause probable | Solution |
|---|---|---|
Planification « rejetée » avec FREQUENCY_ERROR | Le cron tente de se déclencher plus souvent que toutes les 12h | La vérification d'espacement impose des écarts ≥ 12h. Le message d'erreur nomme la paire d'heures fautive. Choisissez un écart plus large. |
| Planification définie, mais rapport pas arrivé à l'heure | Le cron planifié se déclenche dans ~1–2 min du tick | Attendez 5 min après l'heure configurée avant de supposer un manqué. Des retards en amont rares surviennent mais se résolvent d'eux-mêmes. |
| Le cron multi-déclenchement ne se déclenche qu'une fois | Liste d'heures dans le désordre ou dupliquée | cron(0 14,22 ? * * *) — heures croissantes. cron(0 22,14 ? * * *) est rejeté. |
| La planification se déclenche toutes les 5 min en staging, pas en prod | Espace de noms RULE_NAME différent | Vérifiez que vous consultez le bon environnement. /setup → ℹ️ À propos affiche l'environnement. |
| Le fuseau horaire semble incorrect | La planification est en UTC par conception | Convertissez votre heure locale en UTC. La saisie de planification accepte aussi des fuseaux nommés dans certains cas particuliers — vérifiez la docstring de la saisie. |
| Le relais automatique des posts X se déclenche mais pas les rapports | Cron distincts | Le relais automatique des posts X utilise une interrogation de 5 min par relais ; les rapports utilisent le cron principal du chat (typiquement quotidien). Ils sont indépendants. |
Qualité du rendu
| Symptôme | Cause probable | Solution |
|---|---|---|
| Titre / couleur personnalisé réinitialisé du jour au lendemain | Cache invalidé, la prochaine récupération affiche la nouvelle valeur | Attendez un cycle de rapport (~1 jour). Le cache de rendu se reconstruit à la prochaine récupération. |
| Logo flou / recadré | Image source trop petite ou non carrée | Retéléversez en ≥ 512×512 PNG, format carré. /setup → 🎨 Personnalisation → 🖼 Logo. |
| Le nom d'utilisateur déborde dans l'image du classement | Nom d'affichage trop long | Le bot tronque avec des points de suspension ; aucune correction nécessaire sauf si persistant. |
Le texte du meilleur tweet affiche du HTML brut <a href> | Décalage du mode de parsing Telegram | Bug — merci de le signaler avec l'URL du tweet. |
| Image de rapport différente de l'aperçu Telegram | Telegram met en cache les premiers octets d'image par URL ; les URLs présignées incluent un horodatage donc chaque récupération est unique | Ne devrait pas arriver ; si c'est le cas, régénérez via /recreate. |
Relais automatique des posts X
| Symptôme | Cause probable | Solution |
|---|---|---|
| Le relais relaie un fil de 6 tweets d'un coup | Les auto-réponses contournent le exclude=replies de l'API X | /setup → 📡 Relais automatique des posts X → @compte → désactivez ☐ Suites de fil. Le bot garde alors uniquement la tête. |
| Le relais s'est arrêté en milieu de journée | Plafond quotidien atteint | L'écran par relais affiche Aujourd'hui : N/N relayés. Appuyez sur ✏️ Plafond et augmentez-le. Réinitialisation à minuit UTC. |
| Le relais affiche ⏸ En pause mais je ne l'ai jamais mis en pause | Mise en pause automatique sur chat disparu Telegram (expulsé / bloqué / chat mis à niveau) | Le bot a aussi arrêté le calendrier d'interrogation. Pour restaurer : /setup → 📡 Relais automatique des posts X → @compte → ▶️ Reprendre. Si toujours en échec, le chat lui-même a peut-être changé d'ID (mise à niveau en supergroupe) — réajoutez le bot dans le nouveau chat. |
| La première interrogation du relais a relayé 50 posts | L'amorçage ne devrait pas faire ça — il devrait seulement initialiser LAST_POST_ID sans relayer | Si vous voyez cela, merci de le signaler. Le correctif ajouté en 2026-04 devrait empêcher cela. |
| Les citations continuent d'apparaître malgré la bascule | L'API X n'a pas de exclude=quotes côté serveur — le bot filtre côté client | La bascule fonctionne, mais vous payez toujours pour les citations renvoyées par l'API. Économie cosmétique uniquement. |
| Le relais interroge indéfiniment malgré la suppression du chat | Ancienne version du relais — nettoyage automatique ajouté en 2026-05 | Demandez au support de forcer l'arrêt du relais. Les nouveaux déploiements se nettoient automatiquement. |
Facturation et crédits
| Symptôme | Cause probable | Solution |
|---|---|---|
| Crédits achetés, solde inchangé | Webhook Stripe retardé | Attendez 5 min. Si toujours incorrect, contactez le support avec le reçu Stripe + ID du chat. |
| Décompte de crédits supérieur à ce que j'attendais | Un relais a interrogé plusieurs fois pendant une période où le compte suivi était actif | Le relais automatique des posts X facture par post. Appuyez sur le relais → vérifiez le compteur Aujourd'hui. |
| Facturation de dépassement sur PRO·abonnement alors que j'ai peu posté | Autre usage sur le chat (relais, rapports, nouvelles tentatives de récupération) | /setup → 💳 Achat de crédits → Utilisation ce mois-ci. Comparez avec la charge mesurée. |
| Chat FREE facturé | Ne devrait pas arriver — FREE n'a pas de client Stripe | Signalez-le immédiatement ; c'est un bug de facturation. |
| L'abonnement affiche « annulé » mais je ne l'ai pas annulé | L'annulation Stripe peut être déclenchée par un échec de renouvellement automatique de carte | Vérifiez vos e-mails pour les reçus Stripe, mettez à jour votre carte via /setup → 💳 → 🛠 Gérer l'abonnement (portail client Stripe). |
| Abonnement annulé, toujours PRO | Annulation en fin de période : PRO jusqu'à la fin de la période payée | Attendu. Repasse en FREE à la fin du prochain cycle de facturation. |
Tableau de bord public
| Symptôme | Cause probable | Solution |
|---|---|---|
| Projet absent de xbot.ninja | N'atteint pas les seuils (≥ 300 score le plus élevé, ≥ 5 posts, ≥ 2 utilisateurs actifs ce mois-ci) | L'URL directe fonctionne toujours. Attendez que la métrique atteigne le seuil. Les configurations de KOL indépendant sont intentionnellement masquées de la vitrine. |
| Projet sur xbot.ninja mais logo manquant | Logo jamais téléversé, ou téléversement échoué | /setup → 🎨 Personnalisation → 🖼 Logo. Envoyez un PNG carré. |
| L'URL publique affiche l'ancien nom du projet | Actualisation au prochain cycle de rapport | Renommez via /setup → 🎨 Personnalisation → 🏷 Nom. Le slug de l'URL + la carte s'actualisent une fois le prochain rapport déclenché. |
| L'URL renvoie une erreur 404 | Le chat a été définitivement supprimé, OU les seuils ne sont pas encore atteints donc la vitrine le masque | Confirmez l'ID du chat via /setup → ℹ️ À propos. Testez l'URL directe https://xbot.ninja/?chatId=<id>. |
Escalade
Lorsque les matrices ci-dessus ne résolvent pas le problème, contactez le support avec le modèle ci-dessous.
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.
Où l'envoyer :
- Support général : formulaire de contact bws.ninja
- Issues GitHub (conscient de l'open-source) : bws-api-telegram-xbot/issues
- Telegram direct : @BlockchainWebServices
Délais de réponse par gravité :
- Critique (bot hors ligne pour toute la plateforme, échecs de facturation) : 1 heure ouvrée pendant le chevauchement des heures ouvrées EU+US
- Élevée (le rapport d'un seul chat ne se livre pas) : même jour ouvré
- Normale (questions sur les fonctionnalités, aide à la configuration) : 1–2 jours ouvrés
Commandes de diagnostic utiles
| Commande | Ce qu'elle affiche |
|---|---|
/setup → ℹ️ À propos | ID du chat, plan, planification, projet — copiez ceci mot pour mot dans le support |
/setup → 🎯 Filtres | Chaîne de requête littérale de l'API X |
/setup → 💳 Achat de crédits → 📊 Utilisation ce mois-ci | Compteurs fetched_posts quotidiens + mensuels — repère les échecs silencieux (tentatives élevées, zéro post → probablement des 402) |
/setup → 📡 Relais automatique des posts X → @compte | État par relais (actif / en pause, relais du jour, plafond quotidien) |
/get_chatid | Juste l'ID du chat (une ligne si À propos est excessif) |
Et ensuite ?
- Installation — réinstallation propre si tout le reste échoue
- Le menu /setup — référence complète du menu
- Tarifs — dépannage côté facturation
- Support — FAQ + contact d'escalade