Checklist de pré-vol pour la vérification SMS bolivienne (+591)

Que faut-il cocher sur la checklist avant de commander un numéro +591 ?

La plupart des tests échoués pour la Bolivie remontent à quelque chose qui n'a jamais été configuré, et non à la route elle-même. Cochez d'abord ces points :

• Une clé d'API au préfixe or_live_, créée dans la console Développeur et stockée comme secret dans votre CI ou la configuration de votre application. Une clé par environnement garde des journaux lisibles.
• Un point de terminaison de webhook qui répond vite en HTTPS, avec son secret de signature chargé. L'interrogation fonctionne aussi, mais décidez lequel des deux votre banc de test utilise.
• Des fonds sur le portefeuille pour l'exécution, ou un compte sandbox si vous n'avez besoin que d'exercer la plomberie.
• L'identifiant du service de l'application testée, tiré de GET /api/v1/services, ainsi que l'identifiant de pays de la Bolivie, bo.
• Un analyseur de numéros de téléphone dans votre produit qui accepte une saisie +591, afin que le numéro reçu puisse réellement être saisi dans le formulaire d'inscription.

Si un élément manque, corrigez-le avant de dépenser la moindre activation.

Quelles applications puis-je acheminer actuellement via la Bolivie ?

La liste en direct de la Bolivie couvre plus de 1 700 services. Parmi ceux que les équipes demandent le plus : WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Uber, Microsoft & Outlook, Discord, LinkedIn, Viber, Signal et AliExpress.

Cette étendue compte pour un marché comme la Bolivie, où une application grand public s'appuie souvent sur une connexion via une messagerie, tandis qu'un produit de livraison ou de VTC exige sa propre vérification téléphonique. Considérez la liste ci-dessus comme un instantané : la disponibilité de chaque service varie au fil de la journée, ce qui explique précisément pourquoi le point de terminaison des prix la renvoie en direct plutôt qu'une page statique.

Comment exécuter pas à pas le flux de l'API OTP pour la Bolivie ?

Chaque appel va vers https://otproute.com/api/v1 avec votre clé Bearer, et la limite du compte est de 300 requêtes par minute.

1. Récupérez le prix et la disponibilité actuels avec GET /api/v1/prices?country=bo&service=<id>. Ignorez la commande si la route est vide pour le moment.
2. Créez l'activation : POST /api/v1/activations avec {"service": "<id>", "country": "bo"}. Conservez l'identifiant d'activation et le numéro renvoyé.
3. Saisissez le numéro dans l'écran d'inscription ou de connexion de l'application testée.
4. Attendez le webhook activation.sms_received, ou interrogez GET /api/v1/activations/{id} à intervalle raisonnable.
5. Si le test est abandonné, appelez POST /api/v1/activations/{id}/cancel afin que la somme bloquée retourne aussitôt sur le portefeuille.

Vérifiez chaque webhook avant de lui faire confiance : l'en-tête X-OTPRoute-Signature contient t=<unix>,v1=<hex>, la valeur hexadécimale étant un HMAC-SHA256 de "<t>.<raw body>" avec le secret de votre point de terminaison. Rejetez les horodatages périmés. Le guide d'intégration de l'API OTP présente un gestionnaire complet.

Comment stocker et contrôler un numéro bolivien ?

Les numéros mobiles boliviens comptent huit chiffres après l'indicatif pays +591 et commencent généralement par 6 ou 7. Stockez-les en E.164, par exemple +591 suivi de ces huit chiffres, sans espaces, et normalisez tout ce qu'un utilisateur saisit avec des espaces locaux ou un zéro initial avant l'enregistrement.

L'espagnol est la langue dans laquelle arrive la plupart des messages de vérification, bien que la Bolivie reconnaisse aussi officiellement le quechua, l'aymara, le guarani et de nombreuses autres langues. Si votre produit propose une interface dans une langue autochtone, vérifiez que le modèle de SMS envoyé par votre propre backend s'affiche toujours correctement, car ce chemin est distinct de ce qu'envoient les applications tierces.

Les équipes viennent généralement vers la Bolivie pour un lancement régional dans les pays andins, pour la QA de localisation de parcours en espagnol, ou pour accompagner des clients qui se sont inscrits avec un numéro bolivien tout en vivant à l'étranger.

Existe-t-il un chemin par le tableau de bord pour ceux qui n'écrivent pas de code ?

Oui, et il suit la même logique de checklist. Une personne des opérations ou du support peut :

1. Se connecter via la page d'inscription avec un code envoyé par e-mail ou avec Google, et activer l'authentification à deux facteurs TOTP.
2. Ouvrir l'OTP Gateway, choisir le service puis la Bolivie ; le prix en direct s'affiche avant tout débit.
3. Copier le numéro dans l'application et garder l'onglet du tableau de bord ouvert. Le code y apparaît dès que le SMS arrive.

C'est pratique pour une vérification ponctuelle d'un écran de connexion en production sans toucher à l'intégration.

Que dépanner quand un code bolivien n'apparaît jamais ?

Passez en revue ces points dans l'ordre :

• Laissez la fenêtre courir. Une activation reste ouverte 20 minutes ; la fermer plus tôt gaspille la tentative.
• Vérifiez les règles propres à l'application. Certains services rejettent catégoriquement les numéros virtuels, et le remboursement existe précisément pour ce cas.
• Réessayez plus tard, ou essayez une autre route. Le stock évolue au cours de la journée : une deuxième tentative une heure plus tard peut se comporter différemment.
• Ne recommandez pas en boucle serrée. Des répétitions rapides sur un même service tendent à aggraver les choses et à encombrer vos journaux.

Si aucun SMS n'arrive avant la fermeture de la fenêtre, le montant intégral retourne automatiquement sur le portefeuille. D'autres schémas figurent dans l'article sur la réduction des échecs de livraison OTP.

Puis-je garder une ligne bolivienne à long terme, et comment fonctionne la facturation ?

Il n'existe pas de numéro à long terme en libre-service pour la Bolivie. OTP Route ne vend des Dedicated Virtual Numbers qu'aux États-Unis et au Canada, à partir de $1.95/mois ; si votre équipe a besoin d'une ligne bolivienne durable, écrivez à [email protected] et l'équipe vous dira si quelque chose est possible selon la réglementation locale, sans aucune promesse.

La facturation passe par un seul portefeuille prépayé en USD, sans frais mensuels ni formule à choisir. Rechargez par carte ou en USDT/USDC, et une facture PDF arrive par e-mail pour chaque recharge. Pour le travail d'intégration, demandez le mode sandbox, qui renvoie des numéros et des codes simulés sans dépenser de fonds. Les tarifs complets figurent sur la page des tarifs.

Questions fréquentes

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

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

Quel est l'identifiant de la Bolivie dans l'API OTP Route ?

Utilisez bo à la fois dans la requête de prix et dans le corps de l'activation.

Dois-je payer si le SMS bolivien n'arrive jamais ?

Non. Si rien n'arrive en 20 minutes, ou si vous annulez avant, le montant retourne automatiquement sur votre portefeuille.

Dans quelle langue seront les SMS de vérification boliviens ?

Généralement en espagnol, bien que la formulation soit fixée par chaque application et puisse suivre la langue du compte ou de l'appareil.

Un pipeline QA peut-il utiliser ce numéro +591 pour tester chaque nuit ?

Chaque activation couvre un seul code : une tâche nocturne commande donc un nouveau numéro à chaque exécution. Consultez les tests de SMS OTP dans les pipelines CI pour des schémas.

Un numéro bolivien convient-il à des comptes qui doivent se reconnecter des mois plus tard ?

Pas vraiment, car les numéros à usage unique ne sont pas conservés. Pour des comptes de longue durée, un Dedicated Number américain ou canadien convient mieux.

Existe-t-il des règles sur ce que je peux vérifier avec un numéro de vérification bolivien ?

Oui. Utilisez-le uniquement pour vos propres produits et comptes professionnels légitimes, respectez les conditions de chaque service, et rappelez-vous que la politique d'utilisation acceptable d'OTP Route s'applique.

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.