📱 Подключение Telegram

Пошаговое руководство: как создать Telegram-бота и подключить его к Fixorix, чтобы обращения из Telegram попадали в общую очередь поддержки.

Цель

Получить рабочий канал Telegram: клиент пишет вашему боту в Telegram — сообщение появляется в разделе «Поддержка» → «Чаты», и оператор отвечает на него прямо из Fixorix.

Что понадобится

• Роль в проекте не ниже Редактора — права администратора не нужны.
• Аккаунт Telegram для общения с @BotFather.
• 2–3 минуты на создание бота.

Один токен — один канал

Не подключайте один и тот же токен к двум каналам: второй канал создастся, но корректно работать не будет. Для каждого проекта заводите отдельного бота через /newbot.

Шаг 1. Создайте бота в Telegram

1. Откройте @BotFather в Telegram.
2. Отправьте команду /newbot.
3. Укажите имя бота (отображается в профиле) и username — он должен заканчиваться на bot (например, my_support_bot).
4. BotFather пришлёт сообщение с токеном вида 123456789:AAH.... Скопируйте его целиком.

📷 Скриншот: ответ @BotFather с токеном бота (будет добавлен).

Формат токена

Токен Telegram состоит из 8–10 цифр, двоеточия и 35 символов. Вставляйте его целиком и без пробелов — токен другого вида канал отклонит при создании.

Храните токен в секрете

Токен даёт полный доступ к боту. Не публикуйте его. Если токен скомпрометирован — отправьте /revoke в @BotFather и замените токен в настройках канала. В Fixorix токен хранится в зашифрованном виде. В интерфейсе он скрыт: посмотреть его может только Администратор проекта (иконка глаза в панели «Детали бота»).

Шаг 2. Добавьте канал в Fixorix

1. В левом меню в группе «Проект» откройте раздел «Каналы».

2. Нажмите «Создать» — откроется окно «Создание канала».

3. В поле «Платформа» выберите Telegram.

4. Заполните поля:

   Поле	Обязательно	Что вводить
   Название	да	Любое понятное имя канала, например «Поддержка в Telegram».
   Токен бота	да	Токен из @BotFather (шаг 1).

5. Нажмите «Создать». После успешного создания появится уведомление «Бот успешно создан!».

📷 Скриншот: окно «Создание канала» с выбранной платформой Telegram (будет добавлен).

Шаг 3. Запустите канал

Канал не запускается сам

Сразу после создания у канала статус «Остановлен», и сообщения от клиентов не приходят. Пока вы не запустите канал вручную, бот не работает.

1. Найдите новый канал в списке — в колонке «Статус» будет «Остановлен».
2. Нажмите кнопку ▶ (подсказка «Запустить бота») в колонке «Управление».
3. Статус сменится на «Запускается», а через несколько секунд — на «Работает». Обновлять страницу не нужно: статус приходит в реальном времени.

Что видно	Что означает
Запускается	Бот поднимается — подождите несколько секунд
Работает	Бот принимает сообщения клиентов
Останавливается	Идёт остановка
Остановлен	Бот выключен, сообщения не принимаются
Перезапускается	Бот поднимается заново — например, после смены токена
Ошибка	Бот не смог запуститься; чаще всего дело в токене

Шаг 4. Проверьте подключение

1. Напишите своему боту любое сообщение из другого аккаунта Telegram.
2. Откройте «Поддержка» → «Чаты» — новое обращение появится в списке слева.
3. Ответьте на него — сообщение уйдёт клиенту в Telegram.

Управление каналом

Запуск и остановка — кнопки ▶ / ■ в колонке «Управление». Клик по строке канала открывает панель «Детали бота»: название, платформа, статус, «Ссылка на бота» (адрес вида https://t.me/имя_бота) и скрытый «Токен бота»: Администратор может показать и снова скрыть его иконкой глаза, у остальных вместо токена появится сообщение об ошибке. Остановленный бот не принимает сообщения.

Что умеет канал Telegram

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

Смена токена

Если токен пришлось перевыпустить, Администратор открывает карандаш в строке канала, вставляет новый токен в пустое поле «Токен бота» окна «Редактировать бота» и сохраняет. Пустое поле оставляет текущий токен — об этом напоминает подсказка «Оставьте поле пустым, чтобы не менять токен». Бот перезапустится автоматически — статус ненадолго станет «Перезапускается», затем вернётся в «Работает».

Уведомление «Бот успешно обновлен!» появляется в любом случае, поэтому ориентируйтесь на статус: если он не сменился на «Перезапускается», токен не заменён — создайте канал заново с новым токеном, а старый удалите. Подменяйте токен только перевыпущенным токеном того же бота: «Ссылка на бота» при замене токена не обновляется.

Отдельно: если включён переключатель «Перезапуск при сбое» в «Настройки» → «Каналы» → «Боты» (этот блок видит только Владелец проекта), Fixorix сам поднимает упавший бот — первая попытка примерно через минуту, дальше задержка удваивается, но не превышает 30 минут.

Возможные проблемы

Симптом	Причина и решение
При создании появляется «Ошибка при создании бота. Попробуйте еще раз.»	Токен скопирован не полностью, с пробелами, не соответствует формату Telegram или уже отозван. Скопируйте актуальный токен из @BotFather.
Бот создан, но сообщения не приходят	Проверьте статус канала — он должен быть «Работает». Если «Остановлен» — нажмите ▶ («Запустить бота»).
После ▶ статус ненадолго становится «Запускается» и возвращается в «Остановлен»	Скорее всего, выключен «Настройки» → «Каналы» → «Боты» → «Автозапуск ботов» (этот блок видит только Владелец проекта). Попросите владельца включить переключатель.
Статус «Ошибка»	Чаще всего токен неверный или отозван. Администратор проекта может вставить новый токен в окне «Редактировать бота» и сохранить — бот перезапустится. Если статус не сменился на «Перезапускается», создайте канал заново с новым токеном.
Бот «молчит» у клиента	Клиент должен сам начать диалог с ботом (нажать Start). Боты Telegram не могут писать первыми тому, кто им ещё не писал.
Часть сообщений клиента не дошла	При очень быстрой отправке срабатывает защита от флуда — примерно пять сообщений в секунду на клиента. Лишние сообщения отбрасываются молча: ни клиент, ни оператор их не увидят.
В групповом чате бот не реагирует	В группах пересылаются только сообщения, адресованные боту. Обратитесь к боту по имени или ответом на его сообщение.

Что дальше

• Первое обращение — как принять и обработать первый чат.
• Канал Telegram — подробности и ограничения платформы.
• Все каналы — обзор поддерживаемых источников обращений.