Crea ora

Come ottenere l'accesso all'API di Telegram: api_id, api_hash e token dei bot

Guida alle API di Telegram

Come ottenere l'accesso all'API di Telegram: api_id, api_hash e token dei bot

Il API di Telegram non è una sola API, sono tre: la Bot API, la Client API (MTProto) e la Gateway API. Questa guida ti mostra esattamente dove recuperare le tue credenziali, cosa api_id, api_hash e un token di bot di BotFather a ogni sblocco, e la terza opzione che la maggior parte delle guide salta: collegare un account utente Telegram esistente tramite Unipile senza scrivere una sola riga di codice MTProto.
Costruire con Unipile
Vedi la documentazione

hosted-auth.js
Collega un account utente Telegram esistente // Nessun api_id / api_hash da gestire autonomamente const collegamento = await unipilo.autenticazione gestita.create({   fornitori ["TELEGRAMMA"],   scadeil "2026-12-31T23:59:59.000Z" }); // L'utente effettua l'accesso con codice QR o con la propria sessione // Lo stato dell'account diventa "connesso"
account.status: "connesso"
Iniziare

Le 3 API di Telegram e quale ti serve

La maggior parte delle guide parla "dell'API di Telegram" come se fosse una cosa sola. Non è così. Telegram offre tre API distinte, ognuna con le proprie credenziali, le proprie regole e i propri limiti. Scegliere quella sbagliata è il modo più veloce per sprecare una settimana a sviluppare sulla porta sbagliata.

API Bot

Hai bisogno di un bot automatizzato che reagisca a comandi e messaggi?
Necessità: un token del bot da BotFather
  • API HTTP, nessuna conoscenza di MTProto richiesta
  • Agisce come un account bot, non come un essere umano
  • Gratuito

API Client (MTProto)

Hai bisogno di creare un client completo che agisca come un vero utente di Telegram?
Necessità: api_id + api_hash da my.telegram.org
  • Protocollo MTProto raw, tu implementi il client
  • Funziona come un account utente reale
  • Gratuito, un api_id per numero di telefono

Gateway API

Ti serve solo inviare codici di verifica per l'autenticazione tramite numero di telefono?
Necessità: un account Gateway API
  • Solo invio di OTP, nessun messaggio generale
  • Lanciato separatamente da Bot API e Client API
  • Fuori dall'ambito di questa guida
Nessuno di questi va bene
Evita di costruire il tuo client MTProto
Unipile collega un account utente Telegram esistente tramite la funzione Dispositivi di Telegram, l'accesso con codice QR o l'autenticazione ospitata. Nessun api_id, nessun api_hash, nessuna limitazione dei bot.
Costruiscilo con Unipile
Client API / MTProto

Ottieni le tue credenziali API di Telegram: api_id e api_hash

Questo è il vero percorso per "ottenere le API di Telegram" che la maggior parte delle persone cerca e non trova mai documentato chiaramente: my.telegram.org, sezione Strumenti di sviluppo API. Ecco la passeggiata esatta, da un capo all'altro.
1
Vai su my.telegram.org e accedi
È necessario un account Telegram attivo, verificato con lo stesso numero di telefono con cui ti autenticherai. Inserisci il tuo numero di telefono e il codice di accesso inviato alla tua app Telegram.
2
Apri "Strumenti di sviluppo API"
Questa sezione si trova nelle impostazioni del tuo account su my.telegram.org. È l'unico luogo ufficiale in cui Telegram rilascia le credenziali per le API client.
3
Compila il modulo di domanda
Titolo dell'app, nome breve e piattaforma. Questi campi descrivono l'applicazione che utilizzerà MTProto e non devono necessariamente corrispondere al nome di un prodotto pubblico.
4
Ottieni il tuo api_id e api_hash
Telegram emette la coppia immediatamente. api_id è un identificatore numerico, api_hash è il segreto di abbinamento. Memorizzali entrambi come qualsiasi altra credenziale, autenticano il tuo client MTProto contro i server di Telegram.
Un vincolo attorno a cui pianificare
Un numero di telefono può contenere un solo api_id. Se hai bisogno di più app o di più ambienti, ti servono più numeri di telefono o devi riutilizzare lo stesso api_id in tutta la codebase. Non esiste una modalità self-service per emettere un secondo api_id sullo stesso numero.

.env
# Da my.telegram.org, strumenti di sviluppo API TELEGRAM_API_ID=1234567 TELEGRAM_API_HASH=0123456789abcdef0123456789abcdef # Un solo api_id per numero di telefono; conservarlo in modo sicuro
Configura invece la connessione del tuo account con Unipile
API Bot

Ottieni un token del bot tramite BotFather

L'altro percorso per accedere all'API di Telegram non richiede alcun account my.telegram.org, né api_id, né api_hash. Funziona interamente all'interno di una chat con il bot ufficiale di Telegram, @BotFather.
1
Apri una chat con @BotFather
Cerca "BotFather" su Telegram. È il bot ufficiale che Telegram utilizza per rilasciare e gestire qualsiasi altro bot sulla piattaforma.
2
Inviare /newbot
BotFather ti guida nella creazione di un nuovo bot direttamente nella chat, senza dashboard o moduli.
3
Scegli un nome e un nome utente
Il nome visualizzato può essere qualsiasi. Il nome utente deve essere unico e terminare con bot, per esempio mio_bot_di_supporto.
4
Copia il token del bot
BotFather risponde subito con il tuo token. Tienilo segreto, autentica ogni chiamata alle API di Bot effettuata dal tuo bot.

L'attuale API del Bot è versione 10.2, pubblicato il 14 luglio 2026 (fonte: core.telegram.org/bots/api). Qualsiasi token di bot funziona con questa stessa API HTTP con versione.

terminale
# Verifica il token del tuo bot tramite l’API Bot ricciolo "https://api.telegram.org/bot/getMe" # Esempio di risposta {   "va bene vero,   "risultato {     "ID 123456789,     "is_bot": vero,     "nome utente": "my_support_bot"   } }
Confronto

Cosa ti permette di fare realmente ciascuna API di Telegram

Quattro modi per toccare Telegram, quattro insiemi di permessi molto diversi. Ecco a cosa si collega ciascuno, di quali credenziali ha bisogno e dove si ferma.
CriteriAPI BotAPI Client (MTProto)Gateway APIUnipile
Cosa colleghiUn account botUn account utente reale per cui realizzi il clientNiente, solo consegna OTPUn account utente reale esistente
Credenziali necessarieToken del bot di BotFatherapi_id + api_hash da my.telegram.orgAccount Gateway APIAccesso con codice QR o Autenticazione ospitata (fornitori: "TELEGRAM")
Invia/riceve come un account umanoNo, agisci come un botSìNoSì
Implementazione di MTProtoNon necessario, solo HTTPTe lo costruisci da soloNon applicabileGestito da Unipile
Gestione dei partecipanti al gruppoLimitato ai permessi del botPieno, se lo costruisciNon applicabileOttieni, aggiungi, rimuovi partecipanti
Complessità di configurazioneBassoCiao, possiedi il client MTProtoBassoBasso, nessun MTProto da mantenere
CostoGratuitoGratuitoNon trattato in questa guidaIncluso nel tuo piano Unipile
Rischio di ban per abusoRevoca del tokenDivieto permanente di flooding/spamNon applicabileMitigato con le linee guida sul limite di frequenza di Unipile
API Bot
Si collegaUn account bot
CredenzialiToken del bot (BotFather)
Agisci come un essere umanoNo
ImpostazioneBasso
CostoGratuito
API Client (MTProto)
Si collegaUn account utente reale (cliente fai-da-te)
Credenzialiapi_id + api_hash
Agisci come un essere umanoSì
ImpostazioneMTProto auto-costruito
CostoGratuito
Gateway API
Si collegaNiente, solo consegna OTP
CredenzialiAccount Gateway API
ImpostazioneBasso
AmbitoFuori da questa guida
Unipile
Si collegaUn account utente reale esistente
CredenzialiCodice QR o Autenticazione Ospitata
Agisci come un essere umanoSì
ImpostazioneBasso, nessun MTProto da mantenere
GruppiOttieni / aggiungi / rimuovi partecipanti
Cosa non copre Unipile su Telegram
Canali, community e trasmissioni, tema della chat, chat segrete, allegati di contatto / posizione / sondaggio / evento, amministrazione del gruppo (approva, promuovi, revoca), eliminazione della chat, archiviazione e chiamate vocali o video. Unipile collega l'account, non replica ogni singola funzionalità del client Telegram.
Costruisci la tua integrazione di Telegram con Unipile
Prezzi e limiti

È gratuito. Ecco dove si interrompe.

Sia la Bot API che la Telegram API (MTProto) sono gratuite. Non ci sono fatture, tariffe per messaggio o credenziali bloccate da livelli a pagamento. Il risvolto non riguarda i soldi, ma il comportamento.
Inondazioni, spam e contatori falsi
L'invio troppo rapido, l'invio di messaggi di massa a utenti non correlati o l'aumento artificiale dei contatori di visualizzazioni e reazioni sono il modo più veloce per attivare un banpermanente, sia sull'API del Bot che sull'API del Client.
I client non ufficiali sono monitorati
Qualsiasi client creato con il tuo api_id e api_hash è posto automaticamente sotto osservazione dai sistemi di Telegram. I pattern insoliti vengono segnalati più velocemente che sulle app ufficiali.
Le linee guida di Unipile per passare inosservati
Evita account Telegram nuovi di zecca per l'automazione, scaldali come qualsiasi altro canale
Aumentare progressivamente il volume dei messaggi anziché iniziare alla massima velocità
Mantieni almeno 10-20 secondi tra i messaggi inviati dallo stesso account
Crea flussi di messaggistica più sicuri con Unipile
L'approccio Unipile

La terza via: collega un account Telegram esistente

Né la Bot API né un client MTProto autocostruito. L'API Telegram di Unipile collega un account utente Telegram esistente, tramite lo stesso Telegram Dispositivi funzionalità, lo stesso meccanismo che ti consente di usare Telegram su un nuovo telefono o su un'app desktop.
L'accesso avviene tramite un Scansione codice QR, o attraverso Autorizzazione in hosting con fornitori: "TELEGRAM" se desideri un flusso di connessione con marchio personalizzato all'interno del tuo prodotto. Una volta connesso, l'account si comporta come se stesso: non è un bot e non ha bisogno di un api_id o di un api_hash rilasciati da my.telegram.org.
Questo è importante perché rimuove le due parti più difficili della costruzione autonoma sull'API di Telegram: l'implementazione di MTProto e la gestione delle sessioni e delle riconnessioni quando un dispositivo viene rimosso. Se il dispositivo Unipile viene rimosso dalle sessioni Telegram dell'account, Unipile lo rileva e lo stato dell'account passa semplicemente a disconnesso, pronto per essere ricollegato.
Invia e ricevi messaggi diretti come l'account reale
Gestisci i partecipanti al gruppo: visualizza, aggiungi, rimuovi
Nessun canale, community o broadcast
Nessuna amministrazione di gruppo (approvazione, promozione, revoca), nessuna chiamata o videochiamata
Come inviare un messaggio Telegram con l'API
Pagina prodotto API Telegram di Unipile
Inizia a costruire con Unipile

Account collegato
FornitoreTelegram
Metodo di autenticazioneCodice QR / Autenticazione ospitata
Statocollegato
Dispositivo rimosso da Telegramdisconnesso
Risincronizzazione supportataSì
Casi d'uso

Casi d'uso di CRM e ATS per l'API di Telegram

Una volta che un account Telegram è collegato come account reale associato, anziché come bot, due casi d'uso emergono ripetutamente tra i clienti di Unipile: i team di vendita che centralizzano le conversazioni e i recruiter che contattano i candidati dove già si trovano.

CRM: unificare le conversazioni di Telegram

I team di vendita e supporto che comunicano già con lead e clienti su Telegram non vogliono un'app separata per farlo. Collegando l'account tramite Unipile, ogni conversazione di Telegram arriva nella stessa casella di posta delle conversazioni email, LinkedIn o WhatsApp, associata al giusto record di contatto nel CRM.
Posta in arrivo unificataConti collegatiSincronizzazione dei contatti

ATS: raggiungi i candidati su Telegram

Nelle regioni in cui Telegram è un canale di messaggistica principale, i recruiter collegano il proprio account Telegram per raggiungere i candidati direttamente dall'ATS, mantenere l'intera cronologia dei messaggi nel profilo del candidato e trasferire le conversazioni tra recruiter senza perdere il contesto.
Ricerca di candidatiCronologia dei messaggiPassaggio di consegne al team
Client API / MTProto

Accedi con un codice QR: il flusso Dispositivi, passo dopo passo

Il login tramite codice QR è il meccanismo alla base di Telegram Dispositivi funzionalità, la stessa che usi per aggiungere Telegram Desktop o Telegram Web al tuo account. È anche il flusso su cui opera Unipile per tuo conto quando connette un account utente Telegram esistente. Se lo costruisci da solo, stai implementando un handshake bidirezionale tra il dispositivo che già considera attendibile l'account e il dispositivo che chiede di unirsi ad esso, non una semplice chiamata di richiesta/risposta. Ecco esattamente cosa succede tra le due app, metodo per metodo.
1
Richiedi un token di accesso
Il dispositivo che desidera effettuare l'accesso chiama auth.exportLoginToken. Telegram risponde con un auth.loginToken: un token binario più una scadenza, in genere 30 secondi.
2
Codificalo in un codice QR
Il token è codificato in base64url e inserito all'interno di un tg://login?token=<base64url> URL. Quell'URL è ciò che viene visualizzato sullo schermo come codice QR scansionabile.
3
Scansione da un'app già connessa
L'applicazione Telegram già autenticata scansiona il codice e chiama auth.acceptLoginToken con il token decodificato.
4
Sondaggio sul risultato
Il dispositivo che sta effettuando l'accesso riceve un aggiornaTokenDiAccesso aggiorna, poi chiama auth.exportLoginToken di nuovo per recuperare il risultato della scansione.
5
Conferma o migra il data center
Se il data center corrisponde, Telegram restituisce auth.loginTokenSuccess, il login è stato eseguito. Se non corrisponde, la risposta è auth.loginTokenMigrateTo, e il cliente deve chiamare auth.importLoginToken con lo stesso token rispetto al data center indicato.

flusso di accesso tramite QR
Dispositivo che richiede l'accesso auth.exportLoginToken(api_id, api_hash) // -> auth.loginToken { token, expires } // Visualizzato come codice QR tg://login?token=<base64url(token)> Il dispositivo già autenticato lo scansiona auth.acceptLoginToken(token) Il dispositivo che effettua l'accesso esegue nuovamente il polling auth.exportLoginToken() // -> auth.loginTokenSuccess // o auth.loginTokenMigrateTo { dc_id }
Finestra breve, pianifica il ritentativo
Il token è generalmente valido solo per 30 secondi. Se scade prima di essere scansionato, il cliente deve chiamare auth.exportLoginToken di nuovo e genera un nuovo codice, non limitarti a riprovare quello vecchio.
TOKEN_DI_AUTENTICAZIONE_NON_VALIDO
TOKEN DI AUTENTICAZIONE SCADUTO
TOKEN_DI_AUTENTICAZIONE_GIÀ_ACCETTATO
Questo è precisamente lo scambio che Unipile esegue per tuo conto quando colleghi un account Telegram tramite il suo Dispositivi integrazione: il codice QR, lo scambio di token, la gestione del data center e il nuovo tentativo quando un token scade. Chiami un endpoint, Unipile gestisce la conversazione MTProto descritta sopra, incluso il caso in cui l'account da connettere si trovi su un data center diverso rispetto a quello con cui la tua app ha parlato inizialmente. Questa gestione del data center è facile da trascurare quando si sviluppa il flusso da zero, perché si presenta solo per un sottoinsieme di account e interrompe silenziosamente i login per quelli che ne sono interessati se auth.loginTokenMigrateTo il ramo non è gestito.
Crea il tuo flusso di accesso QR con Unipile
Client API / MTProto

Accedi tramite numero di telefono e la barriera 2FA

Il classico accesso tramite numero di telefono è il punto in cui la maggior parte dei client Telegram fatti in casa si blocca. Non perché sia complesso, ma perché il flusso si dirama silenziosamente nel momento in cui viene attivata l'autenticazione a due fattori, e la diramazione non è opzionale. Un client che implementa solo il percorso ideale (invio del codice, convalida del codice, fine) funziona perfettamente con un account di test e poi fallisce in produzione la prima volta che incontra un utente reale con una password cloud abilitata.
1
Invia il codice di accesso
auth.sendCode invia il codice al numero di telefono e restituisce un auth.sentCode oggetto contenente un hash_codice_telefonico, necessario per la prossima chiamata.
2
Valida il codice
auth.signIn controlla il codice rispetto al hash_codice_telefonico. Se il numero di telefono non ha ancora un account, Telegram restituisce registrazione autorizzazione richiesta invece di un'autorizzazione.
3
Incontrare il blocco dell'autenticazione a due fattori
Se l'autenticazione a due fattori è abilitata sull'account, auth.signIn risponde con una Errore 400: SESSION_PASSWORD_NEEDED. Questa è la risposta attesa per qualsiasi account con una password cloud, non una mancata gestione come eccezione.
4
Ottieni il via libera dall'SRP
Completare il login significa eseguire il protocollo SRP: costruire un InputCheckPasswordSRP oggetto dai parametri della password dell'account, quindi chiama auth.checkPassword. Il successo restituisce un autorizzazione; una password errata restituisce HASH_PASSWORD_NON_VALIDO.
Solo le app ufficiali ricevono gli SMS di Firebase
È consentito l'uso esclusivamente delle applicazioni mobili ufficiali di Telegram Invio del codice SMS basato su Firebase. Le applicazioni di terze parti devono instradare il codice attraverso un altro canale di consegna, oppure scrivere su sms@telegram.org per discutere dell'accesso.
Errori da aspettarsi su questo percorso
PASSWORD_SESSIONE_NECESSARIA
HASH_PASSWORD_NON_VALIDO
registrazione autorizzazione richiesta
L'integrazione Telegram di Unipile gestisce per te l'intero ramo: consegna del codice, il PASSWORD_SESSIONE_NECESSARIA verifica, e lo scambio SRP quando è impostata una password cloud, se l'account si connette tramite un numero di telefono, un codice QR o Autorizzazione in hosting. Ciò include la limitazione sulla consegna degli SMS di cui sopra: poiché le applicazioni di terze parti non possono affidarsi alla consegna basata su Firebase, questo è uno degli aspetti in cui gestire autonomamente il flusso dei numeri di telefono comporta un reale peso operativo, e non solo di codice, prima ancora di aver inviato un solo messaggio.
Limiti di invio

Limiti di velocità delle API di Telegram, in cifre

La Sezione 5 ha trattato il comportamento che porta al ban degli account. Ecco i limiti massimi documentati dal lato delle API dei bot e il costo per Eccoli.
1/sec
Numero massimo di messaggi per la stessa chat individuale
20/min
Numero massimo di messaggi all'interno di un singolo gruppo
~30/sec
Limite approssimativo per la trasmissione su chat diverse
429
Errore restituito non appena viene superato uno di questi limiti
Le trasmissioni a pagamento alzano il tetto, a due condizioni
I bot possono abilitare trasmissioni a pagamento tramite BotFather, che aumenta il limite di invio fino a 1.000 messaggi al secondo. I messaggi inviati oltre la soglia gratuita costano 0,1 Stella di Telegram ciascuno. È protetto da due requisiti a livello di account, entrambi devono essere soddisfatti contemporaneamente.
Saldo di 100.000 Stelle
100.000 utenti attivi al mese
Supera il limite individuale, di gruppo o broadcast e l'API Bot risponde con 429 lo stato coperto nel riferimento errore sotto, insieme al 420 FLOOD e ATTESA_ALLAGAMENTO_X codici usati dal lato MTProto. Entrambi i meccanismi esistono per lo stesso motivo: farti rallentare prima che Telegram decida di rallentarti per te.

Questi numeri sono specifici delle API dei Bot. Per un connesso account utente, non esiste un limite massimo pubblicato, ma solo le linee guida sul ritmo di Unipile descritte in è gratis, ecco dove ci sono problemiriscalda i nuovi account, aumenta progressivamente il volume, mantieni almeno 10 o 20 secondi tra un messaggio e l'altro.
Riferimento errore

Errori delle API di Telegram che devi conoscere

Gli errori MTProto seguono la stessa forma a tre cifre dei codici di stato HTTP che la maggior parte degli sviluppatori già riconosce, abbinati a una breve stringa leggibile da una macchina. Ecco la tabella di riferimento, più un errore che appare solo per gli utenti finali, non per voi. Conoscere questo elenco prima di effettuare il rilascio è più importante che farlo dopo: diversi di questi codici, 303 e 420 in particolare, non sono errori eccezionali, fanno parte delle normali condizioni operative di un client MTProto e devono essere gestiti nel percorso del codice, non registrati e ignorati.
CodiceSignificato
303 VEDI_ALTROLa richiesta deve essere ripetuta, puntando a un data center diverso.
400 RICHIESTA_NON_VALIDALa query contiene errori. API_ID_NON_VALIDO è un esempio comune di questo codice.
401 NON AUTORIZZATOIl metodo richiede una funzionalità riservata agli utenti autorizzati.
403 FORBIDDENViolazione della privacy, ad esempio cercando di scrivere a un utente che ti ha bloccato.
404 NON_TROVATOL'oggetto o il metodo richiesto non esiste.
420 FLOOD / FLOOD_WAIT_XÈ stato superato il numero massimo di chiamate consentite, attendi X secondi prima di riprovare.
303 VEDI_ALTROLa richiesta deve essere ripetuta, puntando a un data center diverso.
400 RICHIESTA_NON_VALIDALa query contiene errori. API_ID_NON_VALIDO è un esempio comune di questo codice.
401 NON AUTORIZZATOIl metodo richiede una funzionalità riservata agli utenti autorizzati.
403 FORBIDDENViolazione della privacy, ad esempio cercando di scrivere a un utente che ti ha bloccato.
404 NON_TROVATOL'oggetto o il metodo richiesto non esiste.
420 FLOOD / FLOOD_WAIT_XÈ stato superato il numero massimo di chiamate consentite, attendi X secondi prima di riprovare.
Un altro, dal lato dell'utente finale
API_ID_PUBBLICATO_FLOOD viene visualizzato per gli utenti finali quando un'applicazione pubblicata riutilizza l'esempio api_id spedito all'interno di codice di esempio open-source anziché richiederne uno proprio. Ogni applicazione che pubblichi ne ha bisogno di uno proprio api_id e api_hash da my.telegram.org.
Un client basato direttamente sulla Client API (MTProto) deve gestire autonomamente ciascuno di questi codici: riprovare sul data center corretto su 303, fai un passo indietro rispetto a 420, e trattare 401 e 403 come segnali sullo stato dell'account piuttosto che come errori generici. La connessione di un account esistente tramite Unipile sposta la gestione di tali errori dietro lo stato di un singolo account collegato, anziché un insieme di codici MTProto che il tuo codice deve interpretare correttamente a ogni chiamata.
Client API / MTProto

Scelta di una libreria MTProto e cosa non farà per voi

Se decidi di costruire tu stesso il percorso delle API client, non stai implementando MTProto da una specifica tecnica. Una manciata di librerie parla già il protocollo, quindi il client in sé è raramente la parte difficile. Sceglierne una risolve solo una parte del problema, e la parte che risolve è solitamente la più piccola.
Pitone

Telethon

Un'implementazione MTProto in puro Python, basata su async/await, con un'API client che risulta simile a Python semplice anziché a chiamate di protocollo grezze.
Pitone

Pyrogram

Un altro client Python MTProto, con una propria gestione delle sessioni e un'interfaccia pensata per assomigliare più a un SDK convenzionale che a una libreria di protocollo.
Node.js

GramJS

Il equivalente più vicino a Telethon per codebase JavaScript e TypeScript, che implementa la stessa conversazione MTProto per un runtime Node.js.
Ufficiale

TDLib

La libreria ufficiale di Telegram, scritta in C++, con binding esposti per diversi linguaggi. Implementa l'intero stack MTProto nello stesso modo in cui fanno le app ufficiali di Telegram.
La scelta di solito dipende dallo stack che si sta già utilizzando piuttosto che da un confronto di funzionalità: un backend in Python fa pensare a Telethon o Pyrogram, un backend in Node.js o TypeScript punta verso GramJS, e un team che vuole rimanere il più vicino possibile alle app ufficiali di Telegram punta verso TDLib e dei relativi legami. Nessuna di queste opzioni rimuove la seconda metà dell'opera sottostante.
Ciò che una biblioteca ti offre
Il livello di cifratura MTProto e le chiamate ai metodi grezzi
Aggiornamento della gestione per gli eventi in arrivo dai server di Telegram
Un'API lato client per chiamare i metodi di autenticazione, messaggistica e account
Ciò che ti costruisci ancora da solo
Mantenere le sessioni in modo affidabile tra i riavvii e i rilasci
Gestire il flusso SESSION_PASSWORD_NEEDED e SRP end-to-end per i vostri utenti
Riconnessione graduale e tracciamento dello stato dell'account quando un dispositivo viene rimosso
Oppure salta completamente il cliente
Unipile gestisce già il client MTProto per te
La persistenza della sessione, la barriera del 2FA, la riconnessione e il ciclo di vita dell'account sono gestiti tramite un'unica API. Colleghi un account Telegram esistente, non mantieni alcuna libreria.
Costruisci con Unipile

API di Telegram: Domande Frequenti

Risposte chiare su api_id, api_hash, token dei bot di BotFather e connessione di un account Telegram esistente con Unipile.

Telegram non ha una sola API, ne ha tre. Le Bot API sono un'interfaccia HTTP per gli account bot. Le Telegram API, chiamate anche Client API, funzionano sul protocollo MTProto e sono ciò su cui sono costruiti i client Telegram completi. Le Gateway API inviano solo codici di verifica. Di quale hai bisogno dipende dal fatto che tu stia automatizzando un bot o agendo come un vero account utente.
Non esiste un'unica chiave API di Telegram. Per l'API Client si effettua l'accesso su my.telegram.org, si aprono gli strumenti di sviluppo API e si compila il modulo per ricevere un api_id e un api_hash. Per l'API Bot si invia un messaggio a BotFather all'interno di Telegram e questo restituisce un token del bot. Nota che Telegram consente un solo api_id per numero di telefono.
Sì. Telegram afferma che sia le Bot API che le Telegram API sono utilizzabili gratuitamente, senza alcun costo per messaggio. Il costo reale risiede nell'infrastruttura che gestisci, nella gestione delle sessioni e nel rischio di un divieto se invii messaggi in modo aggressivo.
L'API Bot è una semplice interfaccia HTTPS: si richiamano metodi come sendMessage su api.telegram.org con il token del proprio bot. L'API Client è un protocollo binario MTProto, motivo per cui la maggior parte degli sviluppatori utilizza una libreria come Telethon, Pyrogram o GramJS invece di implementarla autonomamente.
Bot API 10.2, pubblicato il 14 luglio 2026. È seguito al 10.1 l'11 giugno 2026 e al 10.0 l'8 maggio 2026.
Sì. È possibile collegare un account Telegram esistente tramite la funzione Dispositivi di Telegram, che è il modo in cui Unipile collega gli account, utilizzando l'accesso tramite codice QR o un flusso di autenticazione ospitato. Si ottiene l'accesso all'account utente senza dover implementare autonomamente MTProto, l'archiviazione delle sessioni o la gestione dell'autenticazione a due fattori.

Avete ancora domande? Il nostro team è qui per aiutarvi.

Parlare con un esperto
API di Telegram, fatte bene

Crea la tua integrazione con l'API di Telegram con Unipile

Salta il client MTProto e ignora le limitazioni dei bot. Connetti un account Telegram esistente tramite Unipile e unificalo con WhatsApp, LinkedIn, Instagram, Gmail, Outlook e IMAP in un'unica API.
Costruire con Unipile
Leggi la documentazione Vedi la pagina delle API di Telegram
Invia un messaggio Telegram con l'API
Pagina prodotto API Telegram di Unipile
it_ITIT
en_USEN fr_FRFR es_ESES de_DEDE pt_BRBR nl_NLNL pl_PLPL tr_TRTR it_ITIT