nakama/BOT_SETUP.md

78 lines
2.2 KiB
Markdown
Raw Normal View History

2025-11-03 22:17:25 +00:00
# 🤖 Настройка Telegram бота для отправки изображений
## Как работает:
Когда пользователь нажимает "скачать" в просмотрщике изображений:
1. Изображение отправляется через backend
2. Backend использует Telegram Bot API
3. Фото приходит в ЛС с ботом пользователю
---
## Настройка на сервере:
### 1. Убедитесь что TELEGRAM_BOT_TOKEN установлен
```bash
ssh root@ваш_IP
cd /var/www/nakama
nano .env
```
Проверьте строку:
```
TELEGRAM_BOT_TOKEN=ваш_реальный_токен_от_BotFather
```
### 2. Пользователь должен написать боту /start
Когда пользователь впервые откроет Mini App:
- Бот автоматически получит доступ для отправки сообщений
- Или пользователь должен написать боту `/start` один раз
---
## API Endpoint:
```
POST /api/bot/send-photo
{
"userId": "123456789",
"photoUrl": "https://example.com/image.jpg",
"caption": "Описание изображения"
}
```
---
## Как использовать:
1. Пользователь ищет изображение в поиске (e621/gelbooru)
2. Открывает просмотрщик (нажимает на картинку)
3. Нажимает кнопку "Скачать" (Download)
4. Изображение приходит в ЛС с ботом! ✅
---
## Альтернатива (если бот не настроен):
Если `TELEGRAM_BOT_TOKEN` не установлен:
- Fallback на обычное скачивание через браузер
- Работает без бота
---
## Обновление:
```bash
# Загрузить новые файлы
scp backend/bot.js root@ваш_IP:/var/www/nakama/backend/
scp backend/routes/bot.js root@ваш_IP:/var/www/nakama/backend/routes/
scp backend/server.js root@ваш_IP:/var/www/nakama/backend/
# Перезапустить backend
ssh root@ваш_IP
pm2 restart nakama-backend
```