Una checklist pre-volo per ricevere i codici di accesso Telegram su un numero di test

Cosa dovrebbe essere pronto prima di ordinare un numero Telegram?

Scorri prima questa lista: la maggior parte dei test Telegram falliti dipende da uno di questi punti.

• Uno scopo chiaro. Stai testando un bot, una Mini App, un widget di login o un flusso di assistenza gestito dal tuo team, e ti serve un account Telegram nuovo che non sia legato al telefono personale di nessun dipendente.
• Un paese di destinazione. Decidi a quale mercato deve sembrare appartenere l'account. Le impostazioni di lingua e alcune schermate di onboarding seguono il paese del numero.
• Fondi nel wallet o sandbox. Un wallet prepagato con credito, oppure un account di sviluppo portato in sandbox dal supporto per le prove.
• Una chiave API, se automatizzi. Creane una con il prefisso or_live_ nella Developer console.
• Un dispositivo o un emulatore puliti. Telegram consegna i codici dentro l'app a qualsiasi sessione già connessa, quindi un dispositivo senza sessioni esistenti rende prevedibile il percorso via SMS.
• Tempo. Ogni attivazione resta aperta per 20 minuti; non avviarne una finché il tester non è pronto a digitare il numero.

Quando Telegram invia davvero un codice via SMS?

Telegram identifica ogni account tramite il numero di telefono. Chiede un codice quando qualcuno registra un nuovo account e quando un account esistente accede da un nuovo dispositivo. Se quell'account è già attivo altrove, Telegram di solito invia il codice di accesso come messaggio nella sessione esistente anziché via SMS: per questo un numero nuovo su un dispositivo pulito è il modo più sicuro per mettere alla prova il passaggio SMS. Dopo una breve attesa può anche proporre una chiamata o un nuovo invio.

La verifica in due passaggi di Telegram è una password cloud separata, impostata nell'app. Non è un fattore SMS, quindi conserva quella password nel gestore dei segreti del tuo team se la attivi su un account di test.

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

Il servizio telegram è attualmente elencato in 199 paesi, tra cui India, Germania, Brasile, Nigeria, Indonesia, Regno Unito, Ucraina, Kazakistan, Uzbekistan, Turchia, Spagna, Messico, Filippine, Vietnam ed Egitto.

Abbina il paese al caso di test. Un bot che risponde in portoghese va provato da un account brasiliano; un team di assistenza che copre l'Asia centrale potrebbe volere un numero kazako. Telegram può inoltre trattare con più cautela i numeri di alcuni paesi rispetto ad altri, quindi se una rotta continua a fallire, un mercato vicino è un ripiego ragionevole. La disponibilità reale cambia nel corso della giornata: leggila dall'API invece che da un elenco salvato.

Come automatizzo il codice Telegram con l'API?

1. Facoltativamente, controlla il costo con GET /api/v1/prices?country=<id>&service=telegram.
2. Crea l'ordine: POST /api/v1/activations con {"service": "telegram", "country": "<id>"}, dove l'id del paese viene da GET /api/v1/countries (per esempio br o de).
3. Passa il numero restituito al tuo test runner, che lo digita nel client Telegram o nell'emulatore.
4. Attendi il codice. Con un webhook, resta in ascolto di activation.sms_received; altrimenti interroga GET /api/v1/activations/{id} a intervalli ragionevoli.
5. Fai pulizia con POST /api/v1/activations/{id}/cancel se l'esecuzione si interrompe.

Per i webhook, verifica X-OTPRoute-Signature ricalcolando l'HMAC-SHA256 su <t>.<raw body> con il secret dell'endpoint, rifiuta i timestamp vecchi e registra ogni id di attivazione già elaborato, così un evento consegnato di nuovo viene ignorato. Per ogni account sono disponibili fino a 5 endpoint webhook e 300 richieste al minuto. La guida alla pipeline CI tratta le esecuzioni in parallelo.

Posso fare gli stessi passaggi a mano nella dashboard?

Sì. Accedi, apri l'OTP Gateway, scegli Telegram e il paese, controlla il prezzo e ordina. Copia il numero nella schermata del telefono di Telegram, seleziona il prefisso corrispondente e richiedi il codice. Quando l'SMS arriva, compare accanto all'ordine, pronto da incollare.

Il codice Telegram non è arrivato. Cosa c'è nella lista di risoluzione dei problemi?

• Esiste già una sessione? Se il numero è stato usato in precedenza, Telegram potrebbe aver inviato il codice nell'app. Una nuova attivazione evita il problema.
• La finestra è terminata? Lascia scorrere il timer di 20 minuti. Paghi solo se il codice arriva; la scadenza o l'annullamento rimborsano automaticamente l'intero importo.
• La rotta è accettata? Telegram può rifiutare alcuni numeri virtuali. Non dipende da noi ed è esattamente il motivo per cui esiste la regola del rimborso.
• Riprova con calma. Ordina di nuovo più tardi o in un altro paese; non rifare l'ordine in un ciclo serrato, che non aiuta né la consegna né il tuo limite di richieste.
• Controlla il prefisso sul dispositivo. Una discrepanza tra il paese selezionato e il numero è un errore facile nei test manuali.

Quando è meglio un Dedicated Number per Telegram?

Un numero monouso dell'OTP Gateway va bene per i test di registrazione. Se l'account Telegram dovrà accedere di nuovo il mese prossimo, ad esempio un account di team che gestisce un canale di assistenza o l'accesso admin di un bot, serve un numero che il tuo team controlli ancora. I Dedicated Number negli Stati Uniti e in Canada, da $1.95/mese, restano tuoi finché si rinnovano e inoltrano gli SMS in entrata alla dashboard e al tuo webhook come number.sms_received. Il confronto tra numeri temporanei e dedicati spiega i compromessi.

Come si presenta un test Telegram responsabile?

Rispetta i termini di servizio di Telegram. Crea un account per ogni persona reale o scopo aziendale, usalo per i tuoi prodotti, bot e attività, e mai per spam, creazione di account in massa o per aggirare un ban. Ogni ordine Telegram che effettui rientra inoltre nell'Acceptable Use Policy di OTP Route. Telegram è un marchio del suo titolare e OTP Route non è affiliata a esso.

Domande frequenti

Posso ottenere un codice di verifica Telegram senza usare il mio telefono personale?

Sì. Ordina un numero Telegram dall'OTP Gateway di OTP Route, inseriscilo nell'app e leggi il codice SMS nella dashboard o tramite l'API.

Qual è l'id del servizio Telegram nell'API?

È telegram. Abbinalo a un id paese preso da GET /api/v1/countries quando crei un'attivazione.

Quanto costa la verifica SMS di Telegram per i test?

Da $0.20 a codice; il prezzo preciso dipende dal paese e viene restituito in tempo reale dall'endpoint dei prezzi.

Perché Telegram ha inviato il codice dentro l'app invece che via SMS?

Telegram consegna i codici di accesso a una sessione esistente quando ce n'è una disponibile. Usa un numero nuovo e un dispositivo senza sessioni attive per testare il percorso via SMS.

Posso riutilizzare un numero monouso per rientrare in Telegram più avanti?

No, i numeri dell'OTP Gateway servono per un solo codice. Per accessi ripetuti usa un Dedicated Number negli Stati Uniti o in Canada.

Mi viene addebitato qualcosa se Telegram rifiuta il numero?

No. Se entro 20 minuti nessun codice raggiunge il numero, oppure annulli, l'intero importo torna nel tuo wallet.

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.