Skip to content

Интеграция в Telegram-бота ​

Как отправлять рекламу Adexium пользователям вашего Telegram-бота.

Создайте плейсмент ​

В кабинете паблишера выберите New placement → Telegram Bot и заполните:

  • Bot link — публичная ссылка t.me на вашего бота. Её проверяет наша команда; после создания изменить нельзя.
  • Bot ID — часть до : в токене бота от @BotFather (токен 1234567890:AAH… → ID 1234567890). Вводите только число, никогда не токен. Это должен быть бот из вашей ссылки.
  • Blocked ad categories — категории рекламы, которые вы не хотите показывать своим пользователям.

Затем на странице плейсмента появится Placement ID (WID) — это wid в запросах ниже.

Запросить рекламу ​

Отправьте POST-запрос на https://bid.tgads.live/bot-request. wid — ваш Placement ID (WID).

shell
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"
     }'

Ответ ​

Ответ — JSON-список из одного объявления:

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

Если для этого пользователя рекламы нет, ответ — пустой список [], отправлять ничего не нужно. Неизвестный wid возвращает 404.

Отправить рекламу пользователю ​

Отправьте рекламу пользователю один раз через Telegram Bot API, используя image, text, buttonText и clickUrl из ответа:

shell
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\"}]]}"'