Una checklist pre-volo per ricevere codici di verifica +372 in Estonia

Cosa deve esserci nella checklist prima del primo ordine +372?

La maggior parte dei test falliti dipende da qualcosa che mancava prima ancora di richiedere il numero. Spunta prima questi punti:

• Una chiave API creata nella console sviluppatori. Ogni chiave ha il prefisso or_live_ e viaggia come token Bearer; con 10 chiavi disponibili per account, il runner CI merita una chiave tutta sua.
• Un endpoint webhook con il segreto conservato lato server, se preferisci essere chiamato anziché fare polling. Sono consentiti cinque endpoint per account.
• Gli id giusti. L'Estonia è ee in ogni richiesta, mentre l'id del servizio si ricava da GET /api/v1/services.
• Un controllo del prezzo in tempo reale. Chiama GET /api/v1/prices?country=ee&service=<id> così il job conosce il costo prima di impegnare fondi del wallet.
• La sandbox, se stai ancora collegando le parti. Su richiesta un account di sviluppo può passare alla modalità sandbox, che restituisce numeri e codici simulati end to end senza toccare il saldo.
• Un budget di richieste. L'API accetta 300 richieste al minuto per account, più che sufficienti a meno che una suite di test non faccia polling in modo incauto.

La guida all'integrazione dell'API OTP approfondisce ciascuno di questi punti.

Come eseguo una richiesta all'API OTP per l'Estonia dall'inizio alla fine?

Completata la checklist, la sequenza di chiamate è breve:

1. POST /api/v1/activations con il corpo {"service": "<id>", "country": "ee"}. La risposta contiene un id di attivazione e il numero +372 da inserire nel modulo di registrazione o di accesso in prova.
2. Attiva l'SMS di verifica dall'app che stai testando.
3. Attendi il codice. Il tuo endpoint riceve activation.sms_received, oppure chiami GET /api/v1/activations/{id} a intervalli ragionevoli.
4. Inserisci il codice nell'app e registra l'esito rispetto all'id di attivazione.
5. Se il percorso di test cambia e il numero non serve più, chiama POST /api/v1/activations/{id}/cancel così il blocco viene rilasciato subito.

Per le consegne via webhook, leggi l'header X-OTPRoute-Signature (t=<unix>,v1=<hex>), calcola l'HMAC-SHA256 su <t>.<raw body> con il segreto dell'endpoint, confronta in tempo costante e scarta tutto ciò che ha un timestamp vecchio. Proteggere i webhook OTP con HMAC illustra un handler di riferimento. Rendi le scritture idempotenti sull'id di attivazione, perché un nuovo tentativo può consegnare lo stesso evento due volte.

Quali servizi possono inviare codici a un numero di verifica estone?

L'istantanea in tempo reale dell'Estonia elenca più di 1.700 servizi. Tra le tratte più richieste ci sono WhatsApp, Telegram, Google (Gmail e YouTube), Facebook, Instagram, LinkedIn, Microsoft e Outlook, Amazon, Discord, Signal, Uber, Airbnb e ChatGPT (OpenAI).

La disponibilità cambia durante la giornata, quindi una tratta che rispondeva stamattina potrebbe essere scarsa in serata. Considera GET /api/v1/countries e l'endpoint dei prezzi come fonte di verità, invece di inserire un elenco fisso nelle fixture dei tuoi test.

Come vanno memorizzati e validati i numeri +372?

L'Estonia ha uno dei piani di numerazione più semplici da gestire, ed è proprio per questo che i validatori pigri vanno in crisi. Non c'è nessun prefisso interurbano da eliminare: un numero scritto in formato nazionale corrisponde alle stesse cifre che aggiungi dopo +372. I numeri mobili di solito iniziano con 5 e hanno sette o otto cifre, quindi una regex che pretende una lunghezza nazionale fissa scarterà input validi.

Regole pratiche per i tuoi moduli e il database:

• Conserva la stringa E.164 completa, ad esempio +3725xxxxxxx, e tieni a parte l'input grezzo dell'utente se ti serve per l'assistenza.
• Non anteporre mai uno zero; non c'è nulla da togliere né da aggiungere.
• Prova sia la lunghezza mobile di sette cifre sia quella di otto nelle maschere di input.

I messaggi di verifica destinati agli utenti estoni di solito arrivano in estone, anche se molte app seguono la lingua dell'account o del dispositivo, e sono comuni anche i template in russo o in inglese. Se il tuo prodotto ha una localizzazione estone, verifica che lettere come õ, ä, ö e ü sopravvivano al percorso dal template al telefono.

Perché i team testano i flussi di registrazione su numeri estoni?

L'Estonia conta nel software molto più di quanto suggerisca la sua dimensione. La reputazione di governo digitale e il programma e-Residency fanno sì che molti fondatori e aziende remote abbiano un legame con il paese anche quando il personale vive altrove, e i prodotti rivolti all'area baltica e nordica spesso partono proprio da lì.

Motivi tipici per cui un responsabile QA chiede un numero +372 per i test:

• Verificare che selettori del paese, maschere telefoniche e template SMS funzionino per un mercato UE con un piano di numerazione breve.
• Controlli di localizzazione sui testi in estone prima di un rilascio regionale.
• Riprodurre il ticket di un cliente estone il cui codice non è mai arrivato.

Vedi test QA per capire come i team inseriscono questi controlli nel ciclo di rilascio.

Cosa controllare quando il codice non arriva?

Affronta il problema con ordine, invece di ordinare un numero dopo l'altro:

1. Lascia scorrere la finestra. L'attivazione resta aperta per 20 minuti e alcuni servizi mettono in coda i loro messaggi.
2. Verifica che il servizio accetti numeri virtuali. Alcuni servizi li rifiutano per policy; è il motivo per cui esiste il rimborso.
3. Guarda lo stato finale. Un evento activation.expired, oppure uno stato scaduto dalla chiamata GET, significa che non è arrivato alcun SMS e il denaro è già tornato nel wallet.
4. Riprova con pazienza. Riprova un po' più tardi, oppure prova un'altra tratta per lo stesso servizio, invece di rifare l'ordine in un ciclo serrato.
5. Controlla il tuo trigger. Un test che in realtà non ha mai richiesto l'SMS è identico a un codice mancante.

Il nostro approfondimento su come ridurre le consegne OTP fallite elenca altre cause da escludere.

Posso tenere una linea estone a lungo termine e come funziona la fatturazione?

Non esiste un numero estone a lungo termine in self-service. I Numeri Dedicati sono un prodotto per Stati Uniti e Canada da $1.95/mese; per l'Estonia scrivi a [email protected] se il tuo team ha bisogno di una linea persistente, e il team ti dirà cosa consentono le norme locali, senza alcuna promessa di disponibilità.

La fatturazione del routing OTP passa da un unico wallet prepagato in USD, senza canone mensile e senza piani da scegliere. Ricarichi con carta o con USDT o USDC e ogni ricarica genera una fattura in PDF via email. Le tariffe attuali sono nella pagina dei prezzi, mentre il riferimento degli endpoint è nella documentazione.

Domande frequenti

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

Sì. Ordina un numero +372 tramite OTP Gateway, usalo nel tuo modulo di registrazione e leggi il codice dalla dashboard, da un webhook o dall'endpoint delle attivazioni.

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

Usa ee come valore di country nelle richieste di attivazione e di prezzo.

I numeri di telefono estoni hanno un prefisso interurbano da rimuovere?

No. L'Estonia non ha un prefisso interurbano, quindi le cifre nazionali seguono +372 senza modifiche.

Mi viene addebitato qualcosa se non arriva nessun codice estone?

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

Una persona non sviluppatrice può ordinare un numero di verifica dell'Estonia?

Sì. Nella dashboard scegli l'Estonia e il servizio, conferma il prezzo mostrato, copia il numero nell'app e attendi che il codice compaia nella stessa schermata.

Si può provare l'integrazione estone prima di spendere fondi reali?

Chiedi al supporto di passare il tuo account di sviluppo alla sandbox, che restituisce numeri e codici simulati così l'intero flusso può girare senza fondi del wallet.

Quali regole valgono per l'uso di questi numeri?

Rispetta i termini di ciascun servizio e la Acceptable Use Policy di OTP Route; i numeri servono per testare e far funzionare i tuoi prodotti e account legittimi.

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.