Installation

Configurez X Bot dans votre groupe Telegram en trois étapes. La plupart des équipes terminent l'installation en moins de trois minutes ; l'assistant fait le gros du travail.

Le chemin le plus rapide — @BWS_X_Bot → ajout au groupe → /setup → 🚀 Démarrage rapide. Les quatre invites qui suivent sont tout ce dont vous avez besoin.

Réunissez ces 5 éléments avant de commencer

Avant de commencer, ayez ceci sous la main :

Pour une visite écran par écran de chaque option que vous configurerez ci-dessous, consultez Le menu /setup.

Vous avez besoin de	D'où cela vient
Un compte Telegram	telegram.org
Des droits d'administrateur sur un groupe Telegram	Créez-en un si vous n'en avez pas : Telegram → Nouveau groupe
Le(s) identifiant(s) X, cashtag(s) ou mot(s)-clé(s) que vous voulez suivre	Ex. @votre_pseudo, $VOTRE_TOKEN, "#VotreCampagne"
(Optionnel) Logo du projet + liste d'URLs	Pour la vitrine publique xbot.ninja
(Optionnel) Préférence de fuseau horaire	La planification est en UTC ; choisissez une heure UTC qui tombe au moment où votre communauté est la plus active

Vous n'êtes pas sûr du plan dont vous aurez besoin ? Consultez Tarifs — la plupart des équipes démarrent sur le palier FREE (100 posts/mois) et évoluent ensuite.

Si vous n'êtes pas sûr du scénario qui vous correspond, parcourez les 4 cas d'usage de l'Aperçu — choisissez le plus proche et utilisez sa recommandation de filtre à l'étape 2 ci-dessous.

Étape 1 — Ajouter le bot à votre groupe

1. Ouvrez Telegram et recherchez @BWS_X_Bot.
2. Ajoutez le bot à votre groupe.
3. Promouvez-le administrateur. Aucune permission spéciale n'est requise au-delà des droits d'admin par défaut (le bot a besoin du statut admin uniquement pour que Telegram l'autorise à lire les messages du groupe et à poster les rapports).

Groupe, pas message privé

Les fonctionnalités d'analyse du bot ne fonctionnent que dans les groupes, pas en messages privés. Si vous démarrez un DM avec @BWS_X_Bot, vous verrez /help et /buy fonctionner mais la majeure partie du menu de configuration ne fonctionnera pas.

Étape 2 — Lancer /setup

Dans votre groupe, tapez :

/setup

Le bot répond avec un menu interactif. Appuyez sur 🚀 Démarrage rapide pour ouvrir l'assistant en quatre étapes.

L'assistant pose quatre questions dans l'ordre :

Étape	Invite	Exemples
1	Nom du projet	MyToken, Campagne KOL T2, Portfolio de @votre_pseudo
2	Quoi suivre sur X	📢 Comptes + identifiants, 💵 Cashtags + tickers, ou 🔍 Mots-clés + expressions
3	Quand le bot doit s'exécuter	Choisissez un préréglage quotidien (09:00 / 14:00 / 18:00 / 22:00 UTC) ou envoyez une heure personnalisée
4	Terminé	Récapitulatif de ce qui a été enregistré

Passer et Quitter sont toujours disponibles — un assistant partiellement complété ne vous bloque jamais, les paramètres restent simplement à leurs valeurs par défaut.

Pourquoi /setup ? Il enveloppe chaque commande admin dans une interface cliquable et modifiable sur place afin que vous n'ayez pas à mémoriser les commandes. Les paramètres s'enregistrent instantanément. Les utilisateurs avancés peuvent toujours taper directement les commandes slash — les deux interfaces sont équivalentes et le comportement est identique. Visite complète : Le menu /setup.

Étape 3 — Vérifier

Une fois l'assistant terminé, ouvrez /setup → 📊 Rapports → ⚡ Générer un rapport maintenant pour envoyer un rapport immédiat (le prochain rapport programmé s'exécutera à l'heure que vous avez choisie à l'étape 2).

Le bot poste l'image du classement dans le groupe en ~1 à 3 minutes. Les chats plus petits (une poignée de comptes, faible volume de posts) terminent plus vite ; les chats communautaires avec des centaines de posts à récupérer peuvent prendre 2 à 3 minutes.

Attendez la première exécution planifiée

Après le Générer un rapport maintenant manuel, la prochaine exécution automatisée se produit à l'heure cron configurée. Vous obtiendrez un rapport par déclenchement — pas de double publication.

Coûts et crédits

X Bot utilise l'API X officielle pour toute la récupération de données. Chaque chat démarre en FREE ; à partir de là, vous pouvez superposer l'une ou les deux voies payantes :

Plan	Ce que vous payez	Ce que cela couvre
FREE	0 $	100 posts/mois avec un plafond strict. Le bot met en pause les récupérations à 100 ; réinitialisation le 1er du mois suivant.
Abonnement PRO (Stripe)	19 $/mois + 0,02 $/post au-delà de 1 000/mois (mesuré via Stripe)	Renouvellement automatique. Les 1 000 premiers posts/mois sont inclus comme seuil gratuit (pas un solde de crédits — pas de report).
Crédits PRO (ETH)	0,02 $/crédit, packs de 1 000 / 2 000 / 3 000 / 4 000 / 5 000 / 10 000 / 50 000 / 100 000	Achat unique. Les crédits n'expirent jamais. Recharge un solde existant.

Un chat peut détenir à la fois PRO·abonnement et PRO·crédits simultanément — la facturation par récupération consomme d'abord les crédits ETH, puis l'allocation mensuelle de l'abonnement, puis le dépassement mesuré. Consultez tarifs pour la matrice complète de transition de plan et le processus d'achat.

Plan + solde toujours visibles via /setup → 💳 Achat de crédits. Les administrateurs désignés reçoivent un DM Telegram lorsque les crédits atteignent 80 % puis à nouveau lorsqu'ils sont épuisés.

Prochaines étapes recommandées par cas d'usage

Choisissez la ligne qui correspond à votre scénario, puis suivez la section liée de l'Aperçu pour la recette complète :

Scénario	À ajouter après l'assistant	Détail
Agence de KOL suivant 5 KOL	Cashtag + affinage du hashtag de campagne, planification 22:00 UTC	Cas d'usage 1
Projet engageant sa communauté	Logo + URLs dans 🎨 Personnalisation pour la carte publique xbot.ninja	Cas d'usage 2
Portfolio de KOL indépendant	Photo personnelle + URL LinkedIn dans Personnalisation, partagez l'URL xbot.ninja avec les prospects	Cas d'usage 3
Agence multi-clients	/setup → 🎯 Filtres → ⤴ Filtres nommés → ➕ Ajouter un filtre nommé — un par client	Cas d'usage 4
Recevoir les posts d'un compte X en temps réel	/setup → 📡 Relais automatique des posts X → ➕ Ajouter un compte	Le menu /setup

Ce qui est configuré

Section dans /setup	Ce que vous définissez	Pourquoi c'est important
🎯 Filtres	Comptes, cashtags, mots-clés, mentions à suivre sur X	Définit quels posts le bot récupère
⏰ Planification	Heure du rapport automatisé	Le bot exécute la récupération + le rendu sur ce cron
📊 Rapports & Période	Fenêtre de dates optionnelle (ex. période de compétition)	Restreint le rapport à une plage spécifique
🎨 Personnalisation	Nom du projet, description, logo, URLs, poids et couleurs du classement	Image de marque pour l'image du rapport et la vitrine publique xbot.ninja
👥 Administrateurs	Qui reçoit les DM privés concernant les problèmes de crédits / récupération	Visibilité opérationnelle
💳 Abonnement	Plan, solde de crédits, point d'entrée pour la mise à niveau	Visibilité des coûts et paiement
📡 Relais automatique	Comptes X à relayer dans le chat en temps réel (toutes les 5 min)	Mises à jour en direct entre les rapports planifiés

Vitrine publique (optionnel)

Si votre projet atteint les seuils d'inscription publique (≥ 300 score le plus élevé, ≥ 5 posts, ≥ 2 utilisateurs actifs dans le mois en cours), il apparaît sur xbot.ninja. Ajoutez les métadonnées du projet sous /setup → 🎨 Personnalisation (Nom, Description, Logo, URLs).

Les configurations de KOL indépendant (compte unique) ne passent pas la règle « ≥ 2 utilisateurs actifs » et restent accessibles uniquement à leur URL directe — c'est voulu.

Vérifier l'installation

La plupart des diagnostics sont visibles directement dans /setup (chaque écran affiche l'état actuel du chat en haut). Liste de vérification rapide :

Vérification	Comment
Le bot est administrateur	Telegram → paramètres du groupe → Administrateurs
Le suivi est configuré	/setup → 🎯 Filtres → voir les comptes/cashtags/mots-clés listés
Le filtre s'affiche correctement	/setup → 🎯 Filtres
La planification est définie	/setup (le haut du menu affiche la planification actuelle)
Crédits disponibles	/setup → 💳 Achat de crédits
Le rapport manuel fonctionne	/setup → 📊 Rapports → ⚡ Générer un rapport maintenant

Le premier rapport n'apparaît pas — dépannage

Si Générer un rapport maintenant ne produit pas de publication dans les 3 minutes :

Symptôme	Cause probable	Solution
Le DM du bot dit « aucun post trouvé »	Filtre trop restrictif OU aucun post récent correspondant	/setup → 🎯 Filtres — vérifiez les fautes de frappe dans la requête littérale de l'API X. Essayez d'élargir (supprimez la période si définie).
Le DM du bot dit « crédits épuisés »	Le chat FREE a atteint le plafond de 100/mois	Attendez le mois prochain, ou /setup → 💳 Achat de crédits → 💰 Acheter pour vous abonner / acheter un pack de crédits
Rien ne se passe, aucun DM	Le bot n'est pas admin, OU le webhook s'est arrêté	Repromouvez le bot administrateur. Si toujours rien, contactez le support.
L'image s'affiche mais le texte est vide	Le commentaire IA a expiré	Relancez ; c'est transitoire. Si cela persiste, contactez le support — le fournisseur d'IA a parfois des pannes ponctuelles
Erreur « Unauthorized » / « Forbidden »	Problème de jeton de l'API X (côté opérateur)	Contactez le support ; rien que l'utilisateur puisse corriger

Diagnostics en libre-service

/setup → ℹ️ À propos affiche l'ID de votre chat, votre plan et votre planification sur un seul écran. Copiez ce texte dans toute demande de support — cela réduit le triage d'environ 80 %.

FAQ — questions d'installation fréquentes

Q. Puis-je installer le bot dans une chaîne Telegram (pas un groupe) ? Non, seulement les groupes et supergroupes. Les chaînes ne permettent pas le contexte de réponse par message, que le flux de rapport utilise.

Q. Puis-je exécuter le bot dans un groupe de type forum avec des sujets ? Oui. Utilisez /set_topic depuis l'intérieur du sujet dans lequel vous voulez que les rapports soient postés. Le bot poste dans ce sujet à partir de maintenant ; si non défini, il poste dans le fil principal.

Q. Le bot a-t-il besoin d'un accès en lecture aux messages de mon groupe ? Le bot a seulement besoin de recevoir les messages de commande (ex. /setup). Il ne lit pas le chat normal. Les données côté X proviennent de l'API X officielle, pas de vos messages Telegram.

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

Q. Retirer le bot du groupe supprime-t-il mes données ? Non. Paramètres, historique, scores et rapports restent dans la base de données du bot. Si vous réajoutez le bot au même ID de chat, tout reprend. Si vous voulez une suppression propre, contactez le support.

Q. Puis-je changer le nom du projet plus tard ? Oui — /setup → 🎨 Personnalisation → 🏷 Nom. Met à jour le prochain rapport et le slug de l'URL publique xbot.ninja.

Q. Pourquoi vois-je des nombres de posts différents de [outil X] ? X Bot puise directement dans l'API X officielle. La plupart des outils tiers scrappent ou extrapolent. Nous avons constaté des écarts de 20 à 50 % en pratique. Le chiffre de l'API X fait foi.

Q. Comment annuler ?

• Chats FREE : retirez simplement le bot du groupe.
• Abonnement PRO : /setup → 💳 Achat de crédits → 🛠 Gérer l'abonnement ouvre le portail client Stripe où vous pouvez annuler. L'annulation prend effet à la fin de la période payée en cours.
• Crédits PRO (ETH) : les crédits ne se renouvellent pas automatiquement — le chat rétrograde vers FREE de lui-même lorsque le solde atteint zéro. Retirez le bot à tout moment.

Besoin d'aide ?

Consultez Support, ou ouvrez /setup → ℹ️ À propos dans votre chat pour les informations de diagnostic à partager avec l'équipe.

Lisez l'aperçu de X Bot pour le détail complet de ce que chaque public — projets crypto, agences de KOL, KOL indépendants, investisseurs — retire du bot avant de commencer la configuration.