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.

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

  1. Post do canalUm botão para t.me/yourbot?start=earn
  2. Seu botRecebe /start earn em um chat privado
  3. Seu servidorAssina o link do offerwall para esse usuário
  4. Mini App ou navegadorO usuário conclui ofertas e ganha moedas
init-data.js
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 initData com o token do bot e nunca confiar em initDataUnsafe.

  • Rejeite dados antigos

    Compare também auth_date com 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 initData no seu servidor com o token do bot, confira auth_date e nunca confie em initDataUnsafe nem 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.

  1. 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.

  2. 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.

  3. Assine os links no seu servidor

    Depois de validar initData, monte o link a partir do seu próprio ID de conta. Abra-o com openLink ao tocar ou envie-o como botão de URL no chat privado do bot.

  4. 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.

Abrir a calculadora completa

Estime seus ganhos

Deslize até o seu público mensal

10,000
5001M
  • 8% abre o offerwall
  • 10% conclui uma oferta
  • $1.20 por conclusão
Ganhos mensais estimados $93.12
Por ano $1,117.44A cada 1,000 usuários $9.31

Taxas de exemplo, não uma promessa. Posicionamento, países e dispositivos influenciam cada resultado.

Ajuste as premissas

Guias para Telegram.

Guias passo a passo da Moonetix Academy.

Adicione um offerwall a um Telegram Mini App Um offerwall para monetizar Telegram Mini Apps: valide o initData no seu servidor, gere ali o link assinado do offerwall, abra-o com Telegram.WebApp.openLink, credite os usuários a partir de postbacks e confira os termos para desenvolvedores do Telegram antes do lançamento. 10 min de leitura Como criar um jogo tap-to-earn no Telegram (2026) Crie um jogo clicker tap-to-earn como Telegram Mini App, com lógica de servidor testada em Node.js: validação do initData, toques em lote, energia no servidor, verificações contra autoclickers, upgrades, indicações e monetização com pontos virtuais em vez de promessas de token. 12 min de leitura Como monetizar um bot do Telegram em 2026 Todas as formas comprovadas de um bot do Telegram ganhar dinheiro: pagamentos e assinaturas em Stars, produtos físicos por meio de provedores de pagamento, receita de anúncios do Telegram, programas de afiliados, um offerwall, freemium e patrocinadores, com as regras que valem para cada uma. 10 min de leitura Telegram Stars vs offerwall: ganhe com um canal do Telegram As Telegram Stars rendem com leitores que pagam a você; um offerwall rende com anunciantes e também deixa os leitores ganharem. Como cada um funciona, o que os termos atuais do Telegram dizem sobre Stars, uma comparação lado a lado e como usar os dois com segurança. 7 min de leitura Como monetizar um canal do Telegram (formas gratuitas e pagas) As ferramentas de monetização do próprio Telegram, da divisão de 50% da receita de anúncios a posts pagos, assinaturas em Stars e posts sugeridos, além de patrocínios, links de afiliado e um programa de recompensas no seu próprio site. 7 min de leitura Melhor offerwall para Telegram Mini Apps: o que verificar Como os offerwalls funcionam dentro de Telegram Mini Apps e bots, as oito coisas a verificar antes de escolher um, as regras do Telegram que afetam as recompensas e um exemplo prático de quanto um Mini App pode render. 7 min de leitura

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.

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.

Segmentação mundial
Mais
Entrar