Choisir une route +55 pour la vérification SMS au Brésil

Un test pour le Brésil doit-il utiliser l'OTP Gateway ou une ligne à long terme ?

Partez de la forme du besoin, car c'est elle qui détermine le produit. Un test de vérification brésilien nécessite généralement un seul code, une seule fois : un écran d'inscription en portugais, un défi de connexion, une étape de changement de téléphone. C'est exactement ce pour quoi l'OTP Gateway est conçu. Vous choisissez un service et le Brésil, recevez un numéro +55 pour un seul code, et l'activation se clôt après 20 minutes ou à l'arrivée du SMS.

Une ligne à long terme, c'est une autre histoire. Les Dedicated Numbers sont un produit réservé aux États-Unis et au Canada, vendu instantanément depuis le tableau de bord à partir de $1.95/mois, avec SMS entrants, SMS sortants et appels depuis le navigateur. Il n'existe aucun numéro +55 à long terme en libre-service. Si votre équipe a vraiment besoin d'une ligne brésilienne durable, écrivez à [email protected] en décrivant le cas d'usage ; la faisabilité dépend de la réglementation locale, et rien n'est promis.

Une règle simple :

• Un code par cas de test, état neuf à chaque exécution : OTP Gateway avec br.
• Un compte de préproduction qui doit se reconnecter le mois prochain : un Dedicated Number américain ou canadien, si le service l'accepte.
• Dans le doute : lisez numéros temporaires et numéros dédiés avant d'acheter quoi que ce soit.

Quelles applications peuvent envoyer des codes à un numéro brésilien en ce moment ?

La route du Brésil couvre actuellement plus de 2 900 services, et les plus populaires dans le relevé en direct incluent WhatsApp, Telegram, Google (Gmail & YouTube), Instagram, Facebook, TikTok, Uber, Discord, Microsoft & Outlook, LinkedIn, Netflix, Airbnb, Shopee et AliExpress.

Considérez cette liste comme un instantané et non comme un contrat. La disponibilité évolue au cours de la journée, à mesure que nos opérateurs partenaires ajoutent et font tourner des routes : un pipeline doit donc interroger l'API plutôt que de se fier à une liste codée en dur. Le répertoire des pays affiche les mêmes données en direct pour ceux qui préfèrent un navigateur.

À quoi ressemble concrètement la séquence de l'API OTP pour le Brésil ?

Chaque appel va vers https://otproute.com/api/v1 avec une clé Bearer préfixée par or_live_, générée dans la console Développeur. L'identifiant de pays du Brésil est br.

1. Résolvez une fois les identifiants de services avec GET /api/v1/services et conservez-les dans la configuration.
2. Avant de commander, appelez GET /api/v1/prices?country=br&service=whatsapp (ou l'identifiant de votre service). La réponse contient le prix et la disponibilité en direct pour cette combinaison.
3. Créez l'activation avec POST /api/v1/activations et le corps {"service": "whatsapp", "country": "br"}. Conservez l'identifiant d'activation à côté de votre exécution de test.
4. Saisissez le numéro +55 dans le parcours que vous testez.
5. Écoutez l'événement activation.sms_received sur un webhook ; en solution de repli, consultez GET /api/v1/activations/{id} toutes les quelques secondes.
6. Si le test s'interrompt, libérez le numéro avec POST /api/v1/activations/{id}/cancel afin que les fonds reviennent immédiatement.

Les livraisons de webhook sont signées dans X-OTPRoute-Signature sous la forme t=<unix>,v1=<hex> : un HMAC-SHA256 de <t>.<raw body> avec le secret du point de terminaison. Vérifiez-le, rejetez les horodatages périmés et rendez le gestionnaire idempotent sur l'identifiant d'activation. La référence complète se trouve dans la documentation de l'API.

Quelqu'un de l'équipe growth peut-il faire cela sans code ?

Oui. Le tableau de bord exécute le même routage OTP sans aucun script :

1. Créez un compte avec votre e-mail et un code à 6 chiffres envoyé par e-mail, ou avec une connexion Google.
2. Ajoutez des fonds au portefeuille en USD.
3. Choisissez le Brésil et le service, vérifiez le prix affiché, puis commandez.
4. Collez le numéro +55 dans l'application et regardez le code apparaître sur la carte d'activation.

Les équipes marketing, support et relecture de localisation utilisent souvent cette voie pour confirmer qu'un écran d'accueil en portugais se comporte correctement avant une version, tandis que les ingénieurs gardent l'API pour les exécutions automatisées.

Comment stocker et normaliser les numéros +55 ?

Les numéros brésiliens comportent un indicatif régional à deux chiffres (DDD) suivi du numéro d'abonné, et les mobiles ont neuf chiffres commençant par 9. Au Brésil, on compose un 0 initial plus un code de sélection d'opérateur pour les appels longue distance, ce qui explique pourquoi la saisie des utilisateurs contient souvent des chiffres superflus qui n'ont pas leur place dans le stockage.

Stockez tout en E.164 : +55, l'indicatif régional, puis le numéro d'abonné, sans espaces, sans 0 initial et sans code d'opérateur. Normalisez à la saisie, comparez sur la valeur normalisée et ne formatez que pour l'affichage. Les codes des expéditeurs brésiliens arrivent généralement en portugais, parfois en anglais : analysez donc les chiffres plutôt que de chercher une phrase fixe.

Les équipes testent ce marché pour un lancement au Brésil, pour la QA de localisation en portugais et pour des parcours d'intégration qui s'accompagnent d'obligations au titre de la loi brésilienne sur la protection des données, la LGPD. Notre page intégration fintech couvre le volet vérification de ce travail.

Que faire si un code brésilien n'apparaît jamais ?

D'abord, laissez la fenêtre de 20 minutes courir ; certains expéditeurs sont plus lents que d'autres, et la livraison dépend du service et de la route. Si elle expire, le débit est annulé automatiquement et vous pouvez réessayer un peu plus tard ou sur une autre route proposée par l'API.

• Vérifiez que le service accepte bien les numéros virtuels. Certains ne les acceptent pas, et c'est précisément la raison d'être de la règle de remboursement.
• Ne recommandez pas en boucle serrée. Espacez les tentatives et consignez chaque identifiant d'activation.
• Vérifiez que votre application a envoyé le numéro sous sa forme internationale complète, et non dans un format local avec les chiffres de préfixe interurbain.

Le guide sur la réduction des échecs de livraison OTP recense d'autres diagnostics.

Comment s'articulent le portefeuille, les factures et le sandbox ?

OTP Route facture depuis un seul portefeuille prépayé en USD : paiement à l'usage, sans frais mensuels ni formule à choisir. Rechargez par carte ou en USDT ou USDC, et chaque recharge s'accompagne d'une facture PDF envoyée par e-mail. Les tarifs complets figurent sur la page des tarifs et dans l'API.

Pour le travail d'intégration, demandez au support de basculer un compte de développement en sandbox. Il renvoie des numéros et des codes simulés, ce qui vous permet d'exercer de bout en bout le chemin d'activation et de webhook sans toucher aux fonds du portefeuille. Utilisez-le uniquement pour vos propres produits, respectez les conditions de chaque service, et rappelez-vous que la politique d'utilisation acceptable s'applique à chaque compte.

Questions fréquentes

Puis-je tester le parcours d'inscription brésilien de mon application sans carte SIM locale ?

Oui. Commandez un numéro +55 auprès de l'OTP Gateway pour votre propre application ou un service pris en charge, saisissez-le dans le parcours, puis lisez le code dans le tableau de bord ou via l'API.

Quel est l'identifiant du Brésil dans l'API OTP Route ?

C'est br. Transmettez-le comme champ country lors de la création d'une activation, ou comme paramètre de requête country sur le point de terminaison des prix.

Suis-je débité si WhatsApp n'envoie jamais le code à mon numéro +55 ?

Non. Si aucun SMS n'atteint le numéro en 20 minutes, ou si vous annulez avant, le montant intégral retourne automatiquement sur votre portefeuille.

Puis-je acheter un numéro brésilien et le garder pendant des mois ?

Pas en libre-service. Les Dedicated Numbers à long terme ne sont vendus que pour les États-Unis et le Canada ; pour le Brésil, vous pouvez écrire à [email protected] pour vous renseigner, sans promesse de disponibilité.

Dois-je conserver le zéro initial d'un numéro brésilien ?

Non. Retirez le 0 interurbain et tout code de sélection d'opérateur, puis enregistrez le numéro en E.164, en commençant par +55 suivi de l'indicatif régional à deux chiffres.

Dans quelle langue sont les messages de vérification brésiliens ?

La plupart arrivent en portugais, et quelques services mondiaux envoient du texte en anglais. Extrayez le code numérique plutôt que de vous appuyer sur la formulation.

Puis-je essayer l'API avant d'alimenter le portefeuille ?

Demandez le mode sandbox sur un compte de développement. Il simule des numéros et des codes, de sorte que toute l'intégration peut être testée sans dépenser les fonds du portefeuille.

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.