Параллельное подключение ботов¶

Hotline позволяет подключаться к ботам параллельно с другими системами — конструкторами ботов, самописными скриптами или внешними сервисами. Почти любой бот может быть подключен к Хотлайн в параллельном режиме и получить мгновенную возможность работы с его потоком сообщений через рабочую топик-группу.

Отличие сессий Хотлайн от Telegram Bot API

Отправка токена бота для подключения к Hotline не завершает существующую сессию, как это происходит при использовании стандартного Telegram Bot API. Обе сессии в таком случае работают одновременно, дополняя функционал друг друга.

Принцип работы¶

При параллельном подключении Hotline продолжает выполнять свою основную роль — транслирует сообщения от пользователей подключенного бота в бекенд-группу и обратно, от операторов на стороне бекенд-группы пользователям (подробнее в обзоре возможностей).

Также Hotline видит исходящие сообщения с параллельной сессии от подключенного бота пользователям и может отображать их в группе как перехваченные (intercepted сообщения).

Параллельное подключение не накладывает каких-то ограничений на использование любых доступных параметров Хотлайн, что открывает множество вариантов использования таких связок.

При этом параллельно подключенный бот может:

Показывать собственное приветствие (с медиа или кнопками)
Обрабатывать свои команды и нажатия на кнопки пользователей
Парсить входящие сообщения от пользователей
Предоставлять webapp интерфейс и многое другое

Гибкая активация топиков

С помощью параметра PRIVATE_KEYWORDS можно настроить активацию топиков в бекенд-группе только после получения специальной команды от пользователя (например: "позвать оператора", "помощь", /help, /chat).

Параллельное подключение безопасно

Параллельная сессия не отключит и никак не повлияет на существующую сессию вашего бота. Ваш бот по прежмену сможет видеть все входящие сообщения от пользователей и callbacks по нажатию на него кнопки. При этом ваш бот не увидит исходящих сообщений через сессию Хотлайн.

Основные сценарии использования¶

Обращение к операторам

Возможность обратиться к оператору поддержки прямо из бота с вашим функционалом (кнопками, вебапами, сценариями, формами).
Контроль ИИ-ботов

Удобный интерфейс для мониторинга переписок ИИ-ботов с пользователями, с возможностью вступления в диалог оператора.
Резервная система

Сохранение потока сообщений через бота и возможность общения через Hotline в случае сбоев основного инструмента.
Мобильный доступ

Оперативные ответы от имени бота с любого устройства через Telegram, когда работа с большой CRM неудобна.
Рассылки и сегментация

Использование системы рассылок Hotline параллельно с вашей основной системой коммуникаций.
Расширение функционала

Добавление кнопок, меню, WebApp или дополнительного парсинга сообщений к базовому функционалу Hotline.

Пример реализации¶

Наш демонстрационный бот показывает работу параллельного подключения:

Запустите @demobuttons_bot и отправьте ему какое-нибудь нескучное сообщение
Данный бот подключен по своему токену параллельно к Hotline и популярному конструктору n8n, на котором реализован показ кнопок и реакций на их нажатия
Бот реагирует на команду /start и показывает приветствие с кнопками для выбора темы обращения, при этом Hotline транслирует исходящие сообщения с кнопками и входящие сообщения от пользователя в бекенд-группу, откуда операторы затем могут ответить пользователю
В рабочую группу можно вступить по ссылке https://t.me/+GCqhEvR4iKM2NWJi, там будут видны перехваченные сообщения от параллельного бота и можно протестировать отправку сообщения самому себе
Для подключения активирован параметр HIDE_INFO, поэтому имена пользователей скрываются, также в группе отключена команда /info
Также у бота присутствует WebApp кнопка с формой, через которую вы можете отправить нам отзыв о работе параллельного подключения

Параметры для параллельных подключений¶

Часто при использовании параллельных подключений могут использоваться следующие параметры.

Отключение или задание приветствия:

WELCOME

Сообщение с приветствием, которое получает пользователь при первом обращении, а также если его обращение было закрыто (переведено в статус /close). На платной версии системы может быть отключено совсем. На бесплатной версии системы в приветсвие обязательно добавляется ссылка на Хотлайн.

Значение по умолчанию: стандартное приветствие на английском языке.

Подробнее о параметре

Двойное приветствие

Если параллельный бот выдает приветствие, к нему добавляется приветствие от Hotline. В бесплатной версии Hotline сообщение с копирайтом системы нельзя убрать.

Отключение вывода возможных ошибок:

SILENT_MODE

Показывать ли клиентам возможные ошибки при обработке их сообщений.

Значение по умолчанию: показывать.

Подробнее о параметре

Отключение перехвата Хотлайном исходящих сообщений:

INTERCEPT_EXTERNAL

Отключает дублирование в бекенд-группу исходящих перехваченных сообщений с параллельных сессий подключенных ботов или аккаунтов.

Значение по умолчанию: TRUE (сообщения дублируются).

Подробнее о параметре

Создание топиков только по ключевым словам в диалоге:

PRIVATE_KEYWORDS

Массив ключевых слов и фраз для фильтрации личных сообщений. Активирует только при обнаружении ключевых слов в сообщении пользователя.

Значение по умолчанию: OFF (без фильтрации).

Подробнее о параметре

Трансляция сообщений

Если не используется параметр PRIVATE_KEYWORDS, все сообщения от пользователя транслируются в бекенд-группу с момента первого обращения.

Важные замечания

Альтернативный подход

Если у вас бот с большим функционалом и значительным потоком пользователей, может быть правильнее завести отдельного бота специально для Hotline и службы поддержки, нежели использовать параллельное подключение к нему (это может расходовать много апдейтов).

Ограничения конструкторов

Некоторые конструкторы ботов не позволяют принимать произвольные пользовательские сообщения и выдают ошибку. К таким системам параллельное подключение делать нецелесообразно.

Получить помощь¶

Если вы желаете приобрести платную версию системы Hotline, либо вам требуется персональная помощь с настройкой параллельного подключения, обратитесь в нашу службу поддержки.