Integrare un flusso di verifica SMS egiziano (+20) nell'API di OTP Route

Di quali richieste ha davvero bisogno un'integrazione dell'API OTP per l'Egitto?

Sette endpoint coprono tutto, tutti sotto https://otproute.com/api/v1 e tutti autenticati con una chiave Bearer con prefisso or_live_. Genera una chiave per ambiente nella Developer console; un account può averne fino a 10.

1. Carica il catalogo con GET /api/v1/services e GET /api/v1/countries. L'id del paese per l'Egitto è eg e cambia di rado, quindi metterlo in cache va bene.
2. Prima di ogni ordine, chiedi a GET /api/v1/prices?country=eg&service=<id> prezzo e disponibilità attuali. La disponibilità si muove durante la giornata, quindi tratta questa risposta come dato fresco e non come configurazione.
3. Crea l'attivazione con POST /api/v1/activations e un corpo come {"service": "whatsapp", "country": "eg"}. Ricevi un id di attivazione e il numero +20 da digitare nella schermata sotto test.
4. Recupera il codice da un webhook o chiamando GET /api/v1/activations/{id}.
5. Se un test viene interrotto, rilascia l'ordine con POST /api/v1/activations/{id}/cancel così i fondi tornano subito.

Un rapido GET /api/v1/balance all'inizio di ogni suite permette a un job di CI di fermarsi presto invece di fallire a metà. Il limite è di 300 richieste al minuto per account, che lascia spazio per il polling di più attivazioni in parallelo. Esempi completi di richieste sono nella documentazione per sviluppatori.

Come consumo i codici +20 da un webhook firmato invece di fare polling?

Il polling va bene per un singolo test locale; un webhook è la scelta migliore quando una pipeline esegue molte attivazioni egiziane insieme. Aggiungi un endpoint nella Developer console (cinque per account) e iscriviti a activation.sms_received, oltre a activation.expired e activation.cancelled, così il tuo job sa quando smettere di aspettare.

Ogni richiesta porta X-OTPRoute-Signature: t=<unix>,v1=<hex>. Ricostruisci la stringa <t>.<raw body>, calcola HMAC-SHA256 con il segreto dell'endpoint e confrontala con v1 con un controllo a tempo costante. Rifiuta tutto ciò il cui timestamp è vecchio, e calcola l'hash sui byte esattamente come ricevuti, non su un oggetto analizzato e ricodificato.

Usa l'id di attivazione come chiave di idempotenza: memorizza l'evento una sola volta, ignora le ripetizioni e restituisci rapidamente un 2xx. La guida alla cattura OTP via webhook illustra una versione di questo handler basata su una coda.

Quali servizi possono recapitare codici a un numero di verifica egiziano?

L'istantanea attuale per l'Egitto elenca in totale più di 1.600 servizi. Tra quelli popolari che i team testano su numeri +20 ci sono WhatsApp, Facebook, Instagram, TikTok, Telegram, Google (Gmail & YouTube), Microsoft & Outlook, Uber, Snapchat, Viber, imo, ChatGPT (OpenAI), Amazon e LinkedIn.

Quell'elenco è una vista di un istante, non una promessa. Un servizio che stamattina ha numeri può averne pochi nel pomeriggio, ed è esattamente per questo che l'endpoint dei prezzi riporta la disponibilità insieme al costo. Alcuni servizi rifiutano del tutto i numeri virtuali; quando accade, ti copre la regola del rimborso descritta più sotto.

Come deve un'app memorizzare e validare i cellulari egiziani?

L'Egitto usa il prefisso internazionale +20 e un prefisso interurbano nazionale 0. A livello locale un cellulare si scrive con undici cifre che iniziano con 01, mentre nella forma internazionale lo zero sparisce e dieci cifre seguono il +20. Poche abitudini evitano la maggior parte dei bug:

• Salva solo E.164, ad esempio +201XXXXXXXXX, e formatta per la visualizzazione al momento del rendering.
• Elimina lo zero iniziale quando un utente inserisce 01… con il paese già impostato su Egitto; altrimenti ottieni un valore non valido +2001….
• Normalizza le cifre. Chi usa tastiere arabe può digitare numeri indo-arabi, quindi convertili in cifre ASCII prima della validazione e prima di confrontare un OTP inserito.

L'arabo è la lingua ufficiale, quindi molti servizi inviano agli utenti egiziani i codici in arabo, mentre altri usano l'inglese per default. Se il tuo parser estrae il codice con una regex, provalo sia su corpi di messaggio da destra a sinistra sia su quelli in inglese.

Il team operativo può ordinare un numero egiziano senza scrivere codice?

Sì. Non ogni controllo richiede uno script, e i colleghi del supporto o della crescita possono usare lo stesso OTP Gateway dal browser:

1. Registrati con la tua email e il codice a 6 cifre, oppure con Google.
2. Ricarica il wallet e apri l'OTP Gateway.
3. Scegli l'Egitto e il servizio; il prezzo viene mostrato prima della conferma.
4. Copia il numero +20 nell'app e attendi che il codice compaia a schermo.

L'attivazione è identica a un ordine via API, quindi un controllo manuale e uno automatico si comportano allo stesso modo.

Cosa fare se il codice +20 non arriva?

Ogni attivazione resta aperta per 20 minuti. Se in quel tempo non arriva alcun SMS, o annulli prima, l'intero importo torna automaticamente nel wallet, quindi un numero silenzioso non ti costa mai nulla.

Quando i codici continuano a fallire:

• Lascia scorrere la finestra prima di decidere che è fallito; il tempo di consegna dipende dal servizio e dalla rotta.
• Verifica che il servizio accetti del tutto i numeri virtuali. Alcuni li rifiutano, e nessuna scelta di instradamento lo cambia.
• Riprova un po' più tardi, o con una rotta vicina se il tuo test non dipende da un numero egiziano.
• Evita di riordinare in un ciclo serrato. Lascia un intervallo crescente tra gli ordini e tieni ogni id di attivazione nei log.

Le nostre note su come ridurre i recapiti OTP falliti approfondiscono la politica dei tentativi.

Perché i team di prodotto testano con numeri egiziani?

L'Egitto è uno dei maggiori mercati di lingua araba, quindi è una tappa naturale per i team che localizzano un prodotto in arabo. Un vero numero +20 mette alla prova ciò che gli emulatori saltano: il selettore di paese, la gestione dello zero iniziale, i template SMS in arabo e il layout da destra a sinistra sulla schermata di inserimento del codice.

I team operativi regionali usano anche l'instradamento OTP per confermare che un flusso di registrazione funzioni ancora per i clienti egiziani dopo un rilascio, e le aziende che servono egiziani residenti all'estero verificano che un numero +20 venga accettato anche fuori dal paese.

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

Non esiste un numero a lungo termine in self-service per l'Egitto. Le linee dedicate sono un prodotto solo per Stati Uniti e Canada, da $1.95/mese; se ti serve una linea egiziana continuativa, scrivi a [email protected] e il team ti dirà se è possibile secondo le norme locali, senza promessa che lo sia.

La fatturazione è un wallet prepagato in USD senza canone mensile e senza piano da scegliere. I fondi entrano con carta o come USDT/USDC e ogni ricarica è seguita da una fattura PDF via email. Mentre costruisci l'integrazione puoi chiedere la modalità sandbox per un account di sviluppo, che restituisce numeri e codici simulati senza toccare i fondi del wallet. Le tariffe attuali sono nella pagina dei prezzi.

Domande frequenti

Posso verificare l'OTP di registrazione egiziano della mia app senza una SIM egiziana?

Sì. Ordina un numero +20 dall'OTP Gateway, inseriscilo nel modulo di registrazione e leggi il codice nella dashboard o dall'API, tutto senza SIM locale.

Quale id paese usa l'API di OTP Route per l'Egitto?

L'Egitto è eg. Passalo all'endpoint dei prezzi e nel corpo di POST /api/v1/activations.

Pago un numero +20 se l'SMS non arriva mai?

No. Se nessun codice arriva entro 20 minuti, o annulli l'attivazione, l'intero importo viene restituito automaticamente al tuo wallet.

Devo mantenere lo zero iniziale quando salvo un cellulare egiziano?

No. Lo 0 è un prefisso interurbano nazionale; eliminalo e memorizza il numero in forma E.164 che inizia con +20.

Posso accedere di nuovo il mese prossimo con lo stesso numero di test egiziano?

Non in modo affidabile. Ogni numero dell'OTP Gateway serve per un solo codice di verifica, e le linee dedicate self-service esistono solo per Stati Uniti e Canada, quindi pianifica di conseguenza gli account che richiedono accessi ripetuti.

Posso usare numeri egiziani per aprire molti account su una piattaforma?

No. OTP Route serve per testare e gestire i tuoi account e prodotti legittimi; rispetta i termini di ciascun servizio e l'Acceptable Use Policy.

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.