Інтеграція рекламного блоку в Telegram-бота через AdsGram

Після того як ви створили рекламний блок в особистому кабінеті і він пройшов модерацію, ви можете почати показувати рекламу всередині вашого Telegram-бота.

Крок 1 — Запит до API

Щоб отримати рекламний контент, надішліть GET-запит на:
https://api.adsgram.ai/advbot?tgid={TELEGRAM_USER_ID}&blockid={BLOCK_ID}&language={LANGUAGE}&token={your_token}

• tgid — Telegram ID користувача

• blockid — ID рекламного блоку (можна знайти в особистому кабінеті)

• language — бажана мова реклами

• token — унікальний токен, пов'язаний з вашим акаунтом, доступний у кабінеті. За необхідності може бути згенерований повторно.
  Для того, щоб отримати token, необхідно перейти в профіль у правому верхньому куті і натиснути на кнопку .

  

Важливо

Використовуйте тільки числову частину blockid, без префікса bot-.

Крок 2 — Обробка відповіді

API поверне 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"
}

Крок 3 — Формування повідомлення

Використовуйте дані з відповіді для надсилання реклами:

• text_html → текст повідомлення (caption)
• image_url → зображення
• button_name + click_url → inline-кнопка
• button_reward_name + reward_url → inline-кнопка
• ParseMode = HTML

Важливо

• text_html може містити HTML, обов'язково вказуйте ParseMode.HTML.
• Рекламні пости, що розміщуються через бота, не повинні бути пересилаємими.
  Публікація повинна використовувати формат, який виключає можливість пересилання (наприклад, sendPhoto або sendMessage з параметром protect_content=True в Telegram API).