Connecter X (Twitter) à Social Quack
Une application bien à vous dans la console de X, quelques dollars de crédit, et vos publications partent à l'heure dite — avec les clés chiffrées sur votre propre Mac.
X est la seule plateforme de Social Quack sur laquelle publier coûte de l'argent. Pour le reste, tout y est simple : vous créez votre propre petite application développeur, vous collez deux clés dans Social Quack, et vous approuvez la connexion sur la page de X. Une seule fois — le type de connexion qu'utilise X n'expire jamais, il n'y a donc rien à reconnecter au bout de quelques semaines.
Comme l'application est la vôtre, les clés restent chiffrées sur votre ordinateur et le quota de publication n'appartient qu'à vous. Vous ne partagez de réserve avec les comptes de personne : l'activité de quelqu'un d'autre ne peut donc pas vous faire brider.
1. Ce que ça coûte
X n'a plus d'offre gratuite pour publier. L'ancien accès Free (Standard Basic) est abandonné — une application restée dessus se fait refuser à chaque tentative de publication. Pour publier par l'API de X, il vous faut un compte développeur sur le forfait Pay Per Use, avec du crédit chargé. Une publication coûte quelques cents.
Charger 5 à 10 $ suffit largement pour démarrer. Cela ne concerne que X : Bluesky, Mastodon et les autres plateformes de Social Quack sont gratuites.
2. Ouvrir d'abord la fiche X dans Social Quack
Commencez par l'application, pour avoir déjà à l'écran la valeur que vous devrez copier :
Channels (canaux) dans la barre latérale → la fiche X (Twitter) → Set up app keys (configurer les clés de l'app).
(Une fois des clés enregistrées dans un workspace — un espace de travail —, ce bouton s'intitule Edit app keys (modifier les clés de l'app) : il ouvre le même panneau.)
Ce panneau contient les deux champs que vous remplirez à la fin et, au-dessus, l'URL de redirection que X appelle Callback URI, avec un bouton de copie à côté. Elle comprend le port sur lequel tourne votre exemplaire de Social Quack : prenez-la au bouton de copie plutôt que de la taper — X la rejette au moindre caractère de travers. Laissez cette fenêtre ouverte.
3. Créer un projet Pay Per Use et charger du crédit
- Rendez-vous sur https://console.x.com et ouvrez Projects. Il vous faut un projet sur le forfait Pay Per Use. Si vous n'avez qu'un vieux projet Free (Standard Basic), il ne fonctionne plus — prenez celui en Pay Per Use, ou créez-en un.
- Billing → Credits : chargez 5 à 10 $.
4. Créer l'application
Dans le projet Pay Per Use : Apps → Create App.
Vous avez déjà une application dans un ancien projet ? Vous pouvez la déplacer plutôt que d'en créer une, par Project Access → Manage.
5. Régler les permissions et l'URL de rappel
Ouvrez l'application → Settings, dans la section Authentication settings :
| Réglage | Ce qu'il faut y mettre |
|---|---|
| Permissions | Read and write |
| Type of App | Web App |
| Callback URI | l'URL de redirection que Social Quack affiche sur l'écran Set up app keys — servez-vous de son bouton de copie et collez-la telle quelle |
| Website | n'importe quelle URL |
Enregistrez. Faites-le avant l'étape suivante : des clés créées avant un changement de permissions gardent l'ancien niveau, et la connexion échoue alors une fois que vous avez approuvé chez X.
6. Copier l'API Key et le Secret
Application → Keys & Tokens → OAuth 1.0 Keys → Regenerate sur la Consumer Key, puis copiez les deux valeurs qui s'affichent :
- API Key (Consumer Key)
- API Key Secret (Consumer Secret)
Le secret n'est affiché qu'une seule fois. Si vous fermez la page sans l'avoir copié, régénérez simplement de nouveau — et régénérez chaque fois que vous modifiez les permissions de l'application.
Une régénération remplace l'ancienne paire partout : X signe chacune de vos publications avec ces clés, donc dès que vous régénérez, les anciennes sont mortes. Si vous les aviez collées dans plusieurs workspaces, ouvrez le panneau Set up app keys de chacun d'eux et collez-y aussi la nouvelle paire — l'enregistrement rouvre la page d'autorisation de X, et l'approuver reconnecte ce compte par-dessus, en conservant tout ce qu'il a en file d'attente. Un workspace resté sur les anciennes clés ne peut plus publier.
7. Les coller et se connecter
De retour dans Social Quack, sur ce même panneau Set up app keys : collez-les dans API Key (Consumer Key) et API Key Secret (Consumer Secret), puis cliquez sur Save (enregistrer). Il n'y a rien d'autre à presser — enregistrer les clés ouvre aussitôt la page d'autorisation de X dans votre navigateur. Approuvez-la pour le compte depuis lequel vous voulez publier. Le navigateur arrive alors sur une page Connected! qui vous invite à fermer l'onglet et à revenir dans Social Quack. Faites-le : le compte vous attend déjà sur la page Channels.
Une fois les clés enregistrées, le bouton Connect (connecter) de la fiche X déclenche à lui seul cette même autorisation — c'est celui à utiliser un autre jour, pour ajouter un deuxième compte ou en reconnecter un.
Vous pouvez connecter plusieurs comptes avec la même application : un par workspace, si vous tenez des marques distinctes. Chaque workspace garde sa propre copie des clés : basculez sur l'autre workspace dans la barre latérale et collez-y les deux mêmes valeurs dans son panneau Set up app keys — l'enregistrement y ouvre aussi la page d'autorisation. Une seule application chez X les couvre tous.
8. Ce que vous pouvez publier sur X
| Longueur d'une publication | 280 caractères |
| Fils | Oui — chaque partie part en réponse à la précédente |
| Images | Jusqu'à 4, sur la première publication d'un fil, avec texte alternatif |
| Vidéo | Oui |
Les photos plus lourdes que ce qu'accepte X, ou dans un format dont il ne veut pas, sont redimensionnées et converties pour vous avant de partir — vous n'avez rien à préparer.
Si quelque chose cloche
| Ce que vous voyez | Ce que ça veut dire | Quoi faire |
|---|---|---|
La publication échoue avec une 403 et client-not-enrolled |
L'application n'est pas dans un projet Pay Per Use — l'ancien accès gratuit ne fonctionne plus | Créez l'application à l'intérieur du projet Pay Per Use, ou déplacez-la vers celui-ci avec Project Access → Manage |
| X token exchange failed, sur une page Connection failed après votre approbation chez X | Le plus souvent, les clés ont été créées avant le changement de permissions de l'application : elles portent donc encore l'ancien niveau. Ce peut aussi être des clés venues d'une autre application, ou un secret tronqué à la copie | Keys & Tokens → OAuth 1.0 Keys → Regenerate, copiez de nouveau les deux valeurs, collez la nouvelle paire dans Set up app keys et cliquez sur Save — la page d'autorisation se rouvre |
| X users/me failed, sur cette même page Connection failed | L'application n'est rattachée à aucun projet disposant d'un accès à l'API | Vérifiez que l'application se trouve bien à l'intérieur de votre projet Pay Per Use |
| X API Key / Secret not configured | Ce workspace n'a aucune clé enregistrée — chacun garde sa propre copie | Basculez sur ce workspace dans la barre latérale, puis Channels → X → Set up app keys, collez les deux valeurs et cliquez sur Save |
| Les publications vers un compte X se mettent à échouer (X rejected the post, 401) après une régénération des clés | La nouvelle paire n'est allée que dans le workspace où vous vous trouviez ; les autres détiennent encore les anciennes clés, désormais mortes | Dans chacun des autres : Set up app keys, collez la nouvelle paire, Save, puis approuvez de nouveau chez X. Le compte se reconnecte par-dessus et ses publications en attente sont conservées — ne supprimez jamais le canal, cela effacerait ses publications |
| La page d'autorisation de X affiche une erreur, Social Quack en affiche une au lieu de l'ouvrir, ou vous atterrissez sur une page intitulée Connection failed | Le plus souvent, la Callback URI saisie chez X ne correspond pas à celle qu'affiche Social Quack | Recopiez l'URL de redirection depuis le panneau Set up app keys, collez-la dans Application → Settings → Callback URI, enregistrez, puis cliquez sur Connect sur la fiche X dans Social Quack |
| Le navigateur s'arrête sur une page Connected! et ne vous ramène nulle part | Rien d'anormal — Social Quack ouvre X dans votre navigateur habituel, et un navigateur ne sait pas sauter jusque dans l'application | Fermez l'onglet et revenez à Social Quack ; le compte est déjà sur la page Channels |
| Les publications se mettent à échouer au bout d'un moment, sans que rien n'ait changé chez vous | Votre crédit est épuisé — chaque publication coûte quelques cents | Billing → Credits, rechargez |
| La publication échoue avec une 429, ou une erreur en 500 | X vous bride, ou traverse un mauvais moment | Rien — Social Quack les tient pour temporaires et relance la publication de lui-même |
| Vous avez perdu l'API Key Secret | Il n'est jamais affiché qu'une fois | Regenerate sur la Consumer Key, collez la nouvelle paire dans Set up app keys et cliquez sur Save — dans chaque workspace qui utilise X, car l'ancienne paire cesse de fonctionner partout |
Toujours bloqué ? [email protected].