Una checklist per ricevere i codici SMS di TikTok in test e operazioni

Per cosa invia codici SMS TikTok?

TikTok permette di creare un account con un numero di telefono, di accedere con un codice monouso invece di una password, di attivare la verifica in due passaggi e di ripristinare l'accesso quando si dimentica la password. Ognuno di questi momenti può generare un codice SMS, e ognuno è un passaggio che i team che lavorano attorno a TikTok possono dover riprodurre: un'agenzia che conferma un account di brand che gestisce, un QA engineer che controlla un'integrazione di social login, o un team operativo che tiene un profilo aziendale lontano dal telefono personale di un dipendente.

Un numero virtuale per TikTok si adatta a questi casi, con la verifica SMS di TikTok per i test come il più frequente. Tutti sono legittimi quando l'account appartiene a te o al tuo cliente e rispetta i termini di TikTok.

Checklist pre-volo prima di ordinare

Dieci minuti su questi punti prima del primo ordine TikTok fanno risparmiare ore di ricerche sui codici mancanti:

• Scegli il mercato. Il paese del numero deve corrispondere alla regione dell'account o al caso di test che stai riproducendo.
• Controlla prezzo e disponibilità. GET /api/v1/prices?country=<id>&service=tiktok restituisce entrambi, in tempo reale.
• Ricarica il wallet. GET /api/v1/balance all'inizio di un'esecuzione fallisce subito invece che a metà test.
• Decidi la consegna. Webhook per CI e job paralleli, polling per controlli manuali rapidi.
• Pensa in anticipo al nuovo accesso. Se l'account deve accedere di nuovo il mese prossimo, un numero monouso è lo strumento sbagliato (vedi l'ultima sezione).
• Conosci le regole. Un account per persona reale o azienda, i termini di TikTok e l'Acceptable Use Policy di OTP Route.

Da quale paese dovrebbe provenire il numero di telefono TikTok?

La rotta TikTok è aperta in 202 paesi. Tra le scelte più comuni ci sono Stati Uniti, Canada, Regno Unito, Germania, Francia, Brasile, Messico, Indonesia, Filippine, Vietnam, Thailandia, Turchia, Arabia Saudita, Pakistan, Nigeria e Kenya.

La scelta del paese non è estetica. TikTok adatta contenuti, funzioni e controlli di registrazione in base alla regione, quindi un caso QA per un lancio in Brasile deve usare un numero +55 e un test di localizzazione filippino un numero +63. Un numero che non corrisponde al mercato dell'account è un motivo frequente per cui un flusso si comporta in modo diverso da quello che vedono gli utenti.

Passo dopo passo: l'API per il codice di verifica TikTok

Autenticati su https://otproute.com/api/v1 con una chiave Bearer che inizia con or_live_ della Developer console.

1. Ricava l'id del paese con GET /api/v1/countries; l'id del servizio è tiktok.
2. Leggi il prezzo aggiornato: GET /api/v1/prices?country=br&service=tiktok.
3. Crea l'attivazione con POST /api/v1/activations e {"service": "tiktok", "country": "br"}. Conserva l'id di attivazione della risposta.
4. Inserisci il numero restituito nella schermata del telefono di TikTok e richiedi il codice.
5. Recuperalo dall'evento activation.sms_received, oppure interroga GET /api/v1/activations/{id} ogni pochi secondi.
6. Se lo scenario viene abbandonato, chiama POST /api/v1/activations/{id}/cancel così i fondi tornano subito.

Il limite dell'account è di 300 richieste al minuto, più che sufficiente per interrogare più attivazioni contemporaneamente. La documentazione API elenca le strutture complete di richieste e risposte.

Costruire il ricevitore del webhook

Registra un endpoint HTTPS nella Developer console (fino a 5 per account) e iscrivilo a activation.sms_received, activation.expired e activation.cancelled. Poi rendilo robusto:

• Scomponi X-OTPRoute-Signature in t e v1, calcola l'HMAC-SHA256 di <t>.<raw body> con il secret dell'endpoint e confronta in tempo costante.
• Rifiuta i timestamp più vecchi di pochi minuti per bloccare i replay.
• Tratta l'id di attivazione come chiave di idempotenza, così un evento riconsegnato non aggiorna nulla due volte.
• Rispondi subito con un 2xx e passa il lavoro lento a una coda.

Mantieni il polling come ripiego per lo sviluppo locale, dove non esiste un URL pubblico. La nostra guida a proteggere i webhook OTP illustra il codice di verifica.

Risolvere il problema di un codice TikTok che non arriva

Il silenzio di TikTok di solito ha una causa ordinaria:

1. Attendi la fine della finestra. L'attivazione resta aperta per 20 minuti; se non arriva nulla, l'intero addebito viene rimborsato automaticamente.
2. Accetta che alcuni numeri vengano rifiutati. TikTok può rifiutare i numeri virtuali in alcune regioni o situazioni, e la regola del rimborso copre questo caso.
3. Cambia una sola variabile. Riprova più tardi, oppure prova un altro paese che sia comunque adatto al tuo test.
4. Rallenta. Richiedere codici ripetutamente in poco tempo può far scattare i limiti propri di TikTok; distanzia i tentativi.
5. Controlla dal tuo lato. Verifica che il numero sia stato inserito per intero nel formato internazionale e che il tuo webhook abbia restituito un 2xx.

Quando è meglio una linea dedicata statunitense o canadese?

Un'attivazione monouso va bene per una singola verifica. Un account di brand che deve accedere di nuovo, recuperare l'accesso o superare controlli in due passaggi mesi dopo ha bisogno di un numero che il tuo team conservi. I Dedicated Number coprono questo caso negli Stati Uniti e in Canada da $1.95/mese, con SMS in entrata nella dashboard e sul tuo webhook tramite number.sms_received; vedi numeri virtuali. Le linee a lungo termine self-service non sono disponibili in altri paesi.

Tutta la spesa proviene da un unico wallet prepagato in USD, ricaricato con carta o USDT/USDC, con una fattura PDF per ogni ricarica. Su richiesta si può abilitare un account sandbox per i test di integrazione con codici simulati.

Domande frequenti

Come faccio a ricevere automaticamente un codice TikTok sul mio backend?

Ordina un'attivazione con l'id servizio tiktok, poi ricevi il codice tramite il webhook firmato activation.sms_received oppure interrogando GET /api/v1/activations/{id}.

Posso testare la verifica SMS di TikTok per un paese specifico?

Sì. Scegli il paese quando crei l'attivazione; la rotta TikTok copre attualmente 202 paesi e la disponibilità in tempo reale viene dall'endpoint dei prezzi.

Quanto costa un OTP TikTok?

Da $0.20 a codice, a seconda del paese. La cifra esatta compare nella dashboard e in GET /api/v1/prices prima di ordinare.

Cosa succede quando TikTok rifiuta il numero virtuale?

Non arriva alcun SMS, quindi l'attivazione scade dopo 20 minuti oppure la annulli, e l'intero importo torna nel tuo wallet.

Un numero monouso basta per un account di brand che gestiamo a lungo termine?

Di solito no. Per accessi ripetuti e recupero, usa un Dedicated Number statunitense o canadese che il tuo team conserva finché si rinnova.

Posso usare OTP Route per creare molti account TikTok?

No. OTP Route serve a testare e gestire i tuoi account e prodotti legittimi; rispetta i termini di TikTok e mantieni un solo account per persona reale o azienda.

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.