La tâche : des messages privés sur X, en entrée et en sortie, depuis votre propre code et sous votre propre application X — de sorte que X vous facture l'usage et que chaque appel agit uniquement comme votre compte.
1. Créez l'application X
Sur console.x.com, donnez à l'application les autorisations « Read and write » et « Direct message », et achetez-lui des crédits. Copiez ensuite quatre clés depuis « Keys and tokens » : la clé d'API et son secret, ainsi que le jeton d'accès et son secret du compte avec lequel vous allez écrire — créés après la définition des autorisations, sinon ils ne les porteront pas.
2. Connectez-la une seule fois
curl -X PUT https://makehybrid.com/x/v1/connection \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
-d '{"api_key":"…","api_secret":"…","access_token":"…","access_secret":"…"}'
Les clés sont vérifiées auprès de X et conservées scellées ; elles ne sont jamais réaffichées. Se connecter indique aussi à X d'envoyer ici les messages de votre compte.
3. Envoyez
curl -X POST https://makehybrid.com/x/v1/messages \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
-d '{"to":"@pat","text":"Thanks for reaching out!"}'
4. Recevez les réponses
curl -X POST https://makehybrid.com/x/v1/webhooks/endpoints \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
-d '{"url":"https://acme.com/hooks/x","events":["x.message_received"]}'
X décide qui peut recevoir un message de votre compte. Si quelqu'un n'accepte pas les messages venant de vous, la réponse est le refus de X, et aucune nouvelle tentative n'y change rien.
Questions fréquentes
Et les messages chiffrés de X Chat ?
Ajoutez votre PIN de X Chat sous le nom chat_pin à la connexion, et les messages des conversations X Chat sont lus et écrits chiffrés. X n'autorise que quelques PIN erronés ; un PIN refusé n'est donc pas réessayé tant que vous n'en envoyez pas un nouveau.
Est-ce la même connexion que celle du canal X d'une salle de projet ?
Oui. Connectez-la à l'un ou l'autre endroit et les deux l'ont.