Настройка Tribute
Tribute обеспечивает управление повторяющимися подписками через Telegram с автоматическим продлением.
Критические требования
Заголовок раздела «Критические требования»⚠️ У вас должен быть публичный домен с действительным SSL сертификатом (например, bot.example.com). Вебхуки НЕ будут работать на localhost или частных IP адресах.
Инструкции по настройке
Заголовок раздела «Инструкции по настройке»-
Создайте канал Tribute
- Откройте приложение Tribute в Telegram
- Создайте канал
- В “Channels and Groups” → Добавьте ваш канал
- Создайте новую подписку
-
Получите ссылку подписки
- В Tribute: Subscription → Links
- Скопируйте “Telegram Link”
- Должна выглядеть так:
https://t.me/tribute/app?startapp=...
-
Настройте переменные окружения
Окно терминала TRIBUTE_WEBHOOK_URL=/tribute/webhookTRIBUTE_API_KEY=ваш_api_ключ_из_tributeTRIBUTE_PAYMENT_URL=https://t.me/tribute/app?startapp=...HEALTH_CHECK_PORT=8080 -
Настройте обратный прокси
Настройте Nginx или Traefik для перенаправления HTTPS запросов боту:8080
server {server_name bot.example.com;listen 443 ssl;ssl_certificate /путь/к/cert.pem;ssl_certificate_key /путь/к/key.pem;location / {proxy_pass http://localhost:8080;}} -
Перезагрузите бота
Окно терминала docker compose down && docker compose up -d -
Протестируйте вебхук
Окно терминала curl https://bot.example.com/tribute/webhook
Как это работает
Заголовок раздела «Как это работает»- Пользователь нажимает кнопку платежа
- Перенаправляется на страницу подписки Tribute
- Пользователь завершает подписку в Telegram
- Tribute отправляет вебхук на ваш бот
- Бот активирует подписку для пользователя
Переменные конфигурации
Заголовок раздела «Переменные конфигурации»| Переменная | Описание |
|---|---|
TRIBUTE_WEBHOOK_URL | Путь вебхука (например, /tribute/webhook) |
TRIBUTE_API_KEY | API ключ из настроек Tribute |
TRIBUTE_PAYMENT_URL | Ссылка подписки из Tribute |
HEALTH_CHECK_PORT | Порт для вебхука (обычно 8080) |
Получение API ключа
Заголовок раздела «Получение API ключа»- Откройте приложение Tribute
- Settings → API Settings
- Создайте новый API ключ
- Скопируйте и вставьте в
.env
Варианты SSL сертификата
Заголовок раздела «Варианты SSL сертификата»Let’s Encrypt (Бесплатно)
Заголовок раздела «Let’s Encrypt (Бесплатно)»# Используя Certbot с Nginxsudo certbot certonly --standalone -d bot.example.comПоддержка
Заголовок раздела «Поддержка»- Справка Tribute: Встроенная поддержка
- Telegram сообщества: Группы платежей криптовалютой