Перейти к основному содержимому

✈️ Telegram

Канал подключается как бот Telegram. Клиент пишет вашему боту — сообщение попадает в «Поддержка» → «Чаты».

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

  • Токен бота из @BotFather.
  • Роль в проекте не ниже Редактора: создавать и запускать каналы может Редактор и выше (замена токена — только Администратор).

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

  1. Откройте @BotFather.
  2. Отправьте /newbot, задайте имя и username бота.
  3. Скопируйте выданный токен целиком.
Формат токена

Токен Telegram выглядит так: 123456789:AA... — от 8 до 10 цифр, двоеточие и 35 символов. Вставляйте его без пробелов: токен другого вида, а также уже отозванный токен канал отклонит при создании — появится уведомление «Ошибка при создании бота. Попробуйте еще раз.».

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

  1. «Каналы» → «Создать» — откроется окно «Создание канала».
  2. В поле «Платформа» выберите Telegram.
  3. Заполните «Название» и «Токен бота».
  4. Нажмите «Создать» — появится уведомление «Бот успешно создан!».

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

Новый канал появится в списке со статусом «Остановлен» — сам он не запускается.

Нажмите кнопку ▶ («Запустить бота») в колонке «Управление». Статус пройдёт «Запускается» → «Работает». Только после этого сообщения боту попадают в «Поддержка» → «Чаты».

Что показывает панель «Детали бота»​

Клик по строке канала открывает панель «Детали бота»: название, платформа, статус, «Ссылка на бота» вида https://t.me/<username>, скрытый токен и дата создания. Показать токен может только Администратор — иконкой глаза; у остальных участников вместо токена появится сообщение об ошибке.

Особенности канала​

  • Клиент должен сам начать диалог с ботом (нажать Start) — боты Telegram не пишут первыми тому, кто им не писал.
  • Из входящих сообщений разбираются фото, документы и видео. Если клиент делится контактом, в чат приходит номер телефона; если геолокацией — координаты в виде широта,долгота.
  • Вложения от оператора уходят отдельным сообщением перед текстом и всегда как документ: фото и видео клиент получит файлом.
  • Поддерживаются inline-кнопки (callback, ссылка и Web App — открывает мини-приложение Telegram), кнопки запроса контакта и геолокации, а также нативный ответ-цитата. Смешивать inline-кнопки и кнопки-клавиатуру в одном сообщении не стоит: отрисуются только inline, а запрос контакта и геолокации будет пропущен.
  • Редактирование и удаление сообщений оператором доходят до клиента.
  • Если клиент отредактирует своё сообщение, в переписке Fixorix текст обновится и появится отметка о правке.
  • Текст форматируется на стороне Fixorix: markdown переводится в разметку Telegram, поэтому спецсимволы в ответе не ломают сообщение.

Бот в группе​

Если бота добавили в групповой чат, в поддержку уходят только сообщения, обращённые к нему:

  • упоминание @имя_бота;
  • команда вида /команда или /команда@имя_бота;
  • ответ на сообщение самого бота.

Остальную переписку группы бот игнорирует — она не попадает в раздел «Чаты». В личной переписке фильтр не применяется: там пересылается всё. Правки сообщений в группе проходят через тот же фильтр.

Клиент удалил сообщение — вы этого не увидите

Telegram не сообщает боту об удалении сообщения пользователем. В переписке Fixorix такое сообщение останется как было.

Чего нет в канале

«Печатает…», реакции-эмодзи и галочки доставки и прочтения в Telegram-канале не поддерживаются — как и во всех остальных каналах. Подробнее — Каналы.

Изменение токена​

Если токен пришлось перевыпустить (/revoke в @BotFather), Администратор проекта открывает карандаш в строке канала и вставляет новый токен в пустое поле «Токен бота» окна «Редактировать бота» (пустое поле оставляет текущий токен). После сохранения бот перезапустится — статус ненадолго станет «Перезапускается».

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

Только токен того же бота

«Ссылка на бота» запоминается при создании канала и при замене токена не обновляется. Подменяйте токен только перевыпущенным токеном того же бота. Чтобы подключить другого бота, создайте новый канал.

→ Каналы · Подключение Telegram: пошагово · Первое обращение