Recevoir des codes SMS du Botswana grâce à un appel d'API

Quels appels d'API composent une activation au Botswana ?

Tout se trouve sous https://otproute.com/api/v1 et s'authentifie avec une clé Bearer commençant par or_live_. Vous créez les clés dans la console développeur ; un compte peut en détenir jusqu'à 10, et la limite est de 300 requêtes par minute, ce qui suffit largement à une suite de tests qui commande une poignée de numéros du Botswana par exécution.

Une séquence typique ressemble à ceci :

1. Appelez GET /api/v1/countries une fois et mettez-le en cache, afin que votre code sache que bw est l'identifiant du Botswana.
2. Demandez à GET /api/v1/prices?country=bw&service=whatsapp le prix et la disponibilité en direct du couple dont vous avez besoin. Les prix varient selon le service et le pays : lisez-les au lieu de les coder en dur.
3. Envoyez POST /api/v1/activations avec le corps {"service": "whatsapp", "country": "bw"}. La réponse contient le numéro +267 et un identifiant d'activation.
4. Saisissez ce numéro dans le formulaire d'inscription testé, puis interrogez GET /api/v1/activations/{id} ou attendez un webhook.
5. Si le test est interrompu, appelez POST /api/v1/activations/{id}/cancel pour que les fonds retournent aussitôt au portefeuille.

Le guide d'intégration de l'API OTP reprend les mêmes appels en insistant sur la gestion des erreurs.

Comment mon récepteur de webhooks doit-il traiter les événements +267 ?

Les webhooks sont le choix le plus propre dès que plusieurs tests s'exécutent en parallèle. Enregistrez un endpoint (cinq par compte) et écoutez activation.sms_received, activation.expired et activation.cancelled, chacun indexé sur l'identifiant d'activation obtenu à la commande.

Chaque livraison porte un en-tête X-OTPRoute-Signature de la forme t=<unix>,v1=<hex>. Reconstruisez le HMAC-SHA256 de la chaîne "<t>.<raw body>" avec le secret du endpoint, comparez-le à v1 en temps constant et rejetez tout ce dont l'horodatage est périmé. N'analysez le JSON qu'une fois la vérification réussie, car resérialiser le corps modifie les octets.

Rendez le gestionnaire idempotent : enregistrez l'identifiant d'activation quand le code est consommé et ignorez la répétition du même événement. Les détails figurent dans sécuriser les webhooks OTP avec HMAC.

À quoi peut servir un numéro de vérification du Botswana ?

Le relevé en direct pour le Botswana répertorie plus de 800 services. Parmi les plus populaires : WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, ChatGPT (OpenAI), Microsoft & Outlook, Amazon, LinkedIn, Uber, Signal, Netflix et Airbnb.

La disponibilité d'une route donnée évolue dans la journée selon la capacité des opérateurs. C'est la raison pour laquelle l'endpoint des prix indique aussi ce qui est commandable à l'instant : considérez sa réponse comme la source de vérité plutôt que cette liste.

Que doivent savoir les ingénieurs sur les numéros de téléphone du Botswana ?

Le Botswana utilise l'indicatif +267 et n'a pas de préfixe interurbain : le numéro national se compose tel qu'il s'écrit. Les numéros mobiles comptent huit chiffres et commencent par 7. En E.164, cela donne +267 suivi des huit chiffres, sans zéro à supprimer.

Quelques points pratiques pour qui stocke ou valide ces numéros :

• Normalisez tout en E.164 à la saisie. Les utilisateurs peuvent taper 00267, des espaces ou un plus initial ; ramenez-les tous à une forme canonique avant de comparer ou de dédoublonner.
• Ne réutilisez pas la règle de préfixe interurbain d'un marché voisin. Un validateur copié d'un pays qui supprime un zéro initial rejettera des saisies valides du Botswana.
• L'anglais et le setswana sont les principales langues. Les codes d'applications mondiales arrivent généralement en anglais, mais votre analyseur doit extraire les chiffres par motif plutôt que de s'appuyer sur une formulation fixe.

Les équipes testent ici lorsqu'elles lancent un produit en Afrique australe, vérifient l'onboarding de clients situés de l'autre côté de la frontière avec l'Afrique du Sud, ou gèrent des opérations régionales qui exigent un numéro +267 local pour les tests.

Un non-développeur peut-il commander un code du Botswana depuis le tableau de bord ?

Oui. Inscrivez-vous avec votre adresse e-mail et un code à six chiffres (ou Google), alimentez le portefeuille, puis ouvrez l'OTP Gateway, choisissez le Botswana et le service, vérifiez le prix affiché et commandez. Collez le numéro dans l'application testée ; le code apparaît dans le tableau de bord dès que le SMS atteint la route.

Chaque activation reste ouverte 20 minutes. Si aucun message n'arrive dans ce délai, ou si vous annulez avant, le montant total retourne automatiquement dans votre portefeuille.

Et si le code du Botswana n'arrive jamais ?

La vitesse de livraison dépend du service et de la route ; laissez donc du temps à la fenêtre avant d'agir. Si elle se ferme à vide, passez en revue cette liste :

• Réessayez un peu plus tard, ou choisissez la route d'un autre service pour le même parcours si votre produit le permet.
• Vérifiez que l'application à l'autre bout accepte d'envoyer un SMS à une ligne virtuelle ; quelques applications refusent ces numéros, et c'est précisément pourquoi les activations inutilisées reviennent sur votre solde.
• Laissez la fenêtre de 20 minutes aller à son terme au lieu d'annuler après une minute.
• Évitez de recommander en boucle serrée depuis la CI ; ajoutez un délai croissant entre les tentatives.

D'autres schémas figurent dans réduire les échecs de livraison OTP. Quoi que vous testiez, respectez les conditions de chaque service ; la politique d'utilisation acceptable d'OTP Route s'applique à chaque commande.

Existe-t-il une ligne +267 longue durée, et comment la facturation fonctionne-t-elle ?

Pas en tant que produit en libre-service. Les Numéros dédiés ne sont vendus instantanément qu'aux États-Unis et au Canada, à partir de $1.95/mois ; pour le Botswana, vous pouvez écrire à [email protected] pour demander, et la disponibilité dépend de la réglementation locale. Consultez les numéros virtuels pour savoir ce que comprennent les lignes américaines et canadiennes.

La facturation repose sur un seul portefeuille prépayé en USD, sans abonnement mensuel, alimenté par carte ou en USDT/USDC, et chaque recharge s'accompagne d'une facture PDF par e-mail. Pour le travail d'intégration, un compte de développement peut passer en sandbox sur demande, de sorte que tout le flux s'exécute sur des numéros et des codes simulés. Les tarifs actuels figurent sur la page des tarifs.

Questions fréquentes

Quel est l'identifiant de pays du Botswana dans l'API OTP Route ?

C'est bw. Passez-le comme country dans POST /api/v1/activations et dans la chaîne de requête de GET /api/v1/prices.

Puis-je tester le parcours d'inscription de mon application au Botswana sans carte SIM locale ?

Oui. Commandez un numéro +267 pour le service de votre application via l'OTP Gateway et lisez le code dans le tableau de bord ou sur votre webhook, sans carte SIM ni téléphone.

Les numéros du Botswana nécessitent-ils un zéro initial lors du stockage ?

Non. Le Botswana n'a pas de préfixe interurbain : stockez le numéro sous la forme +267 plus le numéro mobile à huit chiffres.

Suis-je facturé si le code +267 n'arrive pas ?

Non. Si rien n'arrive dans la fenêtre de 20 minutes, ou si vous annulez, le montant total retourne automatiquement dans votre portefeuille.

Puis-je conserver un numéro du Botswana pour de futures connexions ?

Il n'existe pas de numéro longue durée en libre-service pour le Botswana. Les lignes longue durée sont un produit américain et canadien ; écrivez à [email protected] si vous souhaitez vous renseigner sur d'autres options.

Puis-je exécuter les tests du Botswana en CI sans dépenser les fonds du portefeuille ?

Demandez que votre compte de développement passe en sandbox. Il renvoie des numéros et des codes simulés : le chemin complet de l'API et des webhooks peut ainsi être exercé sans frais.

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.