Telegram Bot Integration Guide

Learn how to integrate ad into your Telegram Bot effectively.

Request Ad

To get an Ad you should send a POST request to https://bid.tgads.live/bot-request

curl --location 'https://bid.tgads.live/bot-request' \
     --header 'Content-Type: application/json' \
     --data '{
        "wid": "99220c34-31b8-45f6-bff5-8bd896fd5e09",
        "language": "en",
        "isPremium": true,
        "firstName": "Andrew",
        "telegramId": "123456789"
     }'

Get Ad response

Then you will receive a JSON response:

{
    "id": "3422bnr8-2461-4fd2-9183-80h0de6f8343",
    "image": "https://go.tgads.live/image.png",
    "clickUrl": "https://go.tgads.live/click",
    "buttonText": "Go!",
    "text": "Current news and market analysis!"
}

Send Ad to user

Now you can send this response one time to the user via Telegram Bot API

curl --location 'https://api.telegram.org/bot<YOUR_BOT_TOKEN>/sendPhoto' \
     --form 'chat_id="123456789"' \
     --form 'photo="https://go.tgads.live/image"' \
     --form 'caption="Current news and market analysis!"' \
     --form 'reply_markup="{\"inline_keyboard\":[[{\"text\":\"GO\!\",\"url\":\"https://go.tgads.live/click\"}]]}"'