Добавьте спонсоров в бота за 5 минут

Актуальная стоимость

Smart Link работает всегда — для всех ботов и пользователей, без исключений. Это обязательный контур защиты.

Быстрый старт за 5 минут

1. В @ParadiseGrmbot откройте Зарабатывать → Новый заказ → Бот.
2. Выберите подключение с токеном или без токена через API, затем дождитесь модерации.
3. Скопируйте API-ключ из карточки бота → Интеграция API.
4. Перед выдачей основного контента вызовите POST /v1/tasks/resolve.
5. Если пришёл tasks_required, покажите все кнопки из tasks и не выдавайте контент до проверки.
6. Кнопка «Проверить» вызывает POST /v1/tasks/verify-all. Когда невыполненных заданий не осталось — продолжайте основной сценарий бота.

Добавление бота: с токеном или без

8802642146 @SignalBot Signal Bot

Логика как в блоке обязательной подписки

Количество ссылок равно числу реально доступных заданий, но не превышает настройку «Макс. спонсоров». Уже выполненные задания и каналы, на которые пользователь подписан, повторно не выдаются.

Готовое задание для ChatGPT, Codex или другого ИИ

Скопируйте блок целиком и вставьте в ИИ вместе с исходниками своего бота:

Интегрируй ParadiseGram Publisher API в моего Telegram-бота.

Base URL: https://www.paradisegram.ru
API key бери из переменной окружения PARADISEGRAM_API_KEY и никогда не отправляй в Telegram или клиентский JavaScript.

Перед выдачей основного контента вызывай POST /v1/tasks/resolve с user_id, chat_id, username, first_name, language_code и is_premium.
Если status=tasks_required, покажи ВСЕ элементы tasks. Для каждого используй title, button_text, url и строго соблюдай open_mode: url = обычная URL-кнопка, webapp = WebAppInfo.
Добавь кнопку «Проверить», которая вызывает POST /v1/tasks/verify-all с user_id.
Если остались incomplete/pending — снова покажи невыполненные задания. Если всё verified либо resolve вернул no_tasks/completed — продолжи исходный сценарий бота.
Награду начисляй только один раз и только когда verify вернул status=verified и rewardable=true.
На таймаут/HTTP 5xx логируй request_id и не ломай пользователю основной бот.
Не удаляй существующие интеграции и обработчики. Добавь таймаут 10 секунд, защиту от двойного начисления и тесты.

Готовый минимальный пример · aiogram 3

Этот пример показывает весь обязательный цикл: resolve → кнопки → verify-all → продолжение.

import os
import httpx
from aiogram import F, Router
from aiogram.filters import CommandStart
from aiogram.types import InlineKeyboardButton, InlineKeyboardMarkup, Message, CallbackQuery, WebAppInfo

router = Router()
BASE_URL = "https://www.paradisegram.ru"
API_KEY = os.environ["PARADISEGRAM_API_KEY"]

async def paradise_post(path: str, payload: dict) -> dict:
    async with httpx.AsyncClient(timeout=10) as client:
        response = await client.post(
            BASE_URL + path,
            headers={"Authorization": f"Bearer {API_KEY}"},
            json=payload,
        )
        response.raise_for_status()
        return response.json()

async def resolve_for(user, chat_id: int) -> dict:
    return await paradise_post("/v1/tasks/resolve", {
        "user_id": user.id,
        "chat_id": chat_id,
        "username": user.username,
        "first_name": user.first_name,
        "language_code": user.language_code,
        "is_premium": bool(user.is_premium),
        "limit": 10,
    })

async def show_sponsors(message: Message, data: dict) -> bool:
    tasks = data.get("tasks") or []
    if not tasks:
        return False
    rows = []
    for task in tasks:
        kwargs = {"text": task.get("button_text") or task["title"]}
        if task.get("open_mode") == "webapp":
            kwargs["web_app"] = WebAppInfo(url=task["url"])
        else:
            kwargs["url"] = task["url"]
        rows.append([InlineKeyboardButton(**kwargs)])
    rows.append([InlineKeyboardButton(text="Проверить", callback_data="pg:check")])
    await message.answer("Выполните задания:", reply_markup=InlineKeyboardMarkup(inline_keyboard=rows))
    return True

async def send_main_content(message: Message) -> None:
    await message.answer("Основной контент вашего бота")

@router.message(CommandStart())
async def start(message: Message) -> None:
    try:
        data = await resolve_for(message.from_user, message.chat.id)
        if await show_sponsors(message, data):
            return
    except httpx.HTTPError:
        pass  # API временно недоступен: не ломаем основной бот
    await send_main_content(message)

@router.callback_query(F.data == "pg:check")
async def check(callback: CallbackQuery) -> None:
    await callback.answer("Проверяем...")
    try:
        await paradise_post("/v1/tasks/verify-all", {"user_id": callback.from_user.id})
        data = await resolve_for(callback.from_user, callback.message.chat.id)
        if await show_sponsors(callback.message, data):
            return
    except httpx.HTTPError:
        await callback.message.answer("Проверка временно недоступна. Попробуйте ещё раз.")
        return
    await send_main_content(callback.message)

Для JavaScript, PHP и cURL используйте готовые вкладки ниже. Контракт ответа одинаковый для всех языков.

Авторизация

Authorization: Bearer pg_live_...

Ключ передаётся только в заголовке защищённых методов. Не помещайте его в URL, клиентский JavaScript, кнопки, логи или репозиторий. Каждый ответ содержит X-Request-ID; тело ошибки содержит тот же request_id.

Поля контракта

Resolve request

Resolve response / Task item

Верхний уровень: status, массив tasks, ближайший expires_at или null и message. Элемент tasks: task_id, title, action_type, button_text, подписанный Smart Link в url, open_mode, price, expires_at, status.

Verify request / response

Оба метода принимают обязательный user_id. Одиночный ответ: status, task_id, message, rewardable. Начисляйте свою награду только при status=verified и rewardable=true. Групповой ответ содержит status, checked, verified, массив results и message. Каждый элемент results содержит task_id, title, action_type, url, completed, rewardable, точный status и пояснение message.

Статусы

Идемпотентность

Повторный или параллельный resolve для того же пользователя не создаёт двойной резерв одного заказа. Каждое активное назначение получает одну стабильную Smart Link. Повторный verify подтверждённого задания снова возвращает verified без второй выплаты; дополнительную награду на своей стороне защищайте уникальным task_id. После сетевого таймаута повторяйте тот же запрос с теми же идентификаторами.

Smart Link и защита трафика

Каждый спонсор выдаётся отдельным Smart Link. Владелец бота не может отключить проверку.

POST /v1/tasks/resolve возвращает до настройки «Макс. спонсоров» разных заданий. Каждое значение url является Smart Link, а action_type сообщает реальное условие (channel или bot). Если подходящих спонсоров меньше, массив tasks тоже будет короче; пустые ссылки не создаются. Каждая ссылка закреплена за своим назначением и после проверки сразу открывает именно его.

Ссылка работает в обычном браузере при open_mode=url; Telegram Mini App не требуется. При open_mode=webapp открывайте её как Web App: тогда сервис дополнительно проверяет Telegram initData. Один URL можно безопасно открыть повторно после сетевой ошибки — второе назначение и двойной резерв не появятся.

При проверке задания поле rewardable=true означает подтверждённое платное действие. Для старых ссылок без закреплённого спонсора либо при его отсутствии сервис возвращает rewardable=false, поэтому интеграция не должна начислять награду.

country — страна для текущего геотаргетинга. Обычно это страна выхода IP. При явном VPN/proxy применяется безопасная RU-политика; если GeoIP пропустил VPN, согласие любых двух сигналов — Telegram-языка, языка браузера и IANA timezone — восстанавливает соответствующую СНГ-страну. Такое значение помечается источником network_policy или locale_policy и уверенностью inferred, а не выдаётся за точную физическую геолокацию.

VPN/proxy — это флаг риска и сам по себе не скрывает кампании. Уже выполненные, активные или фактически оформленные подписки не выдаются повторно.

Безопасность и приватность

• Используйте HTTPS и храните ключ только на сервере.
• Не доверяйте username или имени как идентификатору: используйте связку ключа, user_id и task_id.
• Сырые IP и отпечатки устройства не сохраняются; хранятся HMAC-хэши, агрегированные признаки, риск и причины.
• Не подменяйте подписанные URL и не обходите редиректы ParadiseGram.
• Передавайте поддержке request_id, но никогда не API-ключ.

HTTP-ошибки и статусы

{"error":{"code":"invalid_request","message":"Проверьте параметры запроса.","hint":"Исправьте fields.","fields":[{"field":"user_id","message":"..."}]},"request_id":"8f5b..."}