API монетизации Telegram-бота: задания с оплатой за выполнение
Если у бота своя логика и стандартная ОП не подходит, задания можно встроить через API — в нужный момент и в своём оформлении. Разберём, как работает API заданий MGRAM и сколько оно приносит.
Коротко. API заданий — та же монетизация, что и ОП, но момент показа и интерфейс выбираете вы. ЗапросPOST /tasksвозвращает задания с суммой награды,POST /tasks/checkили webhook сообщают о выполнении. Владелец получает 70% цены задания.
Что нужно
- Бот, подключённый к MGRAM.
- Bot API key — «Мои боты» → ваш бот → «Настройки» → «API-ключ».
- Сервер бота, который умеет делать HTTPS-запросы с JSON.
Как это работает
- Получите задания.
POST https://api.mgram.biz/tasksс заголовкомAuthorization: Bearer BOT_API_KEYи телом{"user_id": 123456789}. В ответе —tasksсtitle,link,button_textиreward. По умолчанию 3 задания, можно от 1 до 10. - Покажите кнопками — ссылка и текст уже в ответе.
- Проверьте выполнение —
POST /tasks/checkпо кнопке «Проверить» или webhook. - Пустите дальше, когда в ответе
skip: true.
Webhook
POST /tasks/webhook с вашим url включает события о выполнении и отписке. Каждое событие подписано: заголовок X-MGRAM-Signature — HMAC-SHA256 от timestamp.тело_запроса.
Сколько приносит
| Задание | Доход |
|---|---|
| Подписка на канал / вступление в чат | 70% цены, от 0,77 ₽ |
| Запуск бота | 70% цены, от 0,70 ₽ |
Отписка в течение 24 часов списывает доход за подписку; запуски не списываются.
Где встроить задания
- Перед платной функцией — «выполните задание вместо оплаты».
- За бонус — дополнительные попытки, монеты, лимиты.
- В Mini App — экран заданий с наградами.
Полная документация — на api.mgram.biz.