Skip to content

Integracion de publicidad en tu Telegram bot

Despues de que tu bloque sea creado y aprobado, puedes comenzar a mostrar publicidad en tu Telegram bot.

Paso 1 — Solicitud API

Envia una solicitud GET a:
https://api.adsgram.ai/advbot?tgid={TELEGRAM_USER_ID}&blockid={BLOCK_ID}&language={LANGUAGE}&token={your_token}

  • tgid — ID del usuario de Telegram

  • blockid — tu ID de bloque publicitario (del panel de control)

  • language — idioma deseado de la publicidad

  • token — token unico vinculado a tu cuenta, disponible en el panel de AdsGram (se puede regenerar).
    Para obtener el token, ve a tu perfil en la esquina superior derecha y haz clic en el boton Copy.

    Copiar token

IMPORTANTE

Usa solo la parte numerica del blockid, sin el prefijo bot-.

Paso 2 — Procesamiento de la respuesta

La API devuelve:

JSON
{
  "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"
}

Paso 3 — Envio de la publicidad

Usa los datos devueltos para formar tu mensaje:

  • text_html — texto del mensaje (formato HTML)
  • image_url — imagen de la publicidad
  • button_name + click_url — boton inline
  • button_reward_name + reward_url — boton inline
  • ParseMode = HTML

El ejemplo de implementacion esta disponible en la seccion anterior.

IMPORTANTE

  • text_html contiene etiquetas HTML. Siempre establece ParseMode.HTML en tu biblioteca para el bot.
  • Los mensajes publicitarios enviados a traves del bot no deben ser reenviables.
    Debes usar tipos de mensajes de Telegram que eviten el reenvio, como sendPhoto o sendMessage con el parametro protect_content=True en la API de Telegram.