Recevoir des codes SMS X (Twitter) : une checklist pour les équipes produit et QA

Pourquoi X demande-t-il un numéro de téléphone ?

X utilise les numéros de téléphone à quelques endroits bien connus : comme alternative à l'e-mail lors de l'inscription, lorsque vous ajoutez un numéro à un compte existant, lors des vérifications de connexion déclenchées par une activité qui paraît inhabituelle, pour la réinitialisation du mot de passe et pour l'authentification à deux facteurs par SMS. Au fil des ans, X a restreint les comptes pouvant utiliser le SMS comme second facteur et propose les applications d'authentification en option ; vérifiez donc les paramètres actuels du compte que vous testez. Chacun de ces parcours envoie un court code numérique, et chacun mérite d'être couvert si votre produit s'intègre à des comptes X ou les gère. Cas typiques : un outil de médias sociaux qui intègre des comptes de marque, une agence qui gère des profils clients depuis une connexion d'équipe partagée, et une suite QA qui vérifie le comportement de votre application après qu'un utilisateur a lié un profil X.

Checklist avant le départ pour tester la vérification SMS de X (Twitter)

• Propriété. Le compte vous appartient, ou appartient à votre entreprise ou à un client qui vous a demandé de le gérer. Un compte par personne réelle ou par entreprise.
• Conditions. Lisez les règles de X sur les numéros de téléphone et l'automatisation ; elles s'appliquent en plus de notre politique d'utilisation acceptable.
• Pays. Décidez quel marché le compte représente avant de commander.
• Identifiant de service. Sur OTP Route, l'identifiant du service X est twitter.
• Plomberie. Une clé Bearer (or_live_) et soit une boucle d'interrogation, soit un endpoint de webhook.
• Durée de vie. Ce compte devra-t-il se reconnecter dans un mois ? Si oui, lisez la section sur la ligne dédiée avant de commencer.

Parmi les 198 pays, de quel pays doit venir le numéro ?

La route X couvre 198 pays, dont les États-Unis, le Canada, le Royaume-Uni, l'Allemagne, la France, l'Inde, l'Indonésie, les Philippines, le Japon, le Brésil, le Mexique, la Turquie, l'Arabie saoudite, le Kenya, le Nigeria et le Ghana. Faites correspondre le numéro au marché que sert le compte ou au cas de test que vous démontrez : un compte de marque régional doit porter un numéro de sa région, et un test de localisation exige la langue et le format de numéro de ce pays. Un décalage entre le numéro, la localisation IP et le profil est aussi le genre de signal qui peut déclencher des contrôles supplémentaires du côté de X.

Étapes : commander un numéro pour X via l'API

URL de base : https://otproute.com/api/v1.

1. Consultez le prix de votre couple avec GET /api/v1/prices?country=<id>&service=twitter, ce qui confirme aussi la disponibilité en direct.
2. Créez la commande : POST /api/v1/activations avec {"service": "twitter", "country": "<id>"}. Enregistrez l'identifiant d'activation.
3. Saisissez le numéro renvoyé dans le champ de téléphone de X.
4. Récupérez le code depuis l'événement de webhook, ou interrogez GET /api/v1/activations/{id} jusqu'à son apparition.
5. Si X rejette le numéro, libérez-le avec POST /api/v1/activations/{id}/cancel.

Les identifiants de pays proviennent de GET /api/v1/countries ; la documentation de l'API présente la forme des requêtes et des réponses.

Comment construire le récepteur de webhook ?

Abonnez-vous à activation.sms_received, activation.expired et activation.cancelled. Chaque livraison porte X-OTPRoute-Signature: t=<unix>,v1=<hex> ; calculez un HMAC-SHA256 sur l'horodatage, un point et le corps brut avec le secret du endpoint, comparez en temps constant et refusez les horodatages anciens. Comme les livraisons peuvent se répéter, stockez les identifiants d'activation traités et ignorez les doublons. L'interrogation est un bon repli pour les petites suites, bien en deçà de 300 requêtes par minute. Le guide HMAC propose un exemple détaillé.

Vous préférez cliquer ? Dans le tableau de bord, ouvrez l'OTP Gateway, choisissez X et un pays, confirmez le prix affiché, collez le numéro dans X et regardez le code apparaître à côté de la commande.

Dépannage : X n'a pas envoyé de code

• Le numéro a été refusé. X peut refuser les numéros virtuels, parfois avec un message indiquant que le numéro ne peut pas être utilisé. Annulez, puis réessayez plus tard ou avec un autre pays.
• Rien n'est encore arrivé. Laissez la fenêtre de 20 minutes ouverte plutôt que de recommander immédiatement.
• X limite le débit. Des demandes répétées depuis un même compte peuvent déclencher les limites propres de X ; espacez les tentatives.
• Votre gestionnaire l'a perdu. Consultez vos journaux pour repérer les échecs de signature et les erreurs.
• Le compte est signalé. Si X a restreint le compte lui-même, un nouveau numéro n'y changera rien ; réglez cela par les canaux de support de X.

La règle de remboursement supprime le coût de l'échec : vous ne payez que si le code arrive, et les activations expirées ou annulées restituent la totalité du montant au portefeuille.

Quand une ligne dédiée américaine ou canadienne convient-elle mieux ?

Une activation à usage unique convient à une seule vérification. Un compte d'entreprise qui doit passer des contrôles de connexion ou récupérer l'accès dans plusieurs mois a besoin d'un numéro qui reste en place. Les Numéros dédiés vous l'offrent aux États-Unis et au Canada, à partir de $1.95/mois : SMS entrants dans le tableau de bord et sur votre webhook via number.sms_received, SMS sortants et appels depuis le navigateur. Comparez les deux sur numéros virtuels. OTP Route facture tout depuis un seul portefeuille prépayé, rechargé par carte ou en USDT/USDC, avec des factures PDF.

Questions fréquentes

Quel est l'identifiant du service X (Twitter) dans l'API OTP Route ?

C'est twitter. Utilisez-le dans la requête de prix et dans le corps de l'activation.

Puis-je recevoir un code OTP X sans carte SIM ?

Oui, sur un numéro OTP Gateway dans n'importe lequel des 198 pays, affiché dans le tableau de bord ou envoyé à votre webhook.

Pourquoi X a-t-il indiqué que mon numéro de téléphone ne peut pas être utilisé ?

X peut refuser certains numéros virtuels. Annulez l'activation pour être remboursé et essayez un autre pays ou un autre moment.

Combien coûte un code de vérification X ?

À partir de $0.20 par code ; le prix exact dépend du pays et s'affiche avant la commande.

Puis-je réutiliser le même numéro pour une connexion X plus tard ?

Une activation à usage unique reçoit un seul code. Pour des connexions répétées, utilisez un numéro dédié américain ou canadien.

Puis-je utiliser OTP Route pour créer de nombreux comptes X ?

Non. Il sert à tester et à exploiter vos propres comptes et produits légitimes, dans le respect des conditions de X.

Existe-t-il un sandbox pour développer l'intégration ?

Oui. Sur demande, un compte de développement peut passer en sandbox et renvoyer des numéros et des codes simulés.

Les noms de services sont des marques déposées de leurs propriétaires respectifs. OTP Route n'est affilié à aucun d'entre eux. Utilisez les numéros de manière licite et respectez les conditions de chaque service ainsi que notre Politique d'utilisation acceptable.