Integração de publicidade no seu Telegram bot

Depois que seu bloco for criado e aprovado, você pode começar a exibir publicidade no seu Telegram bot.

Passo 1 — Solicitação API

Envie uma solicitação GET para:
https://api.adsgram.ai/advbot?tgid={TELEGRAM_USER_ID}&blockid={BLOCK_ID}&language={LANGUAGE}&token={your_token}

• tgid — ID do usuário do Telegram

• blockid — seu ID de bloco publicitário (do painel de controle)

• language — idioma desejado da publicidade

• token — token único vinculado à sua conta, disponível no painel do AdsGram (pode ser regenerado).
  Para obter o token, vá ao seu perfil no canto superior direito e clique no botão .

  

IMPORTANTE

Use apenas a parte numérica do blockid, sem o prefixo bot-.

Passo 2 — Processamento da resposta

A API retorna:

{
  "text_html": "<a href='https://api.adsgram.ai/short/AwJ8ughbhDH'>Follow Velo For The Coming Big Announcement</a>\n<a>\nVelo\n\nMiss the Velo X Blackrock announcement previously?\nFollow Velo X now!\n\n<a href='https://api.adsgram.ai/short/DvvpNWxAtaG'>Click here to claim the reward after completing task!</a>\nAd. 18+</a>",
  "click_url": "https://api.adsgram.ai/short/AwJ8ughbhDH",
  "button_name": "Follow us!",
  "image_url": "https://images.adsgram.ai/3d618923-ba5f-4589-a3a8-ed97bd301435",
  "button_reward_name": "Claim reward!",
  "reward_url": "https://api.adsgram.ai/short/DvvpNWxAtaG"
}

Passo 3 — Envio da publicidade

Use os dados retornados para formar sua mensagem:

• text_html — texto da mensagem (formato HTML)
• image_url — imagem da publicidade
• button_name + click_url — botão inline
• button_reward_name + reward_url — botão inline
• ParseMode = HTML

O exemplo de implementação está disponível na seção anterior.

IMPORTANTE

• text_html contém tags HTML. Sempre defina ParseMode.HTML na sua biblioteca para o bot.
• As mensagens publicitárias enviadas através do bot não devem ser encaminháveis.
  Você deve usar tipos de mensagens do Telegram que evitem o encaminhamento, como sendPhoto ou sendMessage com o parâmetro protect_content=True na API do Telegram.