nakama/BOT_SETUP.md

78 lines
2.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 🤖 Настройка 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
```