Checklist pre-volo per la verifica SMS in Bolivia (+591)

Cosa deve esserci nella checklist prima di ordinare un numero +591?

La maggior parte dei test falliti per la Bolivia dipende da qualcosa che non era mai stato configurato, non dalla rotta in sé. Spunta prima questi punti:

• Una chiave API con il prefisso or_live_, creata nella Developer console e salvata come secret nella configurazione di CI o dell'app. Una chiave per ambiente mantiene leggibili i log.
• Un endpoint webhook che risponde in fretta via HTTPS, con il secret di firma caricato. Anche il polling funziona, ma decidi quale dei due usa il tuo harness.
• Fondi nel wallet per l'esecuzione, oppure un account sandbox se devi solo esercitare l'impianto.
• L'id del servizio per l'app che stai testando, preso da GET /api/v1/services, più l'id paese della Bolivia, bo.
• Un parser di numeri di telefono nel tuo prodotto che accetti input +591, così il numero ricevuto può davvero essere digitato nel modulo di registrazione.

Se manca anche uno solo di questi punti, risolvilo prima di spendere una singola attivazione.

Quali app posso instradare oggi attraverso la Bolivia?

L'elenco live per la Bolivia copre più di 1.700 servizi. Tra quelli che i team richiedono di più ci sono WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Uber, Microsoft & Outlook, Discord, LinkedIn, Viber, Signal e AliExpress.

Questa ampiezza conta in un mercato come la Bolivia, dove un'app consumer spesso si affida a un login tramite messaggistica mentre un prodotto di consegne o di ride-hailing richiede una propria verifica telefonica. Considera l'elenco qui sopra un'istantanea: la disponibilità per servizio cambia nel corso della giornata, ed è proprio per questo che l'endpoint dei prezzi la riporta in tempo reale invece di una pagina statica.

Come eseguo passo dopo passo il flusso dell'API OTP per la Bolivia?

Ogni chiamata va a https://otproute.com/api/v1 con la tua chiave Bearer e il limite dell'account è di 300 richieste al minuto.

1. Recupera prezzo e disponibilità correnti con GET /api/v1/prices?country=bo&service=<id>. Salta l'ordine se la rotta è vuota in questo momento.
2. Crea l'attivazione: POST /api/v1/activations con {"service": "<id>", "country": "bo"}. Salva l'id dell'attivazione e il numero restituito.
3. Inserisci il numero nella schermata di registrazione o di accesso dell'app in test.
4. Attendi il webhook activation.sms_received, oppure fai polling su GET /api/v1/activations/{id} con un intervallo tranquillo.
5. Se il test viene abbandonato, chiama POST /api/v1/activations/{id}/cancel così l'importo trattenuto torna subito sul wallet.

Verifica ogni webhook prima di fidarti: l'intestazione X-OTPRoute-Signature contiene t=<unix>,v1=<hex>, dove l'esadecimale è un HMAC-SHA256 di "<t>.<raw body>" calcolato con il secret del tuo endpoint. Rifiuta i timestamp obsoleti. La guida all'integrazione dell'API OTP illustra un handler completo.

Come va salvato e controllato un numero boliviano?

I numeri di cellulare boliviani hanno otto cifre dopo il prefisso +591 e di solito iniziano con 6 o 7. Salvali in E.164, per esempio +591 seguito da quelle otto cifre, senza spazi, e normalizza ciò che l'utente digita con spaziature locali o uno zero iniziale prima di salvarlo.

Lo spagnolo è la lingua in cui arrivano la maggior parte dei messaggi di verifica, anche se la Bolivia riconosce ufficialmente pure quechua, aymara, guaraní e molte altre lingue. Se il tuo prodotto offre un'interfaccia in una lingua indigena, controlla che il modello di SMS inviato dal tuo backend venga ancora visualizzato correttamente, dato che quel percorso è separato da ciò che inviano le app di terze parti.

I team di solito arrivano in Bolivia per un lancio regionale nei paesi andini, per il QA di localizzazione dei flussi in spagnolo o per assistere clienti che si sono registrati con un numero boliviano mentre vivevano all'estero.

Esiste un percorso dalla dashboard per chi non scrive codice?

Sì, e segue la stessa logica della checklist. Una persona di operations o supporto può:

1. Accedere da /signup con un codice via email o Google e attivare l'autenticazione a due fattori TOTP.
2. Aprire l'OTP Gateway, scegliere il servizio e poi la Bolivia; il prezzo aggiornato appare prima che venga addebitato qualsiasi importo.
3. Copiare il numero nell'app e tenere aperta la scheda della dashboard. Il codice vi compare quando l'SMS arriva.

È comodo per un controllo una tantum della schermata di accesso in produzione senza toccare l'integrazione.

Cosa verificare quando un codice boliviano non compare?

Procedi in quest'ordine:

• Lascia scorrere la finestra. Un'attivazione resta aperta per 20 minuti; chiuderla prima spreca il tentativo.
• Controlla le regole dell'app. Alcuni servizi rifiutano del tutto i numeri virtuali, e il rimborso esiste proprio per questo caso.
• Riprova più tardi, o prova un'altra rotta. La disponibilità cambia durante la giornata, quindi un secondo tentativo un'ora dopo può comportarsi diversamente.
• Non riordinare in un ciclo serrato. Ripetizioni rapide sullo stesso servizio tendono a peggiorare le cose e a ingombrare i log.

Se nessun SMS arriva prima della chiusura della finestra, l'intero importo torna automaticamente sul wallet. Altri schemi sono in ridurre i recapiti OTP falliti.

Posso tenere una linea boliviana a lungo termine e come funziona la fatturazione?

Per la Bolivia non esiste un numero a lungo termine in self-service. OTP Route vende i Dedicated Virtual Numbers solo negli Stati Uniti e in Canada, da $1.95/month; se il tuo team ha bisogno di una linea boliviana duratura, scrivi a [email protected] e il team ti dirà se è possibile qualcosa nel rispetto delle normative locali, senza alcuna promessa.

La fatturazione avviene con un unico wallet prepagato in USD, senza canone mensile e senza piani da scegliere. Ricarica con carta o con USDT/USDC e per ogni ricarica arriva una fattura PDF via email. Per il lavoro di integrazione, chiedi la modalità sandbox, che restituisce numeri e codici simulati senza spendere fondi. Le tariffe complete sono su /pricing.

Domande frequenti

Posso testare il flusso di registrazione boliviano della mia app senza una SIM locale?

Sì. Ordina un numero +591 per il tuo servizio dall'OTP Gateway, inseriscilo nella tua app e leggi il codice nella dashboard o tramite API.

Qual è l'id paese della Bolivia nell'API di OTP Route?

Usa bo sia nella query dei prezzi sia nel corpo dell'attivazione.

Pago se l'SMS boliviano non arriva?

No. Se non arriva nulla entro 20 minuti, o se annulli prima, l'importo torna automaticamente sul tuo wallet.

In che lingua saranno i messaggi di verifica boliviani?

Di solito in spagnolo, anche se la formulazione è decisa da ciascuna app e può seguire la lingua dell'account o del dispositivo.

Una pipeline di QA può usare questo numero +591 per i test ogni notte?

Ogni attivazione copre un solo codice, quindi un job notturno ordina un numero nuovo a ogni esecuzione. Vedi test OTP via SMS nelle pipeline CI per alcuni schemi.

Un numero boliviano è adatto ad account che devono accedere di nuovo mesi dopo?

Non proprio, perché i numeri monouso non vengono conservati. Per account di lunga durata, un Dedicated Number statunitense o canadese è la scelta migliore.

Ci sono regole su cosa posso verificare con un numero di verifica della Bolivia?

Sì. Usalo solo per i tuoi prodotti e account aziendali legittimi, rispetta i termini di ciascun servizio e ricorda che si applica l'Acceptable Use Policy di OTP Route.

I nomi dei servizi sono marchi dei rispettivi proprietari. OTP Route non è affiliata a essi. Usa i numeri in modo lecito e rispetta i termini di ciascun servizio e la nostra Politica di Utilizzo Accettabile.