Интеграция рекламного блока в 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 → инлайн-кнопка
• button_reward_name + reward_url → инлайн кнопка
• ParseMode = HTML

ВАЖНО

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