Numeri di verifica kenioti (+254) per team QA e lanci di mercato

Perché i team di prodotto testano il mercato keniota?

Nairobi è uno dei poli tecnologici più vivaci dell'Africa orientale e gli utenti kenioti sono profondamente mobile-first. Per molti di loro il numero di telefono è l'identità principale dietro messaggistica, ride-hailing, e-commerce e soprattutto mobile money, quindi un flusso di registrazione che gestisce male un numero +254 perde clienti dal primo giorno.

Inglese e swahili sono entrambe lingue ufficiali. La maggior parte delle app globali invia i codici in inglese, mentre i prodotti localizzati per la regione possono passare allo swahili, cosa da verificare se i tuoi modelli sono tradotti. Motivi comuni per eseguire test qui:

• lanciare un prodotto fintech, di consegne o di marketplace nell'Africa orientale;
• verificare i testi in swahili nei modelli SMS e nelle schermate di onboarding;
• gestire account di supporto o operativi per clienti kenioti senza esporre i numeri del personale.

La nostra pagina sull'onboarding fintech descrive lo schema più ampio.

Come si scrive un cellulare keniota in formato E.164?

A livello locale i cellulari si scrivono con il prefisso di linea 0, come in 07XX XXX XXX o 01XX XXX XXX. A livello internazionale lo zero cade: +254 seguito da un numero abbonato di nove cifre.

Il difetto classico è mantenere quello zero dopo il prefisso paese, producendo una stringa non valida +2540... che un mittente rifiuta senza un errore chiaro. Normalizza ogni inserimento prima che arrivi al database:

1. Rimuovi spazi, trattini e parentesi.
2. Se il valore inizia con 0, eliminalo e anteponi +254.
3. Se inizia con 254 senza il più, aggiungi il più.
4. Salva il risultato come stringa E.164 e valida la lunghezza dopo la normalizzazione.

Un numero +254 per i test rende facile dimostrare ogni ramo di quella logica con un vero SMS in entrata.

Quali servizi ci sono ora sulla rotta del Kenya?

Il Kenya ha uno dei cataloghi più ampi, con più di 2.800 servizi nell'istantanea in tempo reale. Tra i più richiesti ci sono WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Microsoft & Outlook, Uber, LinkedIn, Signal e Netflix.

La disponibilità può cambiare di ora in ora, ed è per questo che l'API la riporta in tempo reale invece che in un elenco fisso.

Come si collega l'API OTP per il Kenya a una suite di test?

Autenticati su https://otproute.com/api/v1 con una chiave Bearer con prefisso or_live_ della console Developer. L'id paese del Kenya è ke.

Un tipico passaggio di CI chiama prima GET /api/v1/balance, così l'esecuzione fallisce subito se il portafoglio è vuoto. Poi controlla GET /api/v1/prices?country=ke&service=<id>, ordina con POST /api/v1/activations usando un corpo come {"service": "uber", "country": "ke"} e inserisce il numero +254 restituito nell'app sotto test. Il codice torna tramite il webhook activation.sms_received oppure con polling su GET /api/v1/activations/{id} ogni pochi secondi, ampiamente entro il limite di 300 richieste al minuto.

Per i webhook, registra fino a 5 endpoint e verifica X-OTPRoute-Signature calcolando l'HMAC-SHA256 su <t>.<raw body> con il secret dell'endpoint, rifiutando i timestamp vecchi. Indicizza il gestore sull'id dell'attivazione, così una consegna ritentata è innocua. La guida ai test in CI mostra come inserirlo in una pipeline, e la documentazione contiene il riferimento completo.

Si può ordinare un numero +254 senza scrivere codice?

Sì. Nella dashboard apri l'OTP Gateway, scegli il Kenya, seleziona il servizio e conferma il prezzo mostrato. Il numero compare subito; incollalo nel modulo di registrazione o di accesso e il codice compare accanto all'attivazione non appena viene ricevuto. Gli operatori del supporto e gli account manager possono lavorare così mentre gli ingegneri usano l'API sullo stesso portafoglio.

Cosa aiuta quando un codice keniota è in ritardo o manca?

Ogni attivazione ha una finestra di 20 minuti. Paghi solo se il codice arriva; quando la finestra si chiude vuota, o annulli con POST /api/v1/activations/{id}/cancel, l'importo torna sul tuo portafoglio senza ticket.

Prima di riprovare, dai tempo alla finestra, dato che alcuni mittenti mettono i messaggi in coda. Se continua a fallire, riprova più tardi o tramite un'altra rotta di servizio, e verifica se l'app accetta numeri virtuali, perché alcune non li accettano. Evita di martellare l'endpoint degli ordini in un ciclo stretto: molti mittenti limitano le richieste ripetute verso lo stesso flusso. Il nostro articolo su come ridurre i mancati recapiti OTP raccoglie altre soluzioni. Mantieni ogni test entro i termini del servizio di destinazione; si applica la Acceptable Use Policy di OTP Route.

Linee a lungo termine, portafoglio e sandbox per i progetti in Kenya

OTP Route non vende un numero keniota a lungo termine in self-service. Le linee dedicate sono offerte solo negli Stati Uniti e in Canada, da $1.95/month, con SMS in entrata, SMS in uscita e chiamate dal browser. I team che hanno bisogno di una linea +254 continuativa possono scrivere a [email protected] per chiedere, anche se la disponibilità dipende dalle norme locali.

Il pagamento è a consumo da un unico portafoglio in USD, ricaricato con carta o con le stablecoin USDT o USDC, e ogni ricarica genera una fattura PDF. Non c'è canone mensile; consulta i prezzi per vedere come vengono mostrati i costi. Su richiesta, un account di sviluppo può passare alla sandbox, che restituisce numeri e codici simulati per test di integrazione end to end senza costi per il portafoglio.

Domande frequenti

Posso testare il flusso di registrazione keniota della mia app da fuori Kenya?

Sì. Ordina un numero +254 dall'OTP Gateway e leggi il codice in arrivo nella dashboard o tramite API, ovunque si trovi il tuo team.

Quale id paese devo inviare per il Kenya?

Invia ke nella query dei prezzi e nel corpo dell'attivazione, ad esempio {"service": "whatsapp", "country": "ke"}.

Devo salvare i numeri kenioti con lo zero iniziale?

No. Elimina il prefisso di linea 0 e salva il numero come +254 seguito da nove cifre.

I testi di verifica kenioti arriveranno in swahili?

Di solito arrivano in inglese, ma un'app localizzata per il Kenya può inviare in swahili, quindi controlla entrambi se i tuoi modelli sono tradotti.

Che fine fa il mio denaro se il codice non arriva mai?

Torna automaticamente sul tuo portafoglio quando la finestra di 20 minuti si chiude senza SMS, o subito quando annulli.

Per i codici +254 è meglio un webhook o il polling?

I webhook scalano meglio per job di test paralleli, mentre il polling di GET /api/v1/activations/{id} è più semplice per un singolo script. Entrambi leggono la stessa attivazione.

Posso avere un numero keniota da mantenere ogni mese?

Non in self-service. I numeri dedicati sono limitati a Stati Uniti e Canada; scrivi a [email protected] se ti serve una linea keniota.

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.