将广告集成到您的 Telegram 机器人

在您的广告模块创建并通过审核后，您就可以开始在您的 Telegram 机器人中展示广告了。

Step 1 — API 请求

发送 GET 请求至：
https://api.adsgram.ai/advbot?tgid={TELEGRAM_USER_ID}&blockid={BLOCK_ID}

参数说明：

• tgid — Telegram 用户 ID
• blockid — 广告区块 ID（后台获取）

重要提示

仅使用 blockid 的数字部分，不要包含前缀 bot-。

Step 2 — 处理 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"
}

Step 3 — 发送广告

使用返回的数据来构建你的消息：

• text_html → 消息文本（HTML 格式）
• image_url → 广告图片
• button_name + click_url → 内联按钮
• button_reward_name + reward_url → 内联按钮
• ParseMode = HTML

✅ 示例实现可参考上一节。

重要提示：

• text_html 包含 HTML 标签，请务必在你的 bot 框架中设置 ParseMode.HTML。
• 通过 bot 发送的广告消息不允许被转发。
  你应使用 Telegram API 中的防止转发的消息类型，例如 sendPhoto 或 sendMessage，并设置参数 protect_content=True。

多语言机器人

如果你的机器人支持多种语言，你可以在广告请求中使用 language 参数来指定所需的语言。

示例请求（指定语言）：
https://api.adsgram.ai/advbot?blockid=123&tgid=123&language=en

如果包含 language 参数，AdsGram 将返回指定语言的广告。
如果未包含该参数，系统将回退至根据 Telegram 界面语言自动识别的语言。

---

✅ 完成设置后，你的机器人现在可以原生展示来自 AdsGram 的广告了。