Pacotes oficiais de código aberto no npm, PyPI e GitHub. Adicione anúncios premiados, intersticiais e de tarefas ao seu Telegram Mini App, ou mensagens patrocinadas ao seu bot, e ganhe USDT.
Adsun npm i adsun-sdkpip install adsunReact · Vue · Next.js · TypeScript · Python · aiogram · python-telegram-bot
JavaScript e TypeScript para Telegram Mini Apps. Hook React, composable Vue, compatível com SSR.
Python para bots do Telegram. Helpers para aiogram e python-telegram-bot, verificação de Reward URL.
Código-fonte completo, exemplos, issues e changelog. Licença MIT.
Sem build: carregue https://api.adsun.io/sdk.js e chame Adsun.init().
Troque 50001 pelo ID do bloco do seu painel de publisher Adsun. Use debug: true nos testes — anúncios de teste nunca são cobrados.
Qualquer Mini App, sem bundler.
<script src="https://telegram.org/js/telegram-web-app.js"></script>
<script src="https://api.adsun.io/sdk.js"></script>
<script>
// Reward block (Interstitial: "int-50001")
const ad = window.Adsun.init({ blockId: "50001" });
document.querySelector("#watch").onclick = () =>
ad.show().then(() => giveReward()).catch(console.log);
</script>
<adsun-task data-block-id="task-50003">
<span slot="reward">+100 coins</span>
</adsun-task>
Vite, Next.js, Svelte, Angular.
// npm i adsun-sdk
import { initAdsun } from "adsun-sdk";
const ad = await initAdsun({ blockId: "50001", debug: false });
ad.addEventListener("onStart", () => pauseGame());
ad.show()
.then((r) => r.done && giveReward())
.catch((r) => console.log(r.description));
Botão premiado e card de tarefa.
// npm i adsun-sdk
import { useAdsun, AdsunTask } from "adsun-sdk/react";
export function Earn() {
const showAd = useAdsun({ blockId: "50001", onReward: () => addCoins(100) });
return (
<>
<button onClick={showAd}>Watch ad · +100</button>
<AdsunTask blockId="task-50003" reward="+100" onReward={() => addCoins(100)} />
</>
);
}
Composable para qualquer componente.
<script setup>
// npm i adsun-sdk
import { useAdsun } from "adsun-sdk/vue";
const showAd = useAdsun({ blockId: "50001", onReward: () => coins.value += 100 });
</script>
<template>
<button @click="showAd">Watch ad · +100</button>
</template>
Mensagem patrocinada no /bonus.
# pip install "adsun[aiogram]"
from aiogram.filters import Command
from adsun import AsyncAdsunBot
from adsun.integrations.aiogram import send_ad
ads = AsyncAdsunBot(token="YOUR_ACCOUNT_TOKEN", block_id="50001")
@dp.message(Command("bonus"))
async def bonus(message):
u = message.from_user
await send_ad(message.bot, message.chat.id, ads, u.id, u.language_code or "en")
Dê a recompensa só após uma visualização verificada.
# Panel → Reward URL:
# https://your-app.com/adsun/reward?userid=[userId]&block=[blockId]&secret=SECRET
from adsun import parse_reward_callback
@app.get("/adsun/reward")
def reward(request):
cb = parse_reward_callback(request.query_params, secret=SECRET)
if cb is None:
return Response(status_code=403)
add_coins(cb.user_id) # idempotent: Adsun retries on 5xx
return {"ok": True}
Vídeo ou imagem em tela cheia que o usuário escolhe assistir por uma recompensa no app.
ID do bloco: 50001
Anúncio em tela cheia entre telas, pode ser fechado após alguns segundos.
ID do bloco: int-50001
Card nativo <adsun-task>: abrir um canal, bot ou app, voltar e resgatar.
ID do bloco: task-50001
Mensagem patrocinada com botões enviada pelo seu bot do Telegram.
ID do bloco: 50001 · Bot
# Telegram Mini App
npm i adsun-sdk
# Telegram bot
pip install adsun
# No build step
<script src="https://api.adsun.io/sdk.js"></script>
Sem custo para usar o SDK. Leia, faça fork e audite o código no GitHub.
Tipagem completa de AdController, eventos e opções de init.
Importe em qualquer lugar; o script só carrega no navegador.
O núcleo usa a biblioteca padrão; extras async são opcionais.
A Reward URL só é chamada depois que a Adsun verifica uma visualização completa.
O mesmo fluxo init({ blockId }).show() — migre em minutos.
Para Telegram Mini Apps rode npm i adsun-sdk (ou adicione <script src="https://api.adsun.io/sdk.js">). Para bots do Telegram rode pip install adsun.
Sim. Os pacotes são de código aberto sob licença MIT. Você ganha com os anúncios exibidos; não há taxa pelo SDK.
Sim. Use adsun-sdk/react para o hook useAdsun e o componente AdsunTask, e adsun-sdk/vue para Vue 3. É compatível com SSR, então funciona no Next.js e Nuxt.
Instale adsun, crie AdsunBot(token, block_id) e chame get_ad(user_id, language), ou use o helper send_ad() para aiogram / python-telegram-bot.
Configure uma Reward URL no bloco. A Adsun a chama só após uma visualização completa verificada no servidor; valide com parse_reward_callback() e dê a recompensa ali.
Sim. A API segue o mesmo padrão init({ blockId }).show() e os mesmos eventos, então normalmente só mudam o script e o ID do bloco.
Crie um bloco, instale o pacote e veja suas primeiras impressões hoje.
npm i adsun-sdkpip install adsun