Подключение Telegram
Telegram — основной канал поддержки. Бот принимает входящие сообщения пользователей через вебхук и создаёт для каждого обращения отдельную тему (топик) в приватной Telegram-группе поддержки. Ответы менеджеров из этой темы доставляются пользователю обратно в Telegram.
Эндпоинт вебхука: POST /api/telegram/bot
Предварительные требования
Перед подключением убедитесь, что проект развёрнут по одной из инструкций:
Для локальной разработки вебхук можно поднять через Cloudflare Tunnel (macOS).
1. Подключение интеграции Telegram
- Перейдите в раздел "Настройки" -> "Интеграции".
- Нажмите на карточку "Telegram".
- Не закрывайте страницу, в следующих пунктах необходимо будет заполнить поля.
1. Создание бота в @BotFather
- Откройте @BotFather в Telegram.
- Отправьте команду
/newbot. - Задайте имя и имя пользователя (username) для бота.
- Полученный токен вставьте в поле "Токен бота".
2. Создание группы для приёма сообщений
- Создайте новую приватную Telegram-группу.
- Добавьте в неё бота, которого создали в @BotFather, и назначьте его администратором.
- В настройках группы включите возможность создавать темы (топики).
- Чтобы узнать ID группы, временно добавьте в неё бота @getMyId или аналогичный. После получения ID удалите его из группы.
3. Настройки интеграции Telegram
- В поле "Токен", вставьте токен, который вы получили при создании бота.
- В поле "Секретный ключ Webhook", вставьте случайную строку (пароль для защиты интеграции).
- В поле "ID группы для приёма сообщений", вставьте ID группы, который вы получили на предыдущем шаге.