Ricevere i codici SMS di LINE su numeri OTP Route: checklist e passaggi

A cosa serve il numero di telefono su LINE?

LINE lega un account a un numero di telefono. Una nuova registrazione viene confermata con un codice SMS e l'app può chiedere di nuovo il numero quando l'account viene spostato su un nuovo dispositivo o quando qualcuno accede dopo aver reinstallato l'app. Il numero ha anche un ruolo nel recupero dell'accesso, quindi conta con quale numero è stato creato l'account.

Quest'ultimo punto orienta la scelta del prodotto: un numero monouso va bene per un singolo passaggio di verifica, mentre un account che dovrà accedere di nuovo dopo mesi ha bisogno di un numero che controlli ancora.

Checklist prima di ordinare un numero LINE

• Una chiave API dalla console sviluppatori (prefisso or_live_); fino a 10 chiavi per account.
• Saldo del wallet sufficiente, verificato con GET /api/v1/balance.
• Un paese scelto in base al mercato dell'account o al caso di test.
• Una consultazione del prezzo in tempo reale per quella coppia, perché i prezzi variano per paese.
• Un endpoint webhook registrato e il suo controllo della firma testato, oppure un ciclo di polling pronto.
• Una decisione sul fatto che questo account debba riaccedere in futuro; in caso affermativo, leggi prima la sezione sul numero dedicato qui sotto.
• Una rapida rilettura dei termini di LINE per il tipo di account che stai creando.

Quali paesi posso scegliere per LINE e perché è importante?

Il servizio LINE è disponibile in 197 paesi. L'app ha le basi di utenti più solide in parti dell'Asia orientale e sud-orientale, quindi i team che vi lanciano un prodotto partono spesso da Giappone, Thailandia, Taiwan, Indonesia, Hong Kong o Malesia. Altre opzioni sono Singapore, Filippine, Vietnam, Corea del Sud, Australia, Stati Uniti, Regno Unito, Germania, Brasile e Romania.

Scegli il paese da cui provengono i tuoi utenti reali. Una build per il mercato thailandese va verificata con un numero thailandese, così prefisso, formato del telefono ed eventuali schermate di onboarding regionali si comportano come in produzione. Coprire più mercati richiede poco sforzo in più, perché tra un'esecuzione e l'altra cambia solo il valore di country.

Passo dopo passo: il flusso dell'API del codice di verifica LINE

1. Chiama GET /api/v1/prices?country=<id>&service=linemessenger e conferma che la rotta sia disponibile.
2. Crea l'attivazione con POST /api/v1/activations e un corpo come {"service": "linemessenger", "country": "th"}.
3. Inserisci il numero restituito nella schermata di verifica telefonica di LINE.
4. Attendi activation.sms_received, oppure fai polling di GET /api/v1/activations/{id} ogni pochi secondi entro il limite di 300 richieste al minuto.
5. Se l'esecuzione viene abbandonata, chiama POST /api/v1/activations/{id}/cancel.

I dettagli degli endpoint sono nella documentazione per sviluppatori.

Come deve trattare il gestore del webhook gli eventi di LINE?

Leggi l'header X-OTPRoute-Signature, nel formato t=<unix>,v1=<hex>, calcola l'HMAC-SHA256 su <t>.<raw body> con il segreto dell'endpoint, confronta a tempo costante e scarta tutto ciò che ha un timestamp vecchio. Poi usa come chiave dell'elaborazione l'id dell'attivazione, così una consegna ritentata aggiorna lo stesso record invece di far scattare due volte il tuo passaggio di test. Tratta activation.expired e activation.cancelled come esiti regolari nella stessa tabella. La guida all'HMAC offre una spiegazione completa.

Ordinare un numero LINE dalla dashboard

Accedi, apri l'OTP Gateway, scegli LINE e un paese, controlla il prezzo mostrato e ordina. Digita il numero in LINE, poi tieni aperta la scheda dell'attivazione: il codice compare lì appena ricevuto. Product manager e operatori del supporto usano spesso questa vista per verificare a mano una schermata di onboarding LINE localizzata prima che subentri la suite automatica. Valgono la stessa finestra di 20 minuti e la stessa regola di rimborso.

Risoluzione dei problemi: perché un codice LINE potrebbe non arrivare

LINE può rifiutare alcuni numeri virtuali e una rotta che funzionava prima può non essere disponibile più tardi nella giornata. Se nessun SMS arriva, l'attivazione viene rimborsata per intero alla chiusura della finestra o quando annulli. Dopodiché:

• prova un altro paese che sia ancora adatto al caso di test;
• riprova più tardi invece di rifare l'ordine in un ciclo serrato;
• verifica di aver inserito il numero con il prefisso paese corretto.

Quando un numero dedicato è la scelta migliore per LINE?

Se un account di staging o un accesso condiviso del team deve continuare ad accedere, un numero monouso è lo strumento sbagliato. I numeri dedicati negli Stati Uniti e in Canada partono da $1.95/month, ricevono SMS in entrata nella dashboard e sul tuo webhook tramite number.sms_received e si rinnovano dal wallet finché non li rilasci. I dettagli sono nella pagina dei numeri virtuali.

Usa OTP Route solo per i tuoi prodotti e account legittimi: un account per ogni persona o azienda reale, nel rispetto dei termini di LINE e della Acceptable Use Policy.

Domande frequenti

Quale id servizio usa OTP Route per LINE?

L'id è linemessenger. Usalo nella richiesta dei prezzi e nel campo service quando crei un'attivazione.

Posso fare la verifica SMS di LINE per i test senza una SIM fisica?

Sì. Un numero OTP Gateway riceve il codice LINE, che leggi tramite API, webhook o dashboard.

Quale paese devo scegliere per un numero virtuale per LINE?

Scegli il mercato a cui appartengono i tuoi utenti o il tuo caso di test, ad esempio Giappone o Thailandia per un lancio in quei paesi.

LINE accetterà ogni numero di OTP Route?

Non sempre. LINE può rifiutare alcuni numeri virtuali e, quando non arriva alcun codice, vieni rimborsato automaticamente.

Quanto costa ricevere un OTP di LINE?

Da $0.20 per codice, a seconda del paese; il prezzo in tempo reale proviene da GET /api/v1/prices.

Posso tenere lo stesso numero LINE per gli accessi successivi?

Solo con un numero dedicato, disponibile negli USA e in Canada. I numeri monouso servono per un solo codice.

Mi serve un webhook per ricevere i codici OTP di LINE o basta il polling?

Il polling di GET /api/v1/activations/{id} funziona bene per piccole esecuzioni. I webhook scalano meglio quando molte attivazioni girano in parallelo.

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.