Telegram

Telegram-канал — клиентский бот, которому пишут пользователи. Не путайте его с ботом-супервизором: это два разных бота с разными токенами и разными задачами.

• Клиентский бот (CHANNEL_TELEGRAM_BOT_TOKEN) — принимает сообщения от клиентов, создаёт тикеты.
• Бот-супервизор (TELEGRAM_SUPERVISOR_BOT_TOKEN) — управляет топиками в супергруппе операторов.

Создание бота

1. Открыть @BotFather → /newbot.
2. Задать имя и юзернейм бота.
3. Скопировать токен.

Переменные в .env

CHANNEL_TELEGRAM_BOT_TOKEN=токен-клиентского-бота
CHANNEL_TELEGRAM_WEBHOOK_SECRET=случайная-строка-для-верификации-webhook

CHANNEL_TELEGRAM_WEBHOOK_SECRET — произвольная строка для верификации входящих запросов от Telegram (от 1 до 256 символов, только A-Z, a-z, 0-9, _, -). Генерируется один раз, не меняется.

Режимы работы

Режим	Описание
Long Polling	Бот сам опрашивает серверы Telegram. Не требует публичного HTTPS и домена.
Webhook	Telegram доставляет обновления POST-запросом на ваш URL. Требует HTTPS и публичного домена.

EasyDesk поддерживает оба режима. Если Webhook недоступен, автоматически переключается на Long Polling.

Поддерживаемые типы вложений

audio · document · photo · sticker · video · voice

Вложения от клиента отображаются в топике супергруппы. Оператор может отправить вложение клиенту, прикрепив файл к сообщению с командой /reply.