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

📡 Каналы

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

Раздел «Каналы» находится в левом меню в группе «Проект». В одной таблице показаны и боты (Telegram, ВКонтакте, Discord), и виджеты для сайта.

Каналов ровно четыре

Fixorix поддерживает Telegram, ВКонтакте, Discord и веб-виджет — и больше ничего. Электронной почты, WhatsApp, Instagram, звонков и SMS как каналов поддержки в продукте нет: обращения оттуда в систему не попадут.

Названия «WhatsApp» и «Instagram» иногда встречаются в интерфейсе как значения справочника платформ — рабочей интеграции за ними не стоит.

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

Что видно в списке каналов

КолонкаЧто показывает
НазваниеИмя канала, заданное при создании. У виджета под названием мелким шрифтом выводится описание.
ПлатформаПилюля с платформой: Telegram, ВКонтакте, Discord или Виджет.
СтатусТекущее состояние канала — см. «Статусы каналов». Обновляется в реальном времени, страницу перезагружать не нужно.
УправлениеТри кнопки: запуск/остановка, редактирование (карандаш) и удаление (корзина).

Дополнительно:

  • Поиск. Поле «Найти канал...» в шапке раздела ищет по названию, идентификатору, платформе и статусу.
  • Сортировка. Заголовки «Название», «Платформа» и «Статус» кликабельны.
  • Пагинация. По 10 каналов на страницу.
  • Пустой раздел. Если каналов ещё нет, вместо таблицы показывается заглушка с кнопкой «Создать».

Как подключить канал

Нажмите «Создать» — откроется окно «Создание канала». В поле «Платформа» доступны четыре варианта:

Для ботов заполняются «Название» и «Токен бота»; для ВКонтакте добавляется поле «ID группы». Виджет создаётся трёхшаговым мастером — подробности на странице «Виджет».

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

После нажатия «Создать» появится уведомление «Бот успешно создан!», но канал получит статус «Остановлен» — сообщения от клиентов приходить не будут.

Чтобы канал заработал, нажмите кнопку запуска (, подсказка «Запустить бота») в колонке «Управление». Статус сменится на «Запускается», затем на «Работает».

Статусы каналов

Статус канала-бота показывается пилюлей в колонке «Статус» и в панели «Детали бота». Он приходит с сервера в реальном времени.

СтатусЧто означает
ЗапускаетсяКоманда запуска отправлена, бот подключается к платформе.
РаботаетКанал активен, сообщения клиентов доходят до «Поддержка» → «Чаты».
ОстанавливаетсяОтправлена команда остановки, бот завершает работу.
ОстановленКанал выключен. Это состояние канал получает сразу после создания.
ОшибкаБот не смог подключиться или упал во время работы.
ПерезапускаетсяБот перезапускается — например, после сохранения изменений в окне «Редактировать бота».

У виджета жизненный цикл проще: он показывается как «Работает» или «Остановлен», а кнопка в строке подписана «Выключить виджет» / «Включить виджет».

Что делать при статусе «Ошибка»

Чаще всего причина — неверный или отозванный токен. Откройте канал, проверьте токен в окне «Редактировать бота», сохраните и дождитесь перезапуска.

Автоматическое восстановление

Если в «Настройки» → «Каналы» → «Боты» включён переключатель «Перезапуск при сбое», 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 и ссылка) и кнопки запроса контакта и геолокации; Discord — callback и кнопки-ссылки; ВКонтакте — только текстовые кнопки: нажатие приходит в чат как обычное сообщение с текстом кнопки, а кнопки-ссылки не поддерживаются.
  • Цитирование. Ответ оператора на конкретное сообщение доставляется как настоящий reply во всех трёх мессенджерах и в виджете; цитата, на которую отвечает клиент, тоже подтягивается в чат.
Не редактируйте сообщения, отправленные в Discord

Редактирование сообщений в Discord не работает: вместо вашего текста клиенту подставляется служебная строка «Новое содержимое». Если нужно исправить ответ — удалите сообщение и отправьте новое.

Пока не работает

Блок «Индикатор набора» есть в редакторе сценариев, но в каналы он ничего не отправляет — «печатает…» клиент не увидит.

Ни в одном канале нет «печатает», реакций и галочек прочтения

Три вещи, которых клиент не увидит и оператор не получит ни в Telegram, ни во ВКонтакте, ни в Discord, ни в виджете:

  • индикатор набора — «печатает…» не передаётся ни в одну сторону;
  • реакции-эмодзи на сообщение — их нельзя ни поставить, ни увидеть;
  • статусы доставки и прочтения у отдельного сообщения — галочек «доставлено» и «прочитано» нет.

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

Слишком частые сообщения теряются

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

Размер вложений

Оператор может приложить к сообщению файл размером до 1 МБ — иначе появится ошибка «Файл … слишком большой». Посетитель виджета может загрузить файл до 10 МБ. Сверх этого действуют лимиты самих платформ.

Настройки каналов

Часть поведения каналов настраивается в разделе «Настройки», вкладка «Каналы»:

БлокНастройкаЧто делает
Боты«Автозапуск ботов»Разрешает запуск ботов. При выключенном переключателе нажатие ▶ не срабатывает.
Боты«Перезапуск при сбое»Автоматически поднимает бота после ошибки.
Сообщения«Вложения», «Перевод сообщений»Переключатели сохраняются в настройках проекта.
Коммуникации«Онлайн-чат», «Обратный звонок»Переключатели сохраняются в настройках проекта.
Платформы«Email», «Telegram», «VK»Переключатели сохраняются в настройках проекта.
Пока не работает

Переключатели блоков «Сообщения», «Коммуникации» и «Платформы» сохраняются, но на работу каналов сейчас не влияют: ни один сервис их не учитывает. Реально действуют только настройки блока «Боты».

Переключатели блоков «Коммуникации» и «Платформы» доступны на изменение только Владельцу проекта — остальным участникам они видны, но заблокированы.

Кто может управлять каналами

ДействиеМинимальная роль
Открывать раздел и видеть каналыПо умолчанию
Создавать канал, переименовывать, запускать и останавливатьРедактор
Включать и выключать виджетРедактор
Менять токен ботаАдминистратор

Кнопка, на которую у участника нет права, не отображается.

Пользователи и роли

Единая очередь

Независимо от канала, все обращения отображаются в «Поддержка» → «Чаты». Канал обращения виден и в строке списка чатов, и в карточке чата (правая панель).

Система поддержки