Testare i flussi di registrazione +994 quando nessuno nel team ha una SIM azera

Il nostro prodotto sta per andare online a Baku e il passaggio di verifica blocca ogni test. Quali sono le opzioni?

È una situazione frequente per i team che aggiungono l'Azerbaigian a un'app esistente. La schermata del telefono accetta +994, i testi localizzati sono pronti, e poi il QA si ferma perché l'unica SIM azera appartiene a un collaboratore esterno in un altro fuso orario. Farsi prestare il telefono personale di un collega funziona una volta, ma lega un account di test a un numero privato e non può girare dentro una pipeline.

L'OTP Gateway elimina questo collo di bottiglia. Richiedi un numero +994 per un solo codice, lo usi nella tua schermata di registrazione o di accesso e raccogli l'SMS senza che nessuno tenga in mano un dispositivo. Ogni numero serve una sola verifica, il che mantiene puliti i dati di test e i telefoni personali fuori dagli account aziendali. I team che lo fanno a ogni sprint di solito lo abbinano al flusso di QA testing.

Quali app possono consegnare codici su una route azera in questo momento?

L'istantanea live per l'Azerbaigian elenca più di 1.600 servizi. Tra i più popolari ci sono WhatsApp, Telegram, Viber, Uber, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Microsoft & Outlook, LinkedIn, Discord, Signal e Amazon.

La disponibilità non è fissa. Le route si aprono e si chiudono durante il giorno mentre i nostri partner carrier ruotano la capacità, quindi un servizio visibile questa mattina può mancare nel pomeriggio. Invece di inserire un elenco fisso nel codice, leggilo dall'API prima di ogni esecuzione e salta con garbo quando una combinazione non è offerta.

Come colleghiamo l'API OTP per l'Azerbaigian a una suite automatizzata?

Tutte le chiamate vanno a https://otproute.com/api/v1 con una chiave Bearer dalla Developer console; le chiavi iniziano con or_live_ e un account può averne fino a 10. L'id del paese Azerbaigian è az.

1. Recupera il catalogo con GET /api/v1/services e GET /api/v1/countries, poi conferma la combinazione con GET /api/v1/prices?country=az&service=<id>.
2. Crea l'ordine con POST /api/v1/activations e un corpo come {"service": "viber", "country": "az"}. Conserva l'id di attivazione dalla risposta.
3. Digita il numero +994 restituito nella build in prova.
4. Attendi activation.sms_received sul tuo webhook, oppure fai polling su GET /api/v1/activations/{id} se il job gira dove il traffico in ingresso è bloccato.
5. Rilascia ciò che è stato abbandonato con POST /api/v1/activations/{id}/cancel.

Le chiamate webhook portano X-OTPRoute-Signature: t=<unix>,v1=<hex>. Ricalcola l'HMAC-SHA256 su <t>.<raw body> con il segreto dell'endpoint, confronta in tempo costante e scarta i timestamp scaduti; la guida alla sicurezza dei webhook lo illustra. Il limite di 300 richieste al minuto lascia ampio spazio per job in parallelo.

Qualcuno fuori dall'ingegneria può recuperare a mano un codice +994?

Sì. Product manager, traduttori e responsabili del supporto hanno spesso bisogno di un solo codice per controllare una schermata, e la dashboard lo permette senza alcuna chiave API:

• Accedi e apri l'OTP Gateway.
• Scegli Azerbaigian, poi il servizio che stai testando, e leggi il prezzo aggiornato.
• Ordina il numero e incollalo nella tua app.
• Tieni aperta la pagina dell'attivazione; l'SMS vi compare appena viene consegnato.

Se il test viene annullato, cancella l'attivazione e l'importo torna subito nel portafoglio.

Come deve il nostro backend salvare e normalizzare i numeri +994?

Conserva ogni numero in forma E.164, ad esempio +994 seguito dal numero nazionale di nove cifre. Nel paese si compone uno 0 di rete iniziale prima del codice dell'operatore, quindi un modulo di registrazione riceverà entrambi gli stili. Elimina spazi, trattini e quello 0 nazionale, poi anteponi il prefisso del paese prima di salvare. Una libreria di analisi aggiornata è più sicura di una regex scritta a mano.

L'azero è la lingua ufficiale e usa un alfabeto latino con lettere come ə, ğ, ı, ş e ç; anche il russo è ampiamente compreso. A seconda del servizio e della lingua del dispositivo, un codice può arrivare in azero, russo o inglese. Questo rende le route +994 utili per verificare che i tuoi modelli SMS rendano correttamente i caratteri speciali e che un parser di codici non dipenda dalla formulazione inglese.

Il codice non è mai comparso. Cosa proviamo prima di fare escalation?

Comincia lasciando che l'attivazione completi i suoi 20 minuti; alcuni mittenti mettono i messaggi in coda. Se non arriva nulla, l'ordine scade, scatta activation.expired e l'intero importo viene rimborsato automaticamente, quindi paghi solo se il codice arriva.

Poi passa in rassegna le cause abituali:

• Alcuni servizi rifiutano i numeri virtuali per certi flussi. Conferma che il servizio li accetti prima di dare la colpa alla route.
• Riprova più tardi, oppure passa alla route di un altro servizio che esercita la stessa schermata.
• Evita di riordinare in un ciclo serrato; lascia un intervallo tra i tentativi in modo che una raffica di errori non svuoti la coda.

La checklist sulle consegne fallite copre ulteriori diagnosi.

Esiste una linea azera a lungo termine e come si fattura l'uso?

Per l'Azerbaigian non esiste un numero dedicato in self-service. I numeri dedicati sono un prodotto per Stati Uniti e Canada a partire da $1.95/mese; se ti serve una linea +994 permanente, scrivi a [email protected] e il team verificherà cosa consentono le norme locali, senza alcuna promessa di disponibilità. Per gli account che richiedono accessi ripetuti, un'alternativa è una linea statunitense o canadese.

Per i test su Baku, la spesa viene prelevata da un unico portafoglio USD prepagato; non ci sono livelli di abbonamento né canoni mensili. Ricarica con carta o con USDT o USDC, e ogni ricarica produce una fattura PDF via email; i prezzi attuali sono nella pagina dei prezzi. Un account di sviluppo può essere portato in sandbox su richiesta, con numeri e codici simulati, così l'integrazione si può testare da capo a fondo prima di spendere fondi reali. L'Acceptable Use Policy di OTP Route e i termini di ciascun servizio valgono per ogni ordine.

Domande frequenti

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

Sì. Ordina un numero +994 dall'OTP Gateway, inseriscilo nella tua app e leggi il codice nella dashboard o via API, senza alcuna SIM fisica.

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

Usa az nel campo country di POST /api/v1/activations e nelle richieste di prezzo.

Quanto costa un numero +994 per i test?

I codici partono da $0.20 per codice; l'importo esatto dipende dal servizio e viene restituito da GET /api/v1/prices prima di procedere.

Mi viene addebitato qualcosa se l'SMS azero non arriva?

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

Dobbiamo salvare i numeri azeri con lo zero iniziale?

No. Elimina lo 0 del prefisso nazionale e salva il numero in formato E.164 che inizia con +994.

Posso tenere lo stesso numero di verifica azero per accessi successivi?

Non tramite l'OTP Gateway, che assegna un numero per ogni codice. Le linee a lungo termine in self-service esistono solo negli Stati Uniti e in Canada; chiedi al supporto per l'Azerbaigian.

In quale lingua arriveranno i messaggi di verifica azeri?

Dipende dal mittente e dalle impostazioni del dispositivo; azero, russo e inglese sono tutti comuni.

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.