Ricevere i codici SMS del Botswana con una chiamata API

Quali chiamate API attraversa un'attivazione per il Botswana?

Tutto si trova sotto https://otproute.com/api/v1 e si autentica con una chiave Bearer che inizia con or_live_. Le chiavi si creano nella Developer console; un account può averne fino a 10 e il limite è di 300 richieste al minuto, più che sufficienti per una suite di test che ordina una manciata di numeri del Botswana a ogni esecuzione.

Una sequenza tipica è questa:

1. Chiama GET /api/v1/countries una volta e metti in cache la risposta, così il tuo codice sa che bw è l'identificatore del Botswana.
2. Chiedi a GET /api/v1/prices?country=bw&service=whatsapp il prezzo live e la disponibilità dell'abbinamento che ti serve. I prezzi variano per servizio e paese, quindi leggili invece di scriverli nel codice.
3. Invia POST /api/v1/activations con il corpo {"service": "whatsapp", "country": "bw"}. La risposta contiene il numero +267 e un id di attivazione.
4. Inserisci quel numero nel modulo di registrazione sotto test, poi interroga GET /api/v1/activations/{id} oppure attendi un webhook.
5. Se il test viene interrotto, chiama POST /api/v1/activations/{id}/cancel così i fondi tornano subito nel wallet.

La guida all'integrazione dell'API OTP ripercorre le stesse chiamate con un occhio alla gestione degli errori.

Come deve trattare il tuo ricevitore webhook gli eventi +267?

I webhook sono la scelta più pulita quando più di un test gira in parallelo. Registra un endpoint (cinque per account) e ascolta activation.sms_received, activation.expired e activation.cancelled, ciascuno identificato dall'id di attivazione ottenuto in fase di ordine.

Ogni consegna porta un header X-OTPRoute-Signature nella forma t=<unix>,v1=<hex>. Ricostruisci l'HMAC-SHA256 della stringa "<t>.<raw body>" con il secret dell'endpoint, confrontalo con v1 a tempo costante e scarta tutto ciò che ha un timestamp vecchio. Analizza il JSON solo dopo che il controllo è superato, perché riserializzare il corpo cambia i byte.

Rendi l'handler idempotente: salva l'id di attivazione quando il codice viene consumato e ignora una ripetizione dello stesso evento. I dettagli sono in proteggere i webhook OTP con HMAC.

A cosa può servire un numero di verifica del Botswana?

L'istantanea live per il Botswana elenca più di 800 servizi. Tra i più popolari ci sono WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, ChatGPT (OpenAI), Microsoft & Outlook, Amazon, LinkedIn, Uber, Signal, Netflix e Airbnb.

La disponibilità su una data rotta cambia durante la giornata al variare della capacità dei carrier. È il motivo per cui l'endpoint dei prezzi riporta anche ciò che si può ordinare in questo momento: considera la sua risposta la fonte di verità, non questo elenco.

Cosa devono sapere gli ingegneri sui numeri di telefono del Botswana?

Il Botswana usa il prefisso internazionale +267 e non ha un prefisso nazionale (trunk), quindi il numero nazionale si compone così come si scrive. I cellulari hanno otto cifre e iniziano con 7. In E.164 questo dà +267 seguito dalle otto cifre, senza alcuno zero da eliminare.

Alcuni punti pratici per chi salva o convalida questi numeri:

• Normalizza tutto in E.164 in input. Gli utenti possono digitare 00267, spazi o un più iniziale; riducili tutti a un'unica forma canonica prima di confrontare o deduplicare.
• Non riutilizzare la regola del prefisso nazionale di un mercato vicino. Un validatore copiato da un paese che elimina lo zero iniziale rifiuterà voci valide del Botswana.
• Inglese e setswana sono le lingue principali. I codici delle app globali arrivano di solito in inglese, ma il tuo parser dovrebbe estrarre le cifre con un pattern invece di affidarsi a una formulazione fissa.

I team testano qui quando lanciano un prodotto nell'Africa australe, verificano l'onboarding di clienti che vivono al di là del confine con il Sudafrica, oppure gestiscono operazioni regionali che richiedono un numero +267 locale per i test.

Un non sviluppatore può ordinare un codice del Botswana dalla dashboard?

Sì. Registrati con la tua email e un codice a sei cifre (o con Google), ricarica il wallet, poi apri l'OTP Gateway, scegli il Botswana e il servizio, controlla il prezzo mostrato e ordina. Incolla il numero nell'app che stai testando; il codice compare nella dashboard non appena l'SMS raggiunge la rotta.

Ogni attivazione resta aperta per 20 minuti. Se entro quel tempo non arriva alcun messaggio, o se annulli prima, l'intero importo torna automaticamente nel tuo wallet.

E se il codice del Botswana non arriva?

La velocità di consegna dipende dal servizio e dalla rotta, quindi dai tempo alla finestra prima di agire. Se si chiude vuota, passa in rassegna questo elenco:

• Riprova un po' più tardi, oppure scegli un'altra rotta di servizio per lo stesso flusso, se il tuo prodotto lo consente.
• Verifica che l'app dall'altra parte sia disposta a inviare un SMS a una linea virtuale; alcune app respingono questi numeri, ed è proprio per questo che le attivazioni inutilizzate tornano sul tuo saldo.
• Lascia terminare la finestra di 20 minuti invece di annullare dopo un minuto.
• Evita di rifare l'ordine a ciclo continuo dalla CI; aggiungi un back-off tra i tentativi.

Altri schemi sono in ridurre le consegne OTP fallite. Qualunque cosa tu testi, rispetta i termini di ciascun servizio; l'Acceptable Use Policy di OTP Route si applica a ogni ordine.

Esiste una linea +267 a lungo termine e come funziona la fatturazione?

Non come prodotto self-service. I Dedicated Numbers sono venduti istantaneamente solo negli Stati Uniti e in Canada, da $1.95/month; per il Botswana puoi scrivere a [email protected] per chiedere, e la disponibilità dipende dalle norme locali. Vedi i numeri virtuali per cosa comprendono le linee di USA e Canada.

La fatturazione avviene con un unico wallet prepagato in USD senza canone mensile, ricaricato con carta o con USDT/USDC, e ogni ricarica arriva con una fattura PDF via email. Per il lavoro di integrazione, un account di sviluppo può essere passato alla sandbox su richiesta, così l'intero flusso gira su numeri e codici simulati. Le tariffe attuali sono nella pagina dei prezzi.

Domande frequenti

Qual è l'id del paese Botswana nell'API di OTP Route?

È bw. Passalo come country in POST /api/v1/activations e nella query string di GET /api/v1/prices.

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

Sì. Ordina un numero +267 per il servizio della tua app tramite l'OTP Gateway e leggi il codice nella dashboard o sul tuo webhook, senza SIM né telefono.

I numeri del Botswana richiedono uno zero iniziale quando vengono salvati?

No. Il Botswana non ha un prefisso nazionale (trunk), quindi salva il numero come +267 più il cellulare di otto cifre.

Mi viene addebitato qualcosa se il codice +267 non arriva?

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

Posso tenere un numero del Botswana per accessi futuri?

Per il Botswana non esiste un numero a lungo termine in self-service. Le linee a lungo termine sono un prodotto per USA e Canada; scrivi a [email protected] se vuoi chiedere di altre opzioni.

Posso eseguire i test del Botswana in CI senza spendere fondi del wallet?

Chiedi di passare il tuo account di sviluppo alla sandbox. Restituisce numeri e codici simulati, quindi l'intero percorso API e webhook si può provare senza costi.

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.