Telegram
Um offerwall para seu Mini App e bot do Telegram.
Seus usuários ganham suas moedas concluindo ofertas, e você ganha por oferta concluída. Um Mini App é uma página web, então não há SDK: seu servidor assina o link de cada usuário e credita moedas a partir de postbacks assinados.
- Sem SDKUm Mini App é uma página web
- Ofertas segmentadasPor país e dispositivo
- Postback assinadoPara cada crédito
Como adicionar um offerwall a um Telegram Mini App ou bot?
Envie o initData do Mini App ao seu backend e valide-o com o token do seu bot. Associe o usuário do Telegram a um ID de conta seu e monte o link assinado do offerwall no seu servidor. O Mini App abre esse link com Telegram.WebApp.openLink quando o usuário toca em Ganhar, ou um bot o envia como botão no chat privado. Seu backend credita moedas apenas quando chega um postback assinado e as remove em caso de estorno.
Como funciona para Telegram.
Do primeiro clique até a recompensa na sua moeda, em cinco passos.
O usuário toca em Ganhar
No seu Mini App, ou depois que o /earn ou um link ?start= do seu canal abre um chat privado com o seu bot.
Seu servidor verifica o usuário
Ele valida o initData com o token do seu bot, encontra a conta do usuário e assina um link do offerwall para esse ID de conta.
O offerwall abre
O openLink o abre no navegador do usuário enquanto o Mini App continua aberto. As ofertas correspondem ao país e ao dispositivo do usuário.
O usuário conclui uma oferta
Instala um app, faz um cadastro ou alcança um nível em um jogo. O anunciante confirma cada etapa concluída.
As moedas caem no saldo
Um postback assinado chega ao seu servidor, que credita suas moedas uma vez por ID de transação. O Mini App recarrega o saldo.
Por que donos de projetos no Telegram adicionam a Moonetix.
Uma rede de afiliados construída em torno da sua moeda e dos seus usuários.
Sem SDK para Mini Apps
Um Mini App é a sua própria página web, então o link assinado do offerwall é toda a integração. Funciona do mesmo jeito em um bot simples.
Sua moeda, sua taxa
Defina o nome e o ícone da moeda, as unidades por $1, a parte do usuário e o arredondamento de cada app, para que as ofertas paguem nas mesmas moedas que o seu jogo de toque ou bot já usa.
Feito para saldos no servidor
Cada crédito e cada estorno chega ao seu servidor como um postback assinado. As moedas nunca passam pelo Mini App, então clientes alterados não conseguem adicioná-las.
Funciona junto com Stars
Usuários que pagam podem comprar moedas com Stars, e usuários que nunca pagam podem ganhar as mesmas moedas com ofertas. Veja Stars vs offerwall.
Veja qual post rendeu
Coloque uma origem no payload do
?start=, repasse-a como sub ID e veja cliques, conversões e estornos por sub ID, país e oferta.Filtros antifraude no offerwall
Usuários em VPNs, proxies, Tor ou redes de data center são bloqueados no offerwall, e um relatório de qualidade de tráfego mostra como seus usuários convertem.
De um post no canal para um link privado.
Links assinados pertencem a um único usuário, então nunca vão em um post público. O post abre o seu bot, e o bot envia a cada usuário o próprio link.
- Post do canalUm botão para t.me/yourbot?start=earn
- Seu botRecebe /start earn em um chat privado
- Seu servidorAssina o link do offerwall para esse usuário
- Mini App ou navegadorO usuário conclui ofertas e ganha moedas
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));
}Verifique o initData no seu servidor
A documentação de Mini Apps do Telegram diz para validar
initDatacom o token do bot e nunca confiar eminitDataUnsafe.Rejeite dados antigos
Compare também
auth_datecom a hora atual, para que uma cópia antiga dos dados não possa ser reutilizada.Depois, assine o link do offerwall
Use o seu próprio ID de conta para esse usuário do Telegram no link assinado do offerwall, e credite moedas apenas a partir de postbacks.
Fonte: Telegram Mini Apps documentation, conferida em 5 de novembro de 2026. Guia completo: offerwall em um Telegram Mini App.
Siga as regras do Telegram.
Não encontramos nenhuma regra do Telegram que cite offerwalls, nem a favor nem contra, então leia isto como regras que se aplicam, não como uma aprovação. O Telegram pode mudar os termos e remover um bot ou Mini App.
Faça
- Valide
initDatano seu servidor com o token do bot, confiraauth_datee nunca confie eminitDataUnsafenem em um ID de usuário enviado pelo cliente. - Nos posts do canal, coloque links para o seu bot com um parâmetro
?start=e deixe o bot responder no chat privado com o link assinado daquele usuário. - Publique no @BotFather uma política de privacidade informando que endereço IP, dispositivo e atividade nas ofertas chegam ao provedor do offerwall, como pedem os termos para desenvolvedores.
- Venda moedas ou boosts dentro do bot ou do Mini App apenas por Telegram Stars. Ganhar moedas com ofertas não é uma venda, mas vendê-las é.
Não faça
- Nunca poste um link assinado do offerwall em um canal ou grupo. Ele credita a pessoa para quem foi gerado, então cada usuário precisa receber o próprio link em privado.
- Não dispare ofertas para todo mundo que já tocou em Start. Os termos para desenvolvedores do Telegram proíbem enviar spam aos usuários com mensagens não solicitadas.
- Não prometa airdrop de tokens nem renda que os usuários não conseguem alcançar. A seção 5.2 proíbe induzir usuários a ações com um resultado inalcançável.
- Não leve usuários de Mini Apps a criptoativos fora da TON. A seção 7.4 proíbe promover criptoativos que não sejam baseados na TON, então oculte essas ofertas na sua página Offers.
Fontes, conferidas em 5 de novembro de 2026: Telegram Bot Platform Developer Terms, Telegram Mini Apps documentation, Telegram bot deep linking. As regras das plataformas mudam, então confira-as antes do lançamento.
Configure em quatro passos.
Candidate-se como publisher
Candidate-se e conte sobre seu Mini App, bot ou canal. Cada candidatura é analisada manualmente e, depois da aprovação, os apps que você adicionar entram no ar na hora.
Adicione seu Mini App ou bot
Defina o nome e o ícone da moeda, a taxa de conversão, a parte do usuário e o design do offerwall na prévia ao vivo. Copie o App ID e o link hash salt para a configuração do seu servidor, nunca para o Mini App.
Assine os links no seu servidor
Depois de validar
initData, monte o link a partir do seu próprio ID de conta. Abra-o comopenLinkao tocar ou envie-o como botão de URL no chat privado do bot.Credite pelos postbacks e depois teste
Salve sua URL de postback, credite no status 1 uma vez por ID de transação e estorne no status 2. Depois, teste de ponta a ponta de uma conexão normal.
Quanto poderia render?
Deslize até o tamanho do seu público e ajuste as premissas. As taxas são um exemplo, não uma promessa: posicionamento, países e dispositivos influenciam cada resultado.
Guias para Telegram.
Guias passo a passo da Moonetix Academy.
Perguntas sobre Telegram
O que donos de projetos no Telegram perguntam antes de adicionar a Moonetix.
Ainda tem alguma dúvida? Fale conosco
O Telegram permite offerwalls em Mini Apps?
Não encontramos nos termos para desenvolvedores nem nos termos de Mini Apps do Telegram nenhuma regra que cite offerwalls, nem a favor nem contra. As regras sobre privacidade, spam, induzir usuários ao erro, pagamentos com Stars e cripto apenas da TON se aplicam, então leia os Bot Platform Developer Terms atuais antes do lançamento.
Preciso de um SDK para um offerwall em um Telegram Mini App?
Não. Um Mini App é uma página web, então seu servidor assina o link do offerwall e o Mini App o abre. Os SDKs da Moonetix são para apps nativos Android, iOS, Unity, Flutter e React Native.
Um bot do Telegram sem Mini App pode usar um offerwall?
Sim. Um comando /earn pode responder no chat privado com um botão de URL que leva o link assinado do usuário, e o offerwall abre no navegador. O backend do seu bot guarda o saldo e o credita a partir dos postbacks.
Como monetizo um canal do Telegram com um offerwall?
Um canal não pode hospedar o offerwall. Vincule seus posts ao seu bot com um parâmetro ?start=, e o bot envia a cada leitor o próprio link assinado. Monetizar um canal do Telegram também aborda os programas do próprio Telegram.
Como um jogo tap-to-earn usa um offerwall?
As ofertas pagam nos mesmos pontos pelos quais os jogadores tocam, creditados pelo seu servidor a partir de postbacks assinados. Mantenha os pontos virtuais, com termos claros, em vez de prometer um token, como explica o guia de tap-to-earn.
Devo usar openLink ou um iframe?
openLink abre o offerwall no navegador do usuário e mantém o Mini App aberto. Um iframe só carrega no site cadastrado para o seu app, e os clientes web do Telegram exibem Mini Apps dentro de frames, então ele pode falhar ali.
Posso vender moedas por Stars e também oferecer um offerwall?
Sim, muitos bots fazem as duas coisas. Bens digitais vendidos em um bot ou Mini App precisam ser pagos em Telegram Stars, enquanto as moedas ganhas com ofertas são creditadas pelo postback no mesmo saldo.
Por que alguns usuários não veem nenhuma oferta?
As ofertas dependem do país e do dispositivo do usuário, e usuários em VPNs, proxies, Tor ou redes de data center são bloqueados no offerwall. Os usuários finais precisam ter pelo menos 16 anos, com permissão dos pais para menores de 18.
Outros setores
- AppsApps de fitness, IA, quiz e utilidades
- JogosJogos mobile, Unity e HTML5
- Servidores de jogosMinecraft, Rust, Hytale e mais
- DiscordServidores, bots de economia e comandos /earn
- ComunidadesFóruns, sites de membros e comunidades de fãs
- WordPressPlugin gratuito, pontos e WooCommerce
- Sites de recompensasApps de GPT, cashback, faucet e recompensas
- Web apps & IASaaS, ferramentas de IA e web apps freemium
- ExtensõesApps para Chrome, Edge, Firefox e Electron
Transforme o seu tráfego em ganhos.
Crie uma conta de publisher gratuita e ganhe com cada oferta que seus usuários concluírem no seu site, app, jogo ou comunidade.





