Introduction
Pour développer et héberger un bot X (Twitter) sur Square Cloud, il est essentiel de suivre une séquence structurée de configurations et de prérequis. Ce guide technique couvrira l’ensemble du processus, de la configuration initiale au déploiement en production.Prérequis
- Compte Square Cloud : Inscrivez-vous via la page d’inscription en utilisant votre adresse e-mail.
- Plan actif : Garantit des ressources dédiées et des performances optimisées pour votre application. Consultez nos plans disponibles et choisissez celui qui convient le mieux à vos besoins.
Créer le projet
Un compte X (Twitter) actif est requis pour l’authentification et le fonctionnement du bot. Si vous n’avez pas de compte, inscrivez-vous sur le site officiel de X.Un compte X Developer est également requis pour accéder aux API. Demandez l’accès via le X Developer Portal.
Application du bot sur X
Ouvrir le Developer Portal
- Rendez-vous sur le X Developer Portal.
- Connectez-vous avec votre compte X (Twitter).
- Si c’est votre première fois, complétez le processus de demande d’accès développeur.
Créer un projet
- Dans le tableau de bord, cliquez sur “Create Project”.
- Choisissez un nom pour votre projet (par ex. “Square Cloud Bot”).
- Sélectionnez le cas d’usage le plus approprié (par ex. “Making a bot”).
- Fournissez une description détaillée de votre bot.
- Confirmez la création du projet.
Créer une app
- Au sein du projet créé, cliquez sur “Create App”.
- Définissez un nom unique pour votre application.
- Confirmez la création de l’application.
- Notez l’App ID généré pour référence future.
Générer les clés d'API
- Accédez à la section “Keys and tokens” de votre application.
- Dans la section “Consumer Keys”, cliquez sur “Regenerate” pour générer :
- API Key (Consumer Key)
- API Secret Key (Consumer Secret)
- Important : Copiez et enregistrez ces clés immédiatement, car vous ne pourrez plus les consulter par la suite.
Définir les permissions de l'app
- Rendez-vous dans la section “App permissions”.
- Cliquez sur “Edit” pour modifier les permissions.
- Sélectionnez “Read and write” pour permettre à votre bot de publier des tweets.
- Si nécessaire, sélectionnez “Read and write and Direct message” pour la fonctionnalité de DM.
- Enregistrez les modifications.
Générer les jetons d'accès
- Retournez dans la section “Keys and tokens”.
- Dans la section “Access Token and Secret”, cliquez sur “Generate”.
- Confirmez la génération des jetons.
- Copiez et enregistrez :
- Access Token
- Access Token Secret
- Attention : Ces jetons ne peuvent plus être consultés après avoir fermé la page.
Vérifier vos identifiants
- Confirmez que vous disposez des 4 identifiants requis :
- API Key (Consumer Key)
- API Secret Key (Consumer Secret)
- Access Token
- Access Token Secret
- Conservez ces identifiants dans un endroit sécurisé
- Important : Ne partagez ni n’exposez jamais publiquement ces identifiants
Développer le bot
- Vérification de Node.js : Vérifiez que Node.js est installé sur votre système. Sinon, téléchargez-le depuis le site officiel de Node.js.
- Initialisation du projet : Créez un nouveau projet Node.js en exécutant :
- Installation des dépendances : Installez les bibliothèques requises pour le bot :
- Identifiants : le code lit les quatre identifiants depuis des variables d’environnement : ils n’entrent donc jamais dans votre code. Pour tester le bot sur votre ordinateur, placez-les dans un fichier
.envet démarrez le bot avecnode --env-file=.env index.js:
- Création du fichier principal : Développez le fichier
index.jsavec la structure de base du bot :
Configurer Square Cloud
Créez un fichiersquarecloud.app à la racine de votre projet, à côté de index.js. Il indique à Square Cloud comment exécuter votre bot :
MEMORYest la RAM du bot en Mo. Les bots ont besoin d’au moins 256 Mo ; 512 Mo laissent de la marge pour évoluer.AUTORESTART=trueredémarre le bot s’il plante. Consultez le fonctionnement du redémarrage automatique.- Il n’y a pas de
SUBDOMAIN: le bot appelle l’API X et ne sert pas de pages web.
Définir les identifiants
API_KEY: Votre clé d’API XAPI_SECRET_KEY: Votre clé secrète d’API XACCESS_TOKEN: Votre jeton d’accèsACCESS_TOKEN_SECRET: Votre secret de jeton d’accès
- Tableau de bord : sur la page d’envoi, ouvrez Configuration avancée et ajoutez les quatre variables. Pour un bot déjà déployé, ajoutez-les sur la page Variables d’environnement de l’application et redémarrez le bot.
- CLI : juste après avoir envoyé le bot (voir Déployer et vérifier), chargez-les depuis votre fichier
.envlocal avecsquarecloud app env setet redémarrez le bot :
Contenu du ZIP
index.jset vos autres fichiers source.package.json.squarecloud.app.
node_modules : Square Cloud installe vos dépendances au démarrage du bot. Excluez aussi votre fichier .env : si vous envoyez avec la CLI, ajoutez une ligne .env à votre fichier squarecloud.ignore pour que la CLI l’ignore.
Déployer et vérifier
Créez le ZIP décrit ci-dessus, puis envoyez-le :Via le tableau de bord
Accéder à la page d'upload
Configurer votre environnement
Si vous téléversez un projet web, veillez à sélectionner « Publication Web » et à définir un sous-domaine pour votre projet.
Déployer votre projet
Une fois le déploiement effectué, vous pouvez suivre l’état et les logs de votre projet depuis le tableau de bord.

Confirmez que votre application est en ligne
Si vous avez déployé un site web ou une API, ouvrez
https://<votre-sous-domaine>.squareweb.app dans votre navigateur, vous devriez voir votre application répondre. Si vous avez déployé un bot, envoyez-lui une commande pour confirmer qu’il est en ligne.
Via la CLI
Pour utiliser cette méthode, votre projet a besoin d’un fichier de configuration nommésquarecloud.app à sa racine. Il indique à Square Cloud comment exécuter votre application.
Guide du fichier de configuration
squarecloud.app qui définit l’environnement de votre application.Installer la CLI
Se connecter
Téléverser votre projet
squarecloud.ignore, puis l’envoie :--file :Confirmez que votre application est en ligne
https://<votre-sous-domaine>.squareweb.app dans votre navigateur, vous devriez voir votre application répondre. Si vous avez déployé un bot, envoyez-lui une commande pour confirmer qu’il est en ligne.
Tester le bot
Après le déploiement, vérifiez les logs de l’application dans le tableau de bord Square Cloud pour repérer le messageBot successfully initialized! confirmant que le bot s’est authentifié correctement. Ensuite, depuis un autre compte, publiez un tweet qui mentionne le bot avec !ping (par exemple @your_bot !ping) et vérifiez qu’il répond avec Pong! 🤖 X Bot working correctly! sur X en quelques minutes. Les mentions publiées avant le démarrage du bot sont ignorées.
Erreurs courantes
Request failed with code 401
Les logs affichentError verifying bot: suivi de cette erreur. L’un des quatre identifiants est incorrect ou absent. Copiez-les à nouveau depuis la section « Keys and tokens », définissez les quatre variables et redémarrez le bot.
Request failed with code 403 lors d’une réponse
Le bot s’authentifie mais ne peut pas publier. Les jetons d’accès ont été générés alors que l’app avait une permission en lecture seule. Choisissez « Read and write » dans les permissions de l’app, régénérez l’Access Token et le Secret, mettez à jourACCESS_TOKEN et ACCESS_TOKEN_SECRET et redémarrez le bot.
Request failed with code 429
Le bot a atteint une limite de débit de l’API X. Attendez avant la requête suivante et espacez vos appels comme dans Limitation de débit.Aller plus loin
Les extraits ci-dessous complètentindex.js : ajoutez-les au fichier et appelez-les là où votre bot en a besoin.

