Telegram
Un offerwall per la sua Mini App e il suo bot Telegram.
I suoi utenti guadagnano le sue monete completando offerte e lei guadagna per ogni offerta completata. Una Mini App è una pagina web, quindi non serve un SDK: il suo server firma il link di ogni utente e accredita le monete dai postback firmati.
- Nessun SDKUna Mini App è una pagina web
- Offerte mirateIn base a paese e dispositivo
- Postback firmatoper ogni accredito
Come si aggiunge un offerwall a una Mini App o a un bot Telegram?
Invii l’initData della Mini App al suo backend e lo convalidi con il token del suo bot. Associ l’utente Telegram a un suo ID account e costruisca il link firmato all’offerwall sul suo server. La Mini App apre quel link con Telegram.WebApp.openLink quando l’utente tocca Earn, oppure un bot lo invia come pulsante nella chat privata. Il suo backend accredita le monete solo quando arriva un postback firmato e le rimuove in caso di storno.
Come funziona per Telegram.
Dal primo clic alla ricompensa nella sua valuta, in cinque passaggi.
L’utente tocca Earn
Nella sua Mini App, oppure dopo che /earn o un link ?start= dal suo canale apre una chat privata con il suo bot.
Il suo server verifica l’utente
Convalida initData con il token del suo bot, trova l’account dell’utente e firma un link all’offerwall per quell’ID account.
Si apre l’offerwall
openLink lo apre nel browser dell’utente mentre la Mini App resta aperta. Le offerte corrispondono al paese e al dispositivo dell’utente.
L'utente completa un'offerta
Installa un’app, si registra o raggiunge un livello in un gioco. L’inserzionista conferma ogni passaggio completato.
Le monete arrivano nel saldo
Un postback firmato raggiunge il suo server, che accredita le monete una sola volta per ID transazione. La Mini App ricarica il saldo.
Perché i gestori di progetti Telegram aggiungono Moonetix.
Una rete di affiliazione costruita intorno alla sua valuta e ai suoi utenti.
Nessun SDK per le Mini App
Una Mini App è una sua pagina web, quindi il link firmato all’offerwall è l’intera integrazione. Funziona allo stesso modo in un normale bot.
La sua moneta, il suo tasso
Imposti per ogni app nome e icona della valuta, unità per $1, quota per gli utenti e arrotondamento, così le offerte pagano nelle stesse monete che il suo gioco tap o il suo bot già usa.
Pensato per saldi lato server
Ogni accredito e ogni storno raggiunge il suo server come postback firmato. Le monete non passano mai dalla Mini App, quindi i client modificati non possono aggiungerle.
Convive con Stars
Gli utenti che pagano possono acquistare monete con le Stars, e quelli che non pagano mai possono guadagnare le stesse monete tramite le offerte. Consulti Stars e offerwall a confronto.
Veda quale post ha reso
Inserisca una fonte nel payload
?start=, la passi come sub ID e veda clic, conversioni e storni per sub ID, paese e offerta.Filtri antifrode sull’offerwall
Gli utenti su VPN, proxy, Tor o reti di data center vengono bloccati sull’offerwall, e un report sulla qualità del traffico mostra come convertono i suoi utenti.
Da un post del canale a un link privato.
I link firmati appartengono a un solo utente, quindi non vanno mai in un post pubblico. Il post apre il suo bot e il bot invia a ogni utente il proprio link.
- Post del canaleUn pulsante verso t.me/yourbot?start=earn
- Il suo botRiceve /start earn in una chat privata
- Il suo serverFirma il link all’offerwall per quell’utente
- Mini App o browserL’utente completa offerte e guadagna monete
import crypto from 'node:crypto';
export function isValidInitData(initData, botToken) {
const params = new URLSearchParams(initData);
const hash = params.get('hash');
if (!hash) return false;
params.delete('hash');
const dataCheck = [...params.entries()]
.sort(([a], [b]) => (a < b ? -1 : 1))
.map(([k, v]) => `${k}=${v}`)
.join('\n');
const secret = crypto.createHmac('sha256', 'WebAppData')
.update(botToken).digest();
const expected = crypto.createHmac('sha256', secret)
.update(dataCheck).digest('hex');
return expected.length === hash.length &&
crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(hash));
}Verificare initData sul server
La documentazione delle Mini App di Telegram indica di convalidare
initDatacon il token del bot e di non fidarsi mai diinitDataUnsafe.Rifiutare i dati vecchi
Confronti anche
auth_datecon l’ora attuale, così una vecchia copia dei dati non può essere riutilizzata.Poi firmare il link all’offerwall
Nel link firmato all’offerwall usi il suo ID account per quell’utente Telegram e accrediti le monete solo dai postback.
Fonte: documentazione delle Telegram Mini Apps, verificata il 5 novembre 2026. Guida completa: offerwall in una Telegram Mini App.
Rispetti le regole di Telegram.
Non abbiamo trovato alcuna regola di Telegram che citi gli offerwall, né a favore né contro, quindi consideri queste regole come applicabili, non come un’approvazione. Telegram può modificare i suoi termini e rimuovere un bot o una Mini App.
Da fare
- Convalidi
initDatasul suo server con il token del bot, controlliauth_datee non si fidi mai diinitDataUnsafeo di un ID utente inviato dal client. - Colleghi i post del canale al suo bot con un parametro
?start=e lasci che il bot risponda nella chat privata con il link firmato personale di quell’utente. - Pubblichi in @BotFather un’informativa sulla privacy che indichi che indirizzo IP, dispositivo e attività sulle offerte arrivano al fornitore dell’offerwall, come richiedono i termini per sviluppatori.
- Venda monete o boost nel bot o nella Mini App solo in cambio di Telegram Stars. Guadagnare monete con le offerte non è una vendita, ma venderle lo è.
Da non fare
- Non pubblichi mai un link firmato all’offerwall in un canale o in un gruppo. Accredita la persona per cui è stato creato, quindi ogni utente deve ricevere il proprio link in privato.
- Non invii offerte a tutti quelli che hanno premuto Start almeno una volta. I termini per sviluppatori di Telegram vietano lo spam agli utenti con messaggi non richiesti.
- Non prometta airdrop di token o guadagni che gli utenti non possono raggiungere. La sezione 5.2 vieta di indurre gli utenti con l’inganno ad azioni per un risultato irraggiungibile.
- Non indirizzi gli utenti della Mini App verso cripto non TON. La sezione 7.4 vieta di promuovere criptoattività non basate su TON, quindi nasconda queste offerte nella sua pagina "Offerte".
Fonti, verificate il 5 novembre 2026: Telegram Bot Platform Developer Terms, Telegram Mini Apps documentation, Telegram bot deep linking. Le regole delle piattaforme cambiano, quindi le verifichi prima del lancio.
Lo configuri in quattro passaggi.
Candidati come publisher
Invii la candidatura e ci parli della sua Mini App, del suo bot o del suo canale. Ogni candidatura viene esaminata manualmente e, una volta approvato, le app che aggiunge sono subito attive.
Aggiungere la Mini App o il bot
Imposti nome e icona della moneta, tasso di conversione, quota per gli utenti e design dell’offerwall nell’anteprima dal vivo. Copi App ID e salt dell’hash dei link nella configurazione del server, mai nella Mini App.
Firmare i link sul server
Dopo aver convalidato
initData, costruisca il link a partire dal suo ID account. Lo apra conopenLinkal tocco, oppure lo invii come pulsante URL nella chat privata del bot.Accrediti dai postback, poi faccia un test
Salvi il suo URL di postback, accrediti con lo status 1 una sola volta per ID transazione e storni con lo status 2. Poi esegua un test end-to-end da una connessione normale.
Scelga la sua integrazione
- Sito webUn link, un iframe o un pulsante Earn flottante. Nessun SDK necessario.
- Offers APIRiceva le offerte in JSON e le mostri con il suo design.
- Documentazione per sviluppatoriLink, postback e test.
Parta da un template
Quanto potrebbe guadagnare?
Sposti il cursore sul suo pubblico e modifichi le ipotesi. I tassi sono un esempio, non una promessa: posizionamento, paesi e dispositivi influiscono su ogni risultato.
Guide per Telegram.
Guide passo passo dalla Moonetix Academy.
Domande su Telegram
Cosa chiedono i gestori di progetti Telegram prima di aggiungere Moonetix.
Ha ancora una domanda? Ci contatti
Telegram consente gli offerwall nelle Mini App?
Nei termini per sviluppatori e per le Mini App di Telegram non abbiamo trovato alcuna regola che citi gli offerwall, né a favore né contro. Si applicano però le regole su privacy, spam, inganno degli utenti, pagamenti in Stars e cripto solo TON, quindi legga le Bot Platform Developer Terms aggiornate prima del lancio.
Mi serve un SDK per un offerwall in una Mini App Telegram?
No. Una Mini App è una pagina web, quindi il suo server firma il link all’offerwall e la Mini App lo apre. Gli SDK di Moonetix sono per app native Android, iOS, Unity, Flutter e React Native.
Un bot Telegram senza Mini App può usare un offerwall?
Sì. Un comando /earn può rispondere nella chat privata con un pulsante URL che contiene il link firmato dell’utente, e l’offerwall si apre nel browser. Il backend del suo bot conserva il saldo e lo accredita dai postback.
Come monetizzo un canale Telegram con un offerwall?
Un canale non può ospitare l'offerwall. Colleghi i suoi post al suo bot con un parametro ?start=, e il bot invia a ogni lettore il suo link firmato personale. La guida Monetizzare un canale Telegram tratta anche i programmi di Telegram.
Come usa un offerwall un gioco tap-to-earn?
Le offerte pagano negli stessi punti per cui i giocatori fanno tap, accreditati dal suo server tramite postback firmati. Mantenga i punti virtuali con termini chiari invece di promettere un token, come spiega la guida tap-to-earn.
Devo usare openLink o un iframe?
openLink apre l’offerwall nel browser dell’utente e lascia aperta la Mini App. Un iframe si carica solo sul sito web registrato per la sua app, e i client web di Telegram mostrano le Mini App in un frame, quindi lì può non funzionare.
Posso vendere monete in cambio di Stars e offrire anche un offerwall?
Sì, molti bot fanno entrambe le cose. I beni digitali venduti in un bot o in una Mini App devono essere pagati in Telegram Stars, mentre le monete guadagnate con le offerte vengono accreditate dal postback nello stesso saldo.
Perché alcuni utenti non vedono offerte?
Le offerte dipendono dal paese e dal dispositivo dell’utente, e gli utenti su VPN, proxy, Tor o reti di data center vengono bloccati sull’offerwall. Gli utenti finali devono avere almeno 16 anni, con il permesso dei genitori sotto i 18.
Altri settori
- AppApp di fitness, IA, quiz e utilità
- GiochiGiochi mobile, Unity e HTML5
- Server di giocoMinecraft, Rust, Hytale e altri
- DiscordServer, bot di economia e comandi /earn
- CommunityForum, siti per membri e community di fan
- WordPressPlugin gratuito, punti e WooCommerce
- Siti di ricompenseApp GPT, cashback, faucet e di ricompense
- Web app e IASaaS, strumenti di IA e web app freemium
- EstensioniChrome, Edge, Firefox e app Electron
Trasformi il suo traffico in guadagni.
Crei un account publisher gratuito e guadagni da ogni offerta che i suoi utenti completano sul suo sito web, app, gioco o community.





