Verificare le registrazioni +387 quando nessuno del team ha una SIM bosniaca

Il nostro rilascio richiede un test +387, ma la SIM è in un cassetto a Sarajevo. E ora?

È un vincolo comune per i team che pubblicano per i Balcani occidentali. Il product manager vuole la prova che gli utenti bosniaci possano registrarsi, il responsabile QA ha una voce in checklist che dice "verifica con un numero locale" e l'unica SIM +387 fisica appartiene a un collega che se n'è andato la scorsa primavera.

I motivi più comuni per cui un team si ritrova in questa situazione:

• Un lancio regionale che copre Bosnia ed Erzegovina insieme a Croazia, Serbia e Montenegro, dove il percorso di registrazione di ogni mercato richiede un controllo a sé.
• Clienti della diaspora. Molte persone che vivono in Germania, Austria, Svezia e altrove mantengono ancora un numero +387, quindi un prodotto fintech o affine alle telecomunicazioni può vedere numeri bosniaci di utenti che durante l'onboarding non hanno mai messo piede nel paese.
• QA di localizzazione. Bosniaco, croato e serbo sono tutte lingue ufficiali e nell'uso quotidiano compaiono sia l'alfabeto latino sia quello cirillico, quindi testi e validazione dei moduli meritano un vero passaggio end-to-end.

Invece di spedire SIM in giro, OTP Route gestisce l'OTP routing per te: l'OTP Gateway ti assegna un numero +387 per una singola verifica e ti restituisce l'SMS in arrivo tramite una API di verifica SMS che il tuo harness di test può chiamare.

Quali app e piattaforme possono inviare codici a un numero di verifica bosniaco?

La copertura è un'istantanea live, quindi consideralo un punto di partenza e non un menu fisso. Al momento della scrittura, le rotte per Bosnia ed Erzegovina includono Viber, WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Signal, Microsoft & Outlook, LinkedIn, Discord, Uber, Amazon ed eBay.

In totale il paese conta più di 1.600 servizi. Se ti serve un numero di verifica di Bosnia ed Erzegovina per un servizio non indicato qui, controlla prima l'elenco live. Viber conta più nei Balcani che in molte altre regioni, un dettaglio da ricordare se il tuo prodotto invia codici anche tramite canali di messaggistica oltre che via SMS. Poiché la disponibilità cambia durante la giornata, chiedi all'API le opzioni correnti invece di scrivere un elenco nel codice della tua suite di test.

Come procede, chiamata per chiamata, il flusso dell'API OTP di Bosnia ed Erzegovina?

Per i test sulla Bosnia, punta il tuo client a https://otproute.com/api/v1 e passa una chiave or_live_ come token Bearer. Le chiavi si creano nella Developer console; un account può avere fino a 10 chiavi e 5 endpoint webhook, con un tetto di 300 richieste al minuto.

1. Chiama una sola volta GET /api/v1/services e GET /api/v1/countries, metti in cache gli id e conferma che ba sia presente.
2. Controlla il costo con GET /api/v1/prices?country=ba&service=<id> così il tuo job registra nei log l'importo esatto prima di spendere.
3. Invia POST /api/v1/activations con {"service": "<id>", "country": "ba"}. La risposta contiene l'id dell'attivazione e il numero +387 da digitare nell'app in test.
4. Attendi il webhook activation.sms_received, oppure fai polling su GET /api/v1/activations/{id} a intervalli moderati se il tuo runner non può accettare traffico in ingresso.
5. Se il test viene interrotto, rilascia il numero con POST /api/v1/activations/{id}/cancel così i fondi tornano subito.

Per i webhook, leggi l'intestazione X-OTPRoute-Signature (t=<unix>,v1=<hex>), calcola l'HMAC-SHA256 su <t>.<raw body> con il secret dell'endpoint, confronta in tempo costante e scarta i timestamp obsoleti. Poiché gli eventi sono identificati dall'id dell'attivazione, un codice +387 consegnato due volte va scritto una sola volta. La guida all'integrazione dell'API OTP approfondisce tentativi ripetuti e gestione degli errori.

Esiste un modo senza codice per il team di supporto o operations?

Sì. Chi non ha accesso all'API può fare la stessa cosa dal browser: accede, apre l'OTP Gateway, sceglie Bosnia ed Erzegovina e il servizio, legge il prezzo e conferma. Il numero compare a schermo e il codice appare accanto a esso quando l'SMS viene ricevuto. Va bene per un operatore di supporto che riproduce il problema di registrazione di un cliente o per un responsabile operations che controlla un portale partner dopo un cambio di telefono.

Come vanno salvati i numeri +387 e analizzato il testo degli SMS bosniaci?

A livello nazionale, i numeri bosniaci si compongono con un prefisso interurbano 0 e i cellulari di solito iniziano con 06. In E.164 quello zero scompare: un numero scritto localmente come 061 seguito da sei cifre diventa +387 61 più quelle sei cifre. Salva solo la forma E.164, elimina spazi, trattini e barre in input e rifiuta tutto ciò che porta ancora lo zero iniziale dopo il prefisso internazionale.

I messaggi di verifica possono arrivare in inglese o in una delle lingue locali, ed è del tutto possibile un messaggio scritto in cirillico. Estrai il codice con uno schema di cifre invece di cercare una parola specifica, e assicurati che i tuoi log mantengano intatto l'UTF-8 in modo che segni diacritici come č, ć, š e ž non vengano rovinati quando fai il debug di un'esecuzione fallita.

E se un'esecuzione di test non riceve mai il codice?

Non viene addebitato nulla quando un codice non arriva. Se nessun SMS arriva entro 20 minuti, o se annulli prima, l'intero importo torna automaticamente sul wallet. In questo caso:

• Lascia che la finestra faccia il suo corso invece di riordinare subito; un SMS in ritardo conta comunque.
• Riprova un po' più tardi, oppure scegli un'altra rotta di servizio per lo stesso scenario.
• Verifica che il servizio di destinazione accetti numeri virtuali: alcuni li rifiutano, ed è proprio per questo che esiste il rimborso.
• Evita di ordinare in un ciclo serrato dalla CI, che consuma il rate limit senza migliorare le probabilità.

Ridurre i recapiti OTP falliti copre gli schemi che tendono ad aiutare.

Possiamo tenere una linea bosniaca a lungo termine e come funziona la fatturazione?

Non come prodotto self-service. I Dedicated Virtual Numbers, che si rinnovano dal wallet da $1.95/month, sono venduti istantaneamente solo per Stati Uniti e Canada. Se il tuo team ha davvero bisogno di una linea +387 a lungo termine, scrivi a [email protected]; la fattibilità dipende dalle normative locali e non c'è alcuna promessa che si possa organizzare.

La fatturazione del gateway avviene con un unico wallet prepagato in USD, senza canone mensile e senza piani da scegliere. I fondi si aggiungono con carta o con le stablecoin USDT/USDC; una fattura PDF per ogni deposito arriva nella tua casella di posta. Per il lavoro di integrazione, un account di sviluppo può essere passato in sandbox su richiesta, restituendo numeri e codici simulati così la tua pipeline gira senza toccare i fondi del wallet. Le tariffe aggiornate sono nella pagina dei prezzi e puoi creare un account con un codice via email o con l'accesso Google.

Domande frequenti

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

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

Quale id paese usa OTP Route per Bosnia ed Erzegovina?

L'id è ba. Passalo come campo country quando crei un'attivazione e come parametro di query country quando controlli i prezzi.

Pago se il codice +387 non arriva?

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

Devo mantenere lo zero iniziale quando salvo un cellulare bosniaco?

No. Salva i numeri in E.164, cioè +387 seguito dal numero senza lo zero interurbano nazionale.

Un numero +387 per i test è adatto a un account in cui dovremo accedere di nuovo il mese prossimo?

Non proprio, perché ogni numero del gateway copre una sola verifica. Per accessi ripetuti, un Dedicated Number statunitense o canadese è l'opzione self-service; per una linea bosniaca a lungo termine, chiedi al team via email.

Posso eseguire test OTP bosniaci in CI senza spendere denaro?

Sì, chiedendo la modalità sandbox su un account di sviluppo. Restituisce numeri e codici simulati, così l'intero flusso, webhook compresi, può essere provato gratuitamente.

Ci sono regole su come usare questi numeri?

Sì. Rispetta i termini di ciascun servizio, usa i numeri solo per i tuoi prodotti e account legittimi e ricorda che l'Acceptable Use Policy di OTP Route si applica a ogni ordine.

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.