Интеграция в Telegram-бота
Как отправлять рекламу Adexium пользователям вашего Telegram-бота.
Создайте плейсмент
В кабинете паблишера выберите New placement → Telegram Bot и заполните:
- Bot link — публичная ссылка
t.meна вашего бота. Её проверяет наша команда; после создания изменить нельзя. - Bot ID — часть до
:в токене бота от @BotFather (токен1234567890:AAH…→ ID1234567890). Вводите только число, никогда не токен. Это должен быть бот из вашей ссылки. - 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\"}]]}"'