Intégration des publicités dans votre bot Telegram

Après la création et l'approbation de votre bloc, vous pouvez commencer à afficher des publicités dans votre bot Telegram.

Étape 1 — Requête API

Envoyez une requête GET vers :
https://api.adsgram.ai/advbot?tgid={TELEGRAM_USER_ID}&blockid={BLOCK_ID}&language={LANGUAGE}&token={your_token}

• tgid — ID de l'utilisateur Telegram

• blockid — votre ID de bloc publicitaire (depuis le tableau de bord)

• language — langue souhaitée des publicités

• token — un jeton unique lié à votre compte, disponible dans le cabinet AdsGram (peut être régénéré).
  Pour obtenir le token, accédez à votre profil en haut à droite et cliquez sur le bouton .

  

IMPORTANT

Utilisez uniquement la partie numérique du blockid, sans le préfixe bot-.

Étape 2 — Traitement de la réponse

L'API renvoie :

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

Étape 3 — Envoyer la publicité

Utilisez les données renvoyées pour construire votre message :

• text_html → texte du message (format HTML)
• image_url → image publicitaire
• button_name + click_url → bouton inline
• button_reward_name + reward_url → bouton inline
• ParseMode = HTML

✅ Un exemple d'implémentation est disponible dans la section précédente.

IMPORTANT

• text_html contient des balises HTML. Définissez toujours ParseMode.HTML dans votre framework de bot.
• Les messages publicitaires envoyés via le bot ne doivent pas être transférables.
  Vous devez utiliser les types de messages Telegram qui empêchent le transfert, tels que sendPhoto ou sendMessage avec le paramètre protect_content=True dans l'API Telegram.