“Chiavi API di Fragment”: cosa esiste davvero per Telegram Ads nel 2026
Non esiste un'API pubblica di Fragment. Quelle che vengono chiamate “chiavi API di Fragment” sono una di tre cose: il token API nel cabinet di Telegram Ads, il token di Telegram Gateway oppure servizi di terze parti che lavorano tramite la tua sessione web e la tua seed phrase. Cosa fa ciascuna e dove sono i rischi.
Contents
"Ora Fragment permette di generare chiavi API" è un'affermazione che continua a girare nelle chat degli inserzionisti. Abbiamo verificato cosa è visibile pubblicamente al 23 settembre 2026. La risposta breve: Fragment in sé non ha un'API pubblica né chiavi API pubblicate. Quando si parla di "Fragment API", di solito si intende una di tre cose diverse, e solo due vengono da Telegram.
Cosa abbiamo verificato#
- Le pagine di Fragment. Nulla sulle chiavi API in fragment.com/about, /terms o /ads. Sulle integrazioni, le FAQ di Fragment dicono che i collezionabili vivono sulla blockchain pubblica TON, che offre "a free, distributed and secure interface for developers" (un'interfaccia gratuita, distribuita e sicura per gli sviluppatori), senza menzionare un'API propria.
- Il codice del sito. fragment.com/api è il backend del sito stesso: risponde solo a richieste legate a un cookie di sessione del browser e restituisce pezzi dell'interfaccia web. Non è un'API per sviluppatori.
- Gli annunci di Telegram. Nessuna menzione di chiavi API di Fragment sul blog di Telegram o sui canali ufficiali fino al 23 settembre 2026.
Quello che succede dietro un account Fragment con accesso effettuato non si può verificare dall'esterno. Se Fragment lancerà un'API per sviluppatori, la prima traccia pubblica sarà con ogni probabilità una modifica ai suoi termini.
1. Il token API nel cabinet di Telegram Ads#
È il candidato ufficiale più probabile. Il codice del cabinet su ads.telegram.org contiene una schermata API: un token da copiare, un pulsante per revocarlo ed emetterne uno nuovo e un campo per una allow-list di indirizzi IP. A giudicare dal codice, il token appartiene a uno specifico account pubblicitario. Questa schermata esiste almeno da aprile 2024.
Cosa non è pubblico:
- La documentazione. I metodi sono descritti solo agli utenti che hanno effettuato l'accesso; nulla è pubblicato apertamente.
- Chi ottiene l'accesso. Secondo fonti di settore, l'API di Telegram Ads è disponibile per i rivenditori diretti (direct sellers) (ppc.world, giugno 2025); molti strumenti di automazione per gli inserzionisti comuni funzionano invece ancora tramite un'estensione del browser.
Cosa probabilmente ti dà: dati e gestione del tuo account pubblicitario, cioè campagne, budget, statistiche. Non è una finestra sugli annunci di altri inserzionisti. La confusione con Fragment è comprensibile: il saldo pubblicitario stesso si ricarica tramite Fragment.
Tratta il token come una password: tienilo sul tuo server, limitalo agli indirizzi IP del tuo server nella allow-list, non incollarlo mai in chat o in strumenti di terze parti e revocalo se finisce in mani altrui.
2. Il token di Telegram Gateway#
È l'unica API a pagamento completamente documentata collegata a Fragment. Telegram Gateway invia codici di accesso e di verifica tramite Telegram anziché via SMS al costo di $0,01 per codice consegnato, con rimborso automatico per i codici non consegnati. Copi il token nell'account Gateway e ricarichi il saldo con "Add Funds on Fragment" (tutorial). Il sito di Gateway dice ancora che si paga "using TON", cioè con la moneta che oggi si chiama Gram (GRAM, ex Toncoin) (gateway.telegram.org).
Non ha niente a che fare con i dati pubblicitari. Se qualcuno ti ha venduto un "accesso alla Fragment API" e hai ricevuto un token Gateway, hai ottenuto un'alternativa agli SMS, non analytics pubblicitari.
3. I servizi "Fragment API" di terze parti#
Se cerchi "Fragment API" trovi servizi a pagamento con dashboard e chiavi proprie, librerie open source e bot di Telegram. Automatizzano cose come l'acquisto di Stars e Premium o la ricarica del saldo pubblicitario. Non sono prodotti di Fragment. Tecnicamente lavorano sopra la tua sessione web di Fragment (i cookie) e, molto spesso, sopra la seed phrase del tuo wallet, perché è l'unico modo per firmare pagamenti senza la collaborazione di Fragment. Alcuni di questi strumenti inviano la seed phrase ai propri server.
I rischi, in ordine di gravità:
- Chi ha la tua seed phrase controlla il wallet. Non "può pagare gli annunci": può spostare tutto.
- Furto della sessione. Una sessione di Fragment copiata può agire sul tuo account.
- Instabilità. Ad agosto 2026 gli utenti di due popolari wrapper open source hanno segnalato nelle issue GitHub dei progetti errori 403 periodici da fragment.com; Fragment non offre né supporta l'automazione del proprio sito.
- Impersonificazione. Il 20 maggio 2026 è stato registrato un dominio sosia, frugment.com, ed esiste un canale Telegram che si fa chiamare "Fragment Official Channel". Digita fragment.com a mano.
Non tutti questi servizi sono truffe, ma nessuno è un'API ufficiale di Fragment, e un servizio che ha bisogno della tua seed phrase ti sta chiedendo il pieno controllo del tuo denaro.
Riepilogo rapido#
| Come viene chiamato | Cos'è davvero | Ufficiale? | Cosa dà | Rischio principale |
|---|---|---|---|---|
| "Chiave API di Fragment" nel cabinet pubblicitario | Token dell'API di Telegram Ads | Sì (Telegram) | Il tuo account pubblicitario | Token trapelato: usa la allow-list di IP |
| "Chiave API di Fragment" per gli SMS | Token di Telegram Gateway | Sì (Telegram) | Invio di codici di verifica | Token trapelato: spese sul tuo saldo |
| Servizio o libreria "Fragment API" | Un wrapper sopra la tua sessione web / seed phrase | No | Acquisti automatizzati | Perdita dell'intero wallet |
Se ti serve automazione oggi#
- Gestione degli annunci su larga scala: lavora tramite un rivenditore o un'agenzia con accesso all'API, oppure chiedi al tuo account manager della sezione API del tuo cabinet.
- Ricariche: falle manualmente su fragment.com dal tuo wallet; per le agenzie, Fragment permette di finanziare l'account di qualcun altro (fragment.com/ads/topup).
- Dati di mercato sugli annunci: nessuna delle tre opzioni ti dà le creatività degli altri inserzionisti. Per quello ti serve un archivio di annunci come tgadsspy.com.
FAQ#
Fragment ha un'API ufficiale? Non pubblica. Al 23 settembre 2026 non c'è nulla di annunciato né di documentato.
L'API di Telegram Ads è pubblica? No. La schermata del token esiste nel cabinet, ma la documentazione è visibile solo dopo l'accesso e, secondo fonti di settore, l'accesso è limitato ai rivenditori diretti.
È sicuro dare la mia seed phrase a un servizio che "paga gli annunci al posto mio"? No. Una seed phrase dà il pieno controllo del wallet.
Posso ottenere tramite una di queste opzioni le statistiche di Telegram Ads di altri inserzionisti? Nulla di pubblico lo fa pensare. A giudicare dal codice del cabinet, il token pubblicitario appartiene al tuo account, e il token Gateway serve solo a inviare codici.
Fonti: fragment.com/about, fragment.com/terms, fragment.com/ads, Telegram Gateway, tutorial di Gateway, gateway.telegram.org, ppc.world.
Not sure which cabinet fits?
Answer four questions about your product, billing, targeting and budget — the picker recommends the euro, Gram or Stars cabinet and explains why.
Pick a cabinetRead next
Come pagare Telegram Ads in Gram nel 2026: la ricarica passo per passo tramite Fragment
Guida pratica per finanziare il cabinet self-serve di Telegram Ads in Gram (ex Toncoin): wallet, exchange, Fragment, KYC, quanto ricaricare, a che punto è Gram Wallet e le truffe da evitare.
6 min read
Revenue share di Telegram Ads nel 2026: come vengono pagati i proprietari di canali e bot
Canali e bot incassano il 50% dei ricavi degli annunci Telegram Ads mostrati al loro interno. Chi ne ha diritto, come maturano le ricompense in Gram e Stars, come prelevarle tramite Fragment, i vincoli di 2 e 21 giorni, come disattivare gli annunci con i boost e gli altri modi per guadagnare: messaggi a pagamento e Post suggeriti.
4 min read
Come gestire una campagna di Post suggeriti su Telegram: la guida pratica per inserzionisti
Passo per passo: trovare i canali che accettano i Post suggeriti, finanziare le offerte in Stars o Gram tramite Fragment, fissare prezzo e orario, gestire controproposte ed escrow e misurare i risultati. Con i limiti e le commissioni in vigore nel 2026.
5 min read
Also available in: