📡 Каналы
Канал — источник, через который клиенты обращаются в поддержку. Все обращения из подключённых каналов попадают в единую очередь раздела «Поддержка», и оператор отвечает на них из одного интерфейса, не переключаясь между приложениями.
Раздел «Каналы» находится в левом меню в группе «Проект». В одной таблице показаны и боты (Telegram, ВКонтакте, Discord), и виджеты для сайта.
Fixorix поддерживает Telegram, ВКонтакте, Discord и веб-виджет — и больше ничего. Электронной почты, WhatsApp, Instagram, звонков и SMS как каналов поддержки в продукте нет: обращения оттуда в систему не попадут.
Названия «WhatsApp» и «Instagram» иногда встречаются в интерфейсе как значения справочника платформ — рабочей интеграции за ними не стоит.
📷 Скриншот: список каналов проекта (будет добавлен).
Что видно в списке каналов
| Колонка | Что показывает |
|---|---|
| Название | Имя канала, заданное при создании. У виджета под названием мелким шрифтом выводится описание. |
| Платформа | Пилюля с платформой: Telegram, ВКонтакте, Discord или Виджет. |
| Статус | Текущее состояние канала — см. «Статусы каналов». Обновляется в реальном времени, страницу перезагружать не нужно. |
| Управление | Кнопки запуска/остановки, редактирования (карандаш) и удаления (корзина). Какие из них видны, зависит от роли — см. «Кто может управлять каналами». |
Токен бота в списке не выводится.
Дополнительно:
- Поиск. Поле «Найти канал...» в шапке раздела фильтрует только текущую загруженную страницу; при вводе список возвращается на первую страницу. Ботов оно находит по названию, ID и латинскому коду платформы или статуса (
telegram,vk,discord,up,down,error) — по русским подписям вроде «ВКонтакте» или «Работает» поиск не сработает. Виджеты находятся по названию и ID. - Сортировка. Заголовки «Название», «Платформа» и «Статус» кликабельны.
- Пагинация. На странице до 10 ботов и до 10 виджетов.
- Пустой раздел. Если каналов ещё нет, вместо таблицы показывается заглушка с кнопкой «Создать».
Как подключить канал
Нажмите «Создать» (кнопка видна участникам с ролью Редактор и выше) — откроется окно «Создание канала». В поле «Платформа» доступны четыре варианта:
Для ботов заполняются «Название» и «Токен бота»; для ВКонтакте добавляется поле «ID группы». Если токен не подошёл, появится уведомление «Ошибка при создании бота. Попробуйте еще раз.». Виджет создаётся трёхшаговым мастером — подробности на странице «Виджет».
После нажатия «Создать» появится уведомление «Бот успешно создан!», но канал получит статус «Остановлен» — сообщения от клиентов приходить не будут.
Чтобы канал заработал, нажмите кнопку запуска (▶, подсказка «Запустить бота») в колонке «Управление». Статус сменится на «Запускается», затем на «Работает».
Статусы каналов
Статус канала-бота показывается пилюлей в колонке «Статус» и в панели «Детали бота». Он приходит с сервера в реальном времени.
| Статус | Что означает |
|---|---|
| Запускается | Команда запуска отправлена, бот подключается к платформе. |
| Работает | Канал активен, сообщения клиентов доходят до «Поддержка» → «Чаты». |
| Останавливается | Отправлена команда остановки, бот завершает работу. |
| Остановлен | Канал выключен. Это состояние канал получает сразу после создания. |
| Ошибка | Бот не смог подключиться или упал во время работы. |
| Перезапускается | Бот перезапускается: после замены токена в окне «Редактировать бота» или когда Fixorix переносит бота на другой сервер (например, во время обновления системы). |
У виджета жизненный цикл проще: он показывается как «Работает» или «Остановлен», а кнопка в строке подписана «Выключить виджет» / «Включить виджет».
Чаще всего причина — неверный или отозванный токен. Администратор может сверить текущий токен в панели «Детали бота» (иконка глаза), затем вставить новый токен в окне «Редактировать бота» и сохранить — после замены бот перезапустится. Если статус после сохранения не сменился на «Перезапускается», создайте канал заново с новым токеном, а старый удалите.
Автоматическое восстановление
Если в «Настройки» → «Каналы» → «Боты» включён переключатель «Перезапуск при сбое», Fixorix сам поднимает упавший бот: первая попытка примерно через минуту, дальше задержка удваивается, но не превышает 30 минут. Канал, зависший в состоянии «Останавливается» дольше пяти минут, останавливается повторно. Восстановление работает, только если в том же блоке включён «Автозапуск ботов».
Панель «Детали бота»
Клик по строке канала открывает справа панель «Детали бота»:
| Поле | Содержимое |
|---|---|
| Название | Имя канала. |
| Платформа | Telegram, ВКонтакте или Discord. |
| Статус | Текущее состояние канала. |
| ID группы | Только для ВКонтакте — числовой идентификатор сообщества. |
| Ссылка на бота | Кликабельная ссылка: t.me/<username> для Telegram, vk.ru/club<ID группы> для ВКонтакте, discord.com для Discord. |
| Токен бота | Скрыт точками. Иконка глаза справа («Показать токен») запрашивает полное значение, повторное нажатие снова его скрывает. |
| Дата создания | Когда канал был добавлен. |
В панели «Детали бота» токен скрыт точками, в списке каналов он не выводится вовсе. Иконку глаза видят все участники, но полный токен откроется только участнику с ролью Администратор — остальным вместо токена покажется сообщение об ошибке.
У виджета по клику на строку открывается своя панель — «Детали виджета», см. «Виджет».
Изменение и удаление канала
- Карандаш в колонке «Управление» (виден Редактору и выше) открывает окно «Редактировать бота»:
- поле «Название» может изменить Редактор и выше; переименование бота не перезапускает;
- поле «Токен бота» видит только Администратор. Оно всегда пустое, под ним подсказка «Оставьте поле пустым, чтобы не менять токен». Если вставить новый токен и сохранить, бот перезапустится (статус «Перезапускается») — причём запустится и бот, который до этого был остановлен;
- у ВКонтакте в окне есть поле «ID группы», но его изменение не сохраняется. Чтобы привязать другое сообщество, создайте новый канал.
- Корзина (видна только Администратору) открывает подтверждение «Вы уверены, что хотите удалить бота?» с предупреждением «Это действие нельзя отменить.».
Уведомление «Бот успешно обновлен!» появляется после сохранения, даже если изменение не применилось. После замены токена убедитесь, что статус сменился на «Перезапускается», а затем на «Работает». Если статус не изменился, токен не заменён — создайте канал заново с новым токеном, а старый удалите.
Возможности по каналам
Набор поддерживаемых функций зависит от канала. В таблице — то, что реально умеет интеграция Fixorix, а не платформа в целом.
| Возможность | Telegram | ВКонтакте | Discord | Виджет |
|---|---|---|---|---|
| Текст | ✅ | ✅ | ✅ | ✅ |
| Входящие фото | ✅ | ✅ | ✅ | ✅ |
| Входящие файлы и документы | ✅ | ✅ | ✅ | ✅ |
| Входящее видео | ✅ | ❌ | ✅ | ⚠️ |
| Аудио и голосовые сообщения | ❌ | ❌ | ⚠️ | ⚠️ |
| Стикеры, GIF | ❌ | ❌ | ⚠️ | ❌ |
| Вложения от оператора | ✅ | ✅ | ✅ | ✅ |
| Геолокация (от клиента) | ✅ | ❌ | ❌ | ❌ |
| Контакт (от клиента) | ✅ | ❌ | ❌ | ❌ |
| Кнопки под сообщением | ✅ | ⚠️ | ✅ | ✅ |
| Ответ на сообщение (цитирование) | ✅ | ✅ | ✅ | ⚠️ |
| Редактирование сообщений оператором | ✅ | ✅ | ❌ | ❌ |
| Удаление сообщений оператором | ✅ | ✅ | ⚠️ | ❌ |
| Правка сообщения клиентом | ✅ | ✅ | ✅ | ❌ |
| Реакции (эмодзи) | ❌ | ❌ | ❌ | ❌ |
Обозначения: ✅ — поддерживается · ❌ — нет · ⚠️ — частично.
Примечания:
- Telegram. Вложения от оператора уходят отдельным сообщением перед текстом и всегда как документ — фото и видео клиент получит файлом. Если клиент делится контактом, в чат приходит номер телефона; если геолокацией — координаты в виде
широта,долгота. - ВКонтакте. Из входящего сообщения разбираются фото (берётся самый крупный размер) и документы. Видео, аудиосообщения, стикеры и граффити пока не разбираются. Файлы от оператора уходят клиенту документами.
- Discord. Из входящего сообщения забираются любые вложения независимо от типа: файл, видео, аудиофайл, GIF-вложение. Встроенные стикеры Discord не передаются. Удаление сообщений оператором работает только в текстовых каналах сервера: в личной переписке с ботом удалённое оператором сообщение у клиента останется.
- Виджет. Посетитель выбирает файлы по одному, но к одному сообщению может приложить несколько; картинки показываются превью, остальные файлы — ссылкой для скачивания.
- Кнопки под сообщением. Telegram — inline-кнопки (callback, ссылка и Web App — открывает мини-приложение Telegram) и кнопки запроса контакта и геолокации. Discord — callback и кнопки-ссылки; кнопки Web App, запроса контакта и геолокации приходят туда обычными кнопками: нажатие уходит в сценарий, но мини-приложение не открывается и данные не запрашиваются. ВКонтакте — только текстовые кнопки: нажатие приходит в чат как обычное сообщение с текстом кнопки, а кнопки-ссылки не поддерживаются. В виджете кнопка Web App открывает адрес как ссылку, а кнопки запроса контакта и геолокации отправляют только свой текст.
- Цитирование. Ответ оператора на конкретное сообщение доставляется как настоящий reply во всех трёх мессенджерах и в виджете. Цитата, на которую отвечает клиент, подтягивается в чат из мессенджеров. В виджете посетитель видит ответ оператора с цитатой, но сам ответить с цитатой не может.
- Правка сообщения клиентом. Если клиент отредактирует своё сообщение в Telegram, ВКонтакте или Discord, в переписке Fixorix текст обновится и появится отметка о правке.
Редактирование сообщений в Discord не работает: вместо вашего текста клиенту подставляется служебная строка «Новое содержимое». Если нужно исправить ответ — удалите сообщение и отправьте новое.
Три вещи, которых клиент не увидит и оператор не получит ни в Telegram, ни во ВКонтакте, ни в Discord, ни в виджете:
- индикатор набора — «печатает…» не передаётся ни в одну сторону. Блока «Индикатор набора» в редакторе сценариев нет; если он остался в старом опубликованном сценарии, он ничего не отправляет;
- реакции-эмодзи на сообщение — их нельзя ни поставить, ни увидеть;
- статусы доставки и прочтения у отдельного сообщения — галочек «доставлено» и «прочитано» нет.
«Прочитано» в Fixorix существует только на уровне всего обращения: система считает непрочитанные сообщения для оператора и показывает их числом у пункта «Чаты». Узнать, прочитал ли клиент конкретный ответ, нельзя.
В каналах-ботах (Telegram, ВКонтакте, Discord) стоит защита от флуда: примерно 5 сообщений в секунду от одного пользователя и столько же суммарно на одного бота (от всех его клиентов вместе). Всё, что сверх лимита, молча отбрасывается: клиент не получает ошибки, и в поддержку эти сообщения не попадают. В обычной переписке порог недостижим, но при массовой автоматической отправке это стоит учитывать. Виджета это ограничение не касается.
Оператор может приложить к сообщению файл размером до 1 МБ. Файл крупнее не прикладывается, а в области ввода сообщения появляется красная строка ошибки (сейчас вместо понятного текста там выводится служебная строка chats.fileTooLarge). Посетитель виджета может загрузить файл до 10 МБ. Сверх этого действуют лимиты самих платформ.
Настройки каналов
Часть поведения каналов настраивается в разделе «Настройки», вкладка «Каналы»:
| Блок | Настройка | Что делает |
|---|---|---|
| Боты | «Автозапуск ботов» | Разрешает запуск ботов. Если переключатель выключен, после нажатия ▶ статус ненадолго станет «Запускается» и вернётся в «Остановлен». Автоматическое восстановление после сбоя в этом случае тоже не работает. |
| Боты | «Перезапуск при сбое» | Автоматически поднимает бота после ошибки. |
| Сообщения | «Вложения», «Перевод сообщений» | Переключатели сохраняются в настройках проекта. |
| Коммуникации | «Онлайн-чат», «Обратный звонок» | Переключатели сохраняются в настройках проекта. |
| Платформы | «Email», «Telegram», «VK» | Переключатели сохраняются в настройках проекта. |
Переключатели блоков «Сообщения», «Коммуникации» и «Платформы» сохраняются, но на работу каналов сейчас не влияют: ни один сервис их не учитывает. Реально действуют только настройки блока «Боты».
Блоки «Боты» и «Сообщения» видит и меняет только Владелец проекта — остальным участникам они не показываются. Блоки «Коммуникации» и «Платформы» доступны любому участнику с ролью в разделе «Тех. поддержка» (достаточно уровня «По умолчанию»).
Кто может управлять каналами
| Действие | Минимальная роль |
|---|---|
| Открывать раздел и видеть каналы | По умолчанию |
| Создавать канал (бот или виджет), переименовывать бота, запускать и останавливать бота | Редактор |
| Включать и выключать виджет, менять его название, описание, оформление и домен | Редактор |
| Сбрасывать HMAC-секрет виджета, удалять виджет | Администратор |
| Менять токен бота | Администратор |
| Смотреть полный токен бота (иконка глаза в панели «Детали бота») | Администратор |
| Удалять бота | Администратор |
Кнопки управления ботом, на которые у участника нет права, не отображаются. Исключения — иконка глаза у токена (она видна всем, но токен покажется только Администратору) и кнопки виджета, которые видны всем участникам: без нужной роли действие завершится ошибкой.
Единая очередь
Независимо от канала, все обращения отображаются в «Поддержка» → «Чаты». Канал обращения виден и в строке списка чатов, и в карточке чата (правая панель).