Portare i codici SMS etiopi (+251) nella tua pipeline di test

Quali chiamate API recuperano un codice di verifica etiope?

Il routing OTP per l'Etiopia si riduce a cinque semplici chiamate HTTP verso https://otproute.com/api/v1. Autentica ciascuna con una chiave Bearer che inizia con or_live_, generata nella console sviluppatori; un account può contenere fino a 10 chiavi, quindi CI, staging e un portatile locale possono usare credenziali separate.

1. GET /api/v1/countries elenca ogni tratta e l'Etiopia compare con l'id et.
2. GET /api/v1/services restituisce gli id dei servizi, mentre GET /api/v1/prices?country=et&service=<id> riporta prezzo e disponibilità attuali per la coppia che intendi testare.
3. POST /api/v1/activations con {"service": "telegram", "country": "et"} riserva un numero +251 e restituisce un id di attivazione.
4. Digita quel numero nel campo telefono del prodotto in prova e attiva il suo SMS.
5. Leggi il codice da un evento webhook o facendo polling su GET /api/v1/activations/{id}, e abbandona un'esecuzione in modo pulito con POST /api/v1/activations/{id}/cancel.

La disponibilità cambia durante la giornata, quindi chiama l'endpoint dei prezzi a runtime invece di scrivere valori fissi nel codice. Un rapido GET /api/v1/balance prima dell'avvio della suite permette a un job di fermarsi subito quando il wallet sta per esaurirsi. Le forme di richiesta e risposta di questa API di verifica via SMS sono nella documentazione per sviluppatori.

Come collego un webhook firmato per le attivazioni +251?

Il polling va bene per un singolo test, ma i job paralleli sono più facili da gestire quando gli eventi ti vengono inviati. Registra fino a 5 endpoint webhook per account e iscriviti a activation.sms_received, activation.expired e activation.cancelled.

Ogni richiesta porta X-OTPRoute-Signature: t=<unix>,v1=<hex>. Ricalcola l'HMAC-SHA256 su <t>.<raw body> con il segreto dell'endpoint, confronta il risultato con v1 usando un controllo a tempo costante e rifiuta la chiamata se il timestamp è scaduto. Verifica sui byte grezzi prima che qualsiasi parser JSON li tocchi.

Parti dal presupposto che un evento possa essere consegnato più di una volta: usa l'id di attivazione come chiave nell'handler e scarta i duplicati, così un evento ritentato non riempie mai due volte un campo OTP. Se resti sul polling, un intervallo di pochi secondi rientra comodamente nel limite di 300 richieste al minuto. Il nostro approfondimento su come proteggere i webhook OTP con HMAC include un handler di riferimento.

Quali servizi possono ricevere codici SMS OTP dall'Etiopia in questo momento?

La tratta dell'Etiopia elenca attualmente più di 1.700 servizi. Tra le voci più popolari nell'istantanea in tempo reale ci sono WhatsApp, Telegram, Google (Gmail e YouTube), Facebook, Instagram, TikTok, ChatGPT (OpenAI), Microsoft e Outlook, LinkedIn, Uber, Signal, Viber, imo e Netflix.

Considera quell'elenco un'istantanea. La disponibilità di un singolo servizio può cambiare nel giro di poche ore, ed è per questo che l'API la riporta in tempo reale invece che in una tabella statica. Interroga gli endpoint dei paesi e dei prezzi all'inizio di ogni esecuzione e cerca nel catalogo completo della dashboard se ti serve qualcosa di meno comune.

Cosa deve sapere il QA sui formati dei numeri +251 e sulla lingua degli SMS?

Un numero etiope in E.164 è +251 seguito da nove cifre. A livello nazionale si compone uno 0 iniziale davanti a quelle nove cifre, quindi gli utenti spesso digiteranno 09… nel tuo modulo. Elimina quello zero interurbano, anteponi +251 e conserva la stringa E.164 canonica, mostrando lo stile locale solo nell'interfaccia. Copri entrambi gli input, oltre a spazi e trattini, perché la validazione del campo telefono è dove si nascondono molti bug di registrazione.

L'amarico è la lingua di lavoro federale e si scrive in alfabeto etiopico (ge'ez), mentre afaan oromo, tigrino e somalo sono molto diffusi nelle rispettive regioni. La maggior parte dei servizi internazionali invia i codici in inglese, ma un template localizzato può arrivare in amarico. Estrai le cifre con un pattern invece di cercare le parole circostanti e assicurati che i tuoi log memorizzino UTF-8 senza problemi.

I team di solito testano questa tratta quando lanciano un'app per utenti etiopi, verificano una localizzazione in amarico o servono clienti della diaspora che si registrano con un numero del paese d'origine. Se il tuo prodotto mostra le date, il calendario proprio dell'Etiopia è un caso di localizzazione a parte che vale la pena aggiungere. La pagina sui test QA mostra come altri team strutturano queste suite.

Chi non è sviluppatore può ottenere un numero di verifica etiope dalla dashboard?

Sì. Product manager e personale di assistenza possono eseguire lo stesso flusso senza scrivere codice:

1. Crea un account con la tua email e un codice a 6 cifre, oppure con l'accesso Google, poi attiva l'autenticazione a due fattori TOTP.
2. Aggiungi fondi al wallet.
3. Scegli l'Etiopia, seleziona il servizio e leggi il prezzo mostrato prima di confermare.
4. Incolla il numero +251 nell'app che stai verificando.
5. Tieni aperta l'attivazione; il codice viene mostrato lì non appena viene ricevuto.

Molti team usano questo percorso per controlli occasionali, mentre gli ingegneri pilotano la stessa tratta tramite API.

Cosa succede quando il codice +251 non compare?

Ogni attivazione resta aperta per 20 minuti. Paghi solo se il codice arriva; se la finestra si chiude senza un SMS, oppure annulli, l'intero importo torna automaticamente nel wallet.

Quando non arriva nulla:

• Lascia scorrere la finestra prima di considerarlo un fallimento, perché i tempi dipendono dal servizio e dalla tratta.
• Riprova più tardi, oppure passa a un'altra tratta di servizio se il tuo caso di test lo consente.
• Verifica che il servizio accetti numeri virtuali. Alcuni li rifiutano, e il rimborso esiste proprio per questa situazione.
• Non rifare l'ordine in un ciclo serrato. Distanzia i tentativi e registra ogni id di attivazione così emergono gli schemi.

L'articolo su come ridurre le consegne OTP fallite elenca altri controlli.

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

OTP Route non ha un numero a lungo termine in self-service in Etiopia. I Numeri Dedicati, linee che tieni finché si rinnovano, sono un prodotto per Stati Uniti e Canada da $1.95/mese. Se il tuo team ha bisogno di una linea +251 duratura, scrivi a [email protected] per chiedere; la disponibilità dipende dalle norme locali e non è garantita.

Le attivazioni per l'Etiopia attingono a un unico wallet prepagato in USD, senza canone mensile e senza piani da scegliere. Lo ricarichi con carta o con stablecoin USDT/USDC; dopo ogni ricarica arriva nella tua casella una fattura in PDF. Prima di spendere fondi reali per una nuova integrazione, richiedi la modalità sandbox per un account di sviluppo: restituisce numeri e codici simulati così l'intero flusso può essere provato end to end.

I numeri di test etiopi di OTP Route servono a verificare prodotti e account che la tua organizzazione possiede davvero; restano validi i termini di ciascun servizio, così come la nostra Acceptable Use Policy.

Domande frequenti

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

Sì. Ordina un numero +251 per il tuo servizio da OTP Gateway, inseriscilo nella tua app e leggi il codice nella dashboard o tramite API. Ti viene addebitato solo se il codice arriva.

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

È et. Invia et come campo country quando crei un'attivazione per l'Etiopia e quando interroghi i prezzi.

Quanto costa un numero +251 per i test?

I codici partono da $0.20 ciascuno. L'importo esatto per ogni servizio è restituito da GET /api/v1/prices e mostrato nella dashboard prima dell'ordine.

Devo conservare i numeri di telefono etiopi con lo zero iniziale?

No. Conserva la forma E.164, +251 più nove cifre, ed elimina lo 0 nazionale ogni volta che un utente lo digita. Applica la formattazione locale solo a schermo.

I messaggi di verifica etiopi arriveranno in amarico?

Di solito arrivano in inglese, anche se un servizio può usare un template in amarico in alfabeto etiopico. Analizza le cifre e non le parole, così funzionano entrambe le versioni.

Posso tenere un numero etiope per accessi futuri?

Non in self-service, perché un numero monouso copre un solo codice. Per un account che deve accedere di nuovo, la soluzione è un Numero Dedicato negli Stati Uniti o in Canada, oppure puoi scrivere al supporto per chiedere dell'Etiopia.

Posso provare l'API OTP per l'Etiopia senza spendere fondi del wallet?

Sì. Richiedi la modalità sandbox su un account di sviluppo e restituirà numeri e codici simulati, così puoi testare l'integrazione end to end.

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.