Testare la verifica telefonica thailandese (+66): checklist, passaggi e soluzioni

Prima di iniziare: una checklist per i test +66

I flussi di registrazione thailandesi hanno qualche trabocchetto che costa meno individuare sulla carta che in un'esecuzione CI fallita. Conferma prima ogni punto:

• Credenziali. Una chiave Bearer con prefisso or_live_ dalla console Developer, limitata all'ambiente che la userà.
• Identificatori. L'id paese della Thailandia è th; prendi l'id del servizio da GET /api/v1/services anziché tirarlo a indovinare.
• Metodo di consegna. Un endpoint webhook con il relativo secret di firma salvato, oppure un job di polling che rispetti il limite di 300 richieste al minuto.
• Gestione dei numeri. Decidi come il tuo codice elimina lo 0 nazionale prima di salvare qualsiasi cosa (vedi la sezione sui formati).
• Parsing dei messaggi. Assicurati che il parser gestisca la scrittura thailandese attorno alle cifre.
• Budget. Un wallet ricaricato, oppure un account sandbox se devi solo dimostrare l'integrazione.

Quali flussi di registrazione thailandesi può coprire l'OTP Gateway?

La Thailandia è una delle route più ampie, con più di 1.800 servizi nell'istantanea in tempo reale. L'uso locale è dominato da messaggistica e commercio, quindi i team di solito iniziano da LINE, Shopee, Lazada, TikTok, WhatsApp, Facebook, Instagram e Telegram. Nell'elenco ci sono anche Google (Gmail & YouTube), Microsoft & Outlook, ChatGPT (OpenAI), Discord, Viber, Netflix, Amazon e Airbnb.

La disponibilità per servizio cambia man mano che i numeri entrano ed escono, quindi leggi l'endpoint dei prezzi prima di ogni esecuzione invece di codificare ipotesi fisse.

Ordinare un numero di verifica thailandese tramite API

L'URL di base è https://otproute.com/api/v1.

1. Richiedi GET /api/v1/prices?country=th&service=<id>; una risposta vuota o non disponibile significa che conviene scegliere un altro momento o un'altra route.
2. Invia POST /api/v1/activations con un corpo come {"service": "line", "country": "th"}. Salva l'id di attivazione restituito insieme all'esecuzione del test.
3. Digita il numero +66 nell'app sotto test e fai partire l'SMS.
4. Raccogli il codice dall'evento activation.sms_received, oppure da GET /api/v1/activations/{id} se fai polling.
5. Libera gli ordini non necessari con POST /api/v1/activations/{id}/cancel.

Verifica l'header X-OTPRoute-Signature (t=<unix>,v1=<hex>) a ogni consegna e scarta gli eventi il cui timestamp è troppo vecchio. Gli eventi sono identificati dall'id dell'attivazione, il che rende facile ignorare le consegne duplicate. Esempi completi di richieste si trovano nella documentazione per sviluppatori.

Formati dei numeri thailandesi, zero nazionale e messaggi in scrittura thai

A livello nazionale i cellulari thailandesi si scrivono con uno 0 iniziale e altre nove cifre, di solito a partire da 06, 08 o 09. Quello 0 è un prefisso nazionale: in forma internazionale scompare, quindi 08x xxx xxxx diventa +66 8x xxx xxxx. Salva la versione E.164 e normalizza qualsiasi input utente che porta ancora lo zero, altrimenti la deduplicazione tratterà un unico telefono come due persone.

I codici delle app rivolte al pubblico thailandese arrivano spesso dentro una frase in thailandese. Estrai il codice con un pattern (una sequenza di cifre della lunghezza attesa) anziché ancorarti a parole inglesi, e ricorda che gli SMS in scrittura thai usano la codifica Unicode, quindi i messaggi si dividono in segmenti più corti. La QA della localizzazione è l'altro motivo per cui i team testano qui: i campi data nelle interfacce thailandesi mostrano comunemente l'anno dell'Era Buddista, e i limiti di lunghezza dei campi per nomi e indirizzi thailandesi sono facili da sbagliare. Lanci di prodotto nel Sud-est asiatico, onboarding dei venditori sui marketplace e help desk di lingua thai completano il quadro abituale.

Come usano invece la dashboard il supporto e le operations?

Non ogni controllo richiede uno script. Un membro del team operativo può registrarsi, aggiungere fondi, aprire l'OTP Gateway, scegliere un servizio e la Thailandia, controllare il prezzo indicato e ricevere il numero. Il codice compare sulla scheda dell'attivazione nel browser. Vale la stessa finestra di 20 minuti e il rimborso avviene da solo se la finestra si chiude a vuoto.

Risolvere i problemi dei codici che non raggiungono il numero +66

Quando un'attivazione resta vuota, scorri questo elenco:

• Concedile l'intera finestra prima di annullare; i rinvii ritardati sono comuni.
• Conferma che il servizio accetti numeri virtuali per la Thailandia. Alcuni no, ed è ciò che copre il rimborso automatico.
• Riprova più tardi, oppure passa a un'altra route paese se il tuo caso di test lo permette. L'articolo sul routing dei paesi spiega come i team scelgono le alternative.
• Distanzia i tentativi. Rifare l'ordine in un ciclo serrato raramente aiuta e ingombra i log.

Un tentativo fallito non fa perdere denaro: un'attivazione scaduta o annullata riporta l'intero importo sul wallet.

Linee a lungo termine, wallet e sandbox per i progetti thailandesi

OTP Route non vende un numero a lungo termine in self-service in Thailandia. I team che hanno bisogno di una linea thailandese persistente possono scrivere a [email protected] per chiedere; saranno le norme locali a stabilire se sia possibile. I numeri dedicati che mantieni e rinnovi sono disponibili solo negli Stati Uniti e in Canada, da $1.95/mese.

Tutto il resto funziona con un wallet USD prepagato, senza abbonamento. Ricarichi con carta o USDT/USDC e per ogni ricarica viene inviata una fattura PDF via email. Per il lavoro di integrazione, un account di sviluppo può essere portato in sandbox, così numeri e codici simulati attraversano il tuo codice senza costi. Consulta i prezzi per le tariffe aggiornate, rispetta i termini di ciascun servizio e ricorda che l'Acceptable Use Policy di OTP Route copre ogni attivazione.

Domande frequenti

Posso verificare la registrazione thailandese della mia app senza una SIM thailandese?

Sì. Ordina un numero +66 dall'OTP Gateway, inseriscilo nella tua app e leggi il codice nella dashboard o tramite API e webhook.

Devo tenere lo 0 iniziale quando salvo un cellulare thailandese?

No. Elimina lo 0 nazionale e salva il numero come +66 seguito dalle restanti nove cifre.

Quale id si aspetta l'API per la Thailandia?

Usa th come valore del paese, ad esempio in GET /api/v1/prices?country=th&service=<id>.

Perché il messaggio di LINE o Shopee arriva in thailandese?

Molti servizi localizzano il template dell'SMS in base al paese del numero o alla lingua dell'account, quindi analizza le cifre anziché le parole chiave inglesi.

Quanto costa un'attivazione thailandese fallita?

Niente. Se la finestra di 20 minuti termina senza SMS, o se annulli, l'intero importo torna automaticamente sul tuo wallet.

Posso eseguire test OTP thailandesi in CI senza spendere denaro?

Sì, richiedi la modalità sandbox per un account di sviluppo. Restituisce numeri e codici simulati, così la pipeline si testa end to end, come descritto nella pagina della soluzione CI/CD.

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.