Пошаговое руководство от клонирования репозитория до первого сообщения от клиента.
Убедитесь, что всё готово перед установкой
Linux-хост с выходом в интернет. Подойдёт любой VPS от 512 МБ RAM. Также можно установить локально для тестирования.
Основной способ развёртывания — Docker Compose.
Создайте нового бота через @BotFather и сохраните полученный токен.
Для production-развёртывания с webhook Telegram требует HTTPS.
Следуйте инструкции последовательно
Скачайте исходный код проекта на ваш сервер:
git clone https://github.com/prog-time/tg-support-bot.git
cd tg-support-botСкопируйте файл примера и заполните переменные:
cp .env.example .env
nano .envОткроется текстовый редактор. Заполните переменные согласно следующему шагу.
Создайте бота в @BotFather и добавьте токен в .env:
TELEGRAM_BOT_TOKEN=1234567890:AABBCCDDEEFFaabbccddeeff1234567890
TELEGRAM_GROUP_ID=-100123456789 TELEGRAM_GROUP_ID — ID вашей рабочей группы операторов.
Запустите скрипт установки одной командой:
./start.shСкрипт автоматически соберёт и запустит все необходимые сервисы.
Укажите Telegram адрес вашего сервера для приёма сообщений:
curl https://api.telegram.org/bot<TOKEN>/setWebhook \
-d "url=https://yourdomain.com/api/telegram/bot" Замените <TOKEN> на ваш токен и yourdomain.com на адрес вашего сервера.
Напишите вашему боту любое сообщение — оно должно появиться в рабочей группе операторов. Ответьте из группы — клиент получит ответ.
Всё готово! Ваш бот поддержки работает.
Ключевые переменные файла .env
| Параметр | Описание | Обязательный |
|---|---|---|
TELEGRAM_BOT_TOKEN |
Токен вашего Telegram бота от @BotFather | Да |
TELEGRAM_GROUP_ID |
ID рабочей группы операторов в Telegram | Да |
APP_URL |
Публичный URL вашего сервера (для webhook) | Да |
VK_TOKEN |
Токен сообщества ВКонтакте (для VK интеграции) | Нет |
VK_CONFIRMATION |
Строка подтверждения для VK Callback API | Нет |
Предпочитаете смотреть?
Установка на видео от начала до конца