یکپارچه‌سازی تبلیغات در بات تلگرام شما

پس از ایجاد و تأیید بلوک، می‌توانید نمایش تبلیغات را در بات تلگرام خود شروع کنید.

مرحله ۱ — درخواست API

یک درخواست GET به آدرس زیر ارسال کنید:
https://api.adsgram.ai/advbot?tgid={TELEGRAM_USER_ID}&blockid={BLOCK_ID}&language={LANGUAGE}&token={your_token}

• tgid — شناسه کاربر تلگرام

• blockid — شناسه Ad Block شما (از داشبورد)

• language — زبان مورد نظر تبلیغات

• token — یک توکن منحصربه‌فرد مرتبط با حساب شما، قابل دسترسی در کابینت AdsGram (قابل بازیابی مجدد).
  برای دریافت token، به پروفایل خود در گوشه بالا سمت راست بروید و روی دکمه کلیک کنید.

  

مهم

فقط از بخش عددی blockid استفاده کنید، بدون پیشوند bot-.

مرحله ۲ — پردازش پاسخ

API پاسخ زیر را برمی‌گرداند:

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

مرحله ۳ — ارسال تبلیغ

از داده‌های برگشتی برای ساخت پیام خود استفاده کنید:

• text_html → متن پیام (فرمت HTML)
• image_url → تصویر تبلیغ
• button_name + click_url → دکمه inline
• button_reward_name + reward_url → دکمه inline
• ParseMode = HTML

✅ نمونه پیاده‌سازی در بخش قبلی موجود است.

مهم

• text_html شامل تگ‌های HTML است. همیشه ParseMode.HTML را در فریمورک بات خود تنظیم کنید.
• پیام‌های تبلیغاتی ارسال‌شده از طریق بات نباید قابل Forward باشند.
  باید از انواع پیام‌های تلگرام استفاده کنید که جلوگیری از Forward را امکان‌پذیر می‌سازند، مانند sendPhoto یا sendMessage با پارامتر protect_content=True در Telegram API.