Работа с чатами¶

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

Возможности работы с чатами¶

При активации параметров MONITOR_GROUPS или MONITOR_CHANNELS в настройках подключения становятся доступны следующие функции:

Получение сообщений из чатов в соответствующий топик бекенд-группы Hotline
Отправка сообщений в чаты от имени подключенного бота или аккаунта через бекенд-группу
Фильтрация по ключевым словам — автоматическая активация трансляции при появлении заданных слов параметрами GROUPS_KEYWORDS и CHANNELS_KEYWORDS

Особенности бесплатной версии

На бесплатной версии Hotline при активации каждого топика с чатом в него будет отправлено приветственное сообщение с копирайтом Hotline из параметра WELCOME.

Также топики автоматически закрываются при отсутствии активности в них спустя таймаут из параметра AUTOCLOSE

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

Ограничения при защите от копирования

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

Особенности подключений¶

Для ботовДля аккаунтов

Возможности:

Бот может видеть все сообщения в чатах, куда его добавил администратор чата
Команда может отвечать от имени бота в чаты через бекенд-группу
Фильтрация чатов по ключевым словам
Мониторинг и дублирование сообщений из приватных чатов

Важные особенности:

Добавление бота в чат

Бота в чат может добавить только администратор чата. Бот не может самостоятельно вступать в группы.

При необходимости отправки сообщений ботом в чат, убедитесь что у бота достаточно прав для этого.

Отключите Privacy Mode в BotFather

Если вы планируете работать в группах через бота, обязательно отключите параметр Privacy Mode для него в @BotFather По умолчанию режим для ботов активен и они не видят все сообщения в группах.

Как отключить:

Откройте @BotFather
Отправьте /mybots
Выберите вашего бота
Bot Settings → Group Privacy → Turn off

Возможности:

Могут вступать самостоятельно в публичные и приватные чаты, включая топик-группы (вступление в чаты командой /new с указанием ссылки или имени чата)
Создание новых чатов от имени подключенного аккаунта
Actions API для программного управления чатами
Команда ваших операторов может отвечать от имени аккаунта в чаты
Фильтрация чатов по ключевым словам
Мониторинг и дублирование сообщений из приватных чатов

Добавление в чаты¶

Для ботовДля аккаунтов

Бота может добавить в чат только администратор чата:

Откройте нужный чат в Telegram
Нажмите на название чата → Add Members
Найдите вашего бота по username
Выберите его и добавьте в чат
При необходимости предоставьте права администратора

Способ 1: Стандартный способ в Telegram

Аккаунт может самостоятельно вступить в публичный чат или быть приглашенным в приватную группу обычным способом через приложение Telegram.

Способ 2: Команда /new через бекенд-группу

Используйте команду /new в топике General бекенд-группы Hotline:

/new CHAT_USERNAME
или
/new https://t.me/CHAT_USERNAME    
или
/new https://t.me/+INVITE_HASH

Подробнее о команде /new

Активация и управление топиками¶

При активном MONITOR_GROUPS или MONITOR_CHANNELS топик для чата на стороне бекенд-группы создается и активируется автоматически:

При упоминании (@mention) подключенного аккаунта или бота в чате
При ответе (reply) на сообщение подключенного аккаунта или бота
При появлении ключевых слов из параметров GROUPS_KEYWORDS или CHANNELS_KEYWORDS
При любом входящем сообщении с активным параметром LEAVE_CLOSED

Управление трансляцией¶

Непрерывная трансляция всех сообщений из чата в топик бекенд-группы ведется только когда топик имеет статус отличный от closed (желтый 🟨 или фиолетовый 🟪, активируются командами /wait или /hold).

Если закрыть топик командой /close, трансляция сообщений в него прекращается.

Подробнее о статусах топиков

Параметр LEAVE_CLOSED

При активном параметре LEAVE_CLOSED новые топики создаются в закрытом состоянии. В него будут пересылаться только сообщения с ключевым словом, а трансляция активируется только по решению оператора.

Особенность трансляций из других топик-групп

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

Фильтрация чатов по ключевым словам¶

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

Ключевые слова и правила для фильтрации задаются в параметрах GROUPS_KEYWORDS или CHANNELS_KEYWORDS

В качестве единого набора минус-слов может быть полезен параметр RESTRICTED_KEYWORDS_FRONTEND

Работа с активированными топиками¶

При активации топика по ключевым словам:

В топик транслируются все сообщения из чата, начиная с сообщения с ключевым словом
В транслированных сообщениях показываются ссылки на профили авторов
Операторы могут отвечать в чат от имени бота/аккаунта
Можно писать в личку автору сообщения
Или пассивно следить за беседой без участия

Для прекращения трансляции отправьте команду /close в топике.

Расширенная конфигурация фильтров

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

Используемые параметры¶

Активация мониторинга сообщений из групп или каналов:

MONITOR_GROUPS

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

Значение по умолчанию: FALSE (группы не мониторятся).

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

MONITOR_CHANNELS

Создавать и активировать топики при появлении новых сообщений в каналах, на которые подписан подключённый аккаунт или в которых состоит бот.

Значение по умолчанию: FALSE (каналы не мониторятся).

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

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

WELCOME

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

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

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

Отключение автоматического закрытия топиков:

AUTOCLOSE

Период автозакрытия диалога после последнего ответа оператора, задается числом часов. Если топик с пользователем был закрыт, то он получит приветствие из параметра WELCOME при повторном обращении. На бесплатной версии системы максимальный период автозакрытия 48 часов.

Значение по умолчанию: 48 часов.

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

Ключевые слова и правила для фильтрации задаются в параметрах:

GROUPS_KEYWORDS

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

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

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

CHANNELS_KEYWORDS

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

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

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

Скрытие информации об участниках чатов для операторов:

HIDE_INFO

Определяет, какая информация о клиентах скрывается от операторов (имена, названия групп, ссылки на пользователей, вывод команды /info).

Значение по умолчанию: NONE (вся информация доступна).

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

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

RESTRICTED_KEYWORDS_FRONTEND

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

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

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

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

RESTRICTED_KEYWORDS_BACKEND

Массив запрещенных ключевых слов для исходящих сообщений. Вызывает ошибку при попытке отправки сообщения с указанными словами.

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

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

Практические сценарии использования¶

Командная поддержка чатов

Круглосуточная служба поддержки клиентских чатов командой операторов от имени бота или аккаунта.
Поиск лидов

Автоматический поиск потенциальных клиентов в Telegram-чатах по ключевым запросам.
Мониторинг упоминаний

Отслеживание упоминаний компании, продуктов или конкурентов в тематических чатах и каналах.
Регулярный постинг

Публикация новостей, объявлений или контента в чаты от имени аккаунта или бота через бекенд-группу.
Резервная копия сообщений

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