Telegram

Расширение Telegram подключает к форме Telegram-бота. Клиент пишет боту, в форме появляется задача, и всё, что написано в этом чате дальше, попадает в ту же задачу. Операторы отвечают из задачи, ответ уходит в Telegram.

Подключение в три шага

1. Выберите бота HCAPP. Пользователь с ролью BOT из списка, или создайте нового кнопкой Create bot. Дайте ему доступ к этой форме с правом создавать задачи (форма → Access). Задачи и сообщения из Telegram создаются от имени этого бота.
2. Вставьте токен Telegram-бота. Создайте бота в Telegram через @BotFather (/newbot) и вставьте токен в поле TELEGRAM BOT TOKEN. Кнопка Check token спрашивает у Telegram, чей это токен, ничего не сохраняя. Нажмите Save: HCAPP проверит токен и сам зарегистрирует вебхук. Никаких chat ID и ручной регистрации.
3. Напишите боту. Откройте бота по ссылке в карточке и отправьте сообщение. Первое сообщение создаёт задачу в этой форме.

В карточке видны статус подключения, ссылка на бота, кнопки Test connection и Reconnect. Если что-то сломается позже, последняя ошибка показывается там же.

Правила чата

Настройка	Значение
Chat	Чат привязан к одной открытой задаче. Бот один раз присылает ссылку, когда задача создана, и дальше молчит. /new открывает для чата новую задачу.
Each message = new task	Только приём: каждое сообщение открывает свою задачу, из задачи в чат ничего не отправляется.
Только сообщения с файлом	Только для режима Each message = new task. Сообщения без файла пропускаются.
Отвечать ссылкой на задачу	Только для режима Each message = new task. После каждого принятого сообщения бот отвечает Created in <форма>: <ссылка>.
Куда сохранять файлы	Только для режима Each message = new task. В сообщение, в файлы задачи или в поле формы типа Files.

/start один раз присылает приветствие с правилами канала, задачу не создаёт.

Альбом (несколько файлов одной отправкой) становится одним сообщением и одной задачей со всеми файлами. Принимается не больше 5 файлов на сообщение, остальные пропускаются, и в тексте сообщения об этом сказано. Лимит размера файла 20 МБ, это ограничение Telegram.

Поля формы

Выберите, в какие поля новой задачи попадают Telegram-аккаунт (@username или числовой ID), имя отправителя и текст первого сообщения. Поле аккаунта или имени удобно использовать в правилах маршрута, чтобы задачи уходили нужному сотруднику.

В задаче

Сообщения показываются во вкладке Telegram задачи как чат: клиент слева, операторы справа, файлы вложениями. В режиме Chat операторы пишут в поле внизу, в режиме Each message = new task вместо поля подсказка, ответы отключены.

Безопасность

• Вебхук защищён секретом, который Telegram присылает с каждым обновлением; секрет меняется при каждом переподключении.
• Токен бота хранится в зашифрованном виде и после сохранения больше не показывается.
• Входящие обрабатываются через очередь с повторами, при перезапуске сервера ничего не теряется.