База Знаний

hotline.tg

Бот для массовых Telegram рассылок и сегментации аудитории

Возможности команд /send, /mark и /export для Telegram CRM Hotline.
После подключения вашего бота или регулярного пользовательского аккаунта к Hotline CRM (подключается параллельно к существующим ботам или аккаунтам, не влияет на их работу, делается бесплатно за несколько минут), появляется возможность использования трех мощнейших взаимосвязанных команд из нашего бота расширений на стороне вашей бекенд-группы:

/send – для массовых рассылок отдельных сообщений или шаблонов с цепочками сообщений Телеграм-пользователям

/mark – для задания меток (дополнительных статусов) пользовательским топикам и определения поведения меток

/export – для экспорта в виде файла списка пользователей, с которыми была переписка через систему Hotline и/или обладающих указанной меткой
Подключение бота расширений
Для использования описанных в данной статье команд необходимо добавить бота расширений @hotlinetg_extensions_bot с правами администратора в вашу бекенд-группу.

Базовая версия Hotline (ядро системы) отвечает за надежную трансляцию потока сообщений с пользователями и содержит только основной функционал.
Лимиты системы рассылки
Бесплатная версия системы позволяет отправлять через систему рассылок командой /send до 200 сообщений в месяц. Платная версия системы позволяет отправлять до 1000*N сообщений в месяц, где N равно числу операторов системы в платной подписке.

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

Ограничений для команд /mark и /export нет.
Быстрая справка
Для получения быстрой справки на английском языке в вашей бекенд-группе можно в любой момент отправить команду /send, /mark или /export без параметров в соответствующем контексте (в General топике, пользовательском топике, или в ответе на сообщение).
Ограничение доступа
Административные функции команд /send, /mark и /export доступны только из General топика бекенд-группы, доступ к ним может быть ограничен через специальный параметр @EXTENSIONS_ALLOWED@ в установочном боте @hotlinetg_bot.

Варианты использования команды /send

Команда /send позволяет отправлять отдельные сообщения или даже цепочки сообщений, содержащие все основные типы сообщений Telegram: текст с любым форматированием, стикеры, голосовые сообщения, видео, изображения, файлы.

В качестве получателей рассылки могут быть указаны:
  • оператор, выполняющий команду /send, для тестирования сообщения (опция test)
  • все пользователи, с которыми существует диалог (топик) через систему Hotline (опция all)
  • список пользователей в прикрепленном файле (опция file)
  • список пользователей через запятую в самой команде (опция list)
  • все пользователи, которым задана соответствующая метка командой /mark (опция mark)

Отправлять можно как отдельные сообщения (без сохранения рассылки в качестве шаблона), так и цепочки сообщений (сохранив отдельное сообщение или последовательность сообщений в виде шаблона с нужными опциями).

Для каждого отправляемого сообщения в необязательном параметре [now,delay,datetime] можно указать время отправки:
  • now (для отправки в момент вызова команды, используется по умолчанию)
  • с задержкой в формате 100s 10m 5h 2d (от 1 до 4 параметров с нужным числом секунд, минут, часов или дней) с момента отправки команды или момента отправки предыдущего сообщения цепочки)
  • фиксированной датой и временем отправки по UTC в формате 2024-12-27 14:25:55
Команда /send имеет 3 основных контекста использования:

Не обязательные параметры для команд указаны в [квадратных] скобках.

/send в General топике в качестве reply на сообщение

Отправка сообщения нужному списку получателей
↳ /send test [now,delay,datetime] [instance_id]
Отправить указанное в reply сообщение себе самому для тестирования
↳ /send all [now,delay,datetime] [instance_id]
Отправить указанное в reply сообщение всем пользователям, с которыми когда либо был диалог через Hotline
↳ /send file [now,delay,datetime] [instance_id]
Отправить указанное в reply сообщение всем пользователям, user_id которых указан в прикрепленном файле. Список user_id в файле может быть разделен запятыми, пробелом или новой строкой. Нечисловые значения из файла игнорируются.
↳ /send list [now,delay,datetime] [instance_id] USERS_LIST
Отправить указанное в reply сообщение всем пользователям, user_id которых указан в списке (последний параметр команды). Значения в списке user_id разделяются запятыми.
↳ /send mark MARK_NAME [now,delay,datetime] [instance_id]
Отправить указанное в reply сообщение всем пользователям с заданной меткой MARK_NAME через команду /mark.
Необязательный параметр instance_id может быть указан, если в одну бекенд-группу подключено несколько инстансов и необходимо явно указать для какого из них необходимо выполнить команду из General топика. По умолчанию все команды выполняется независимо для каждого инстанса Hotline.
Создание шаблона для отправки или добавление сообщения в существующий шаблон
↳ /send TEMPLATE_NAME [now,delay,datetime]
Добавляет указанное в reply сообщение в новый или существующий шаблон с именем TEMPLATE_NAME. Имя шаблона должно начинаться с латинской буквы, может содержать цифры, дефис или знак подчеркивания, регистр букв не учитывается. Шаблон может содержать как одно сообщение, так и цепочку сообщений. Можно задать время отправки сообщения (с момента вызова команды для первого сообщения, или момента отправки предыдущего сообщения в цепочке).

/send в General топике (без reply)

Отправка сообщений из указанного шаблона нужному списку получателей
/send test TEMPLATE_NAME [now,delay,datetime] [instance_id]
Отправить шаблон TEMPLATE_NAME себе самому для тестирования
/send all TEMPLATE_NAME [now,delay,datetime] [instance_id]
Отправить шаблон TEMPLATE_NAME всем пользователям, с которыми когда либо был диалог через Hotline
/send file TEMPLATE_NAME [now,delay,datetime] [instance_id]
Отправить шаблон TEMPLATE_NAME всем пользователям, user_id которых указан в прикрепленном файле. Список user_id в файле может быть разделен запятыми, пробелом или новой строкой. Нечисловые значения из файла игнорируются.
/send list TEMPLATE_NAME [now,delay,datetime] [instance_id] USERS_LIST
Отправить шаблон TEMPLATE_NAME всем пользователям, user_id которых указан в списке (последний параметр команды). Значения в списке user_id разделяются запятыми.
/send mark MARK_NAME template TEMPLATE_NAME [now,delay,datetime] [instance_id]
Отправить шаблон TEMPLATE_NAME всем пользователям с заданной меткой MARK_NAME через команду /mark.
Просмотр списка или свойств созданных шаблонов и рассылок
/send templates
Показать все созданные шаблоны для рассылок.
/send sendings [instance_id]
Показать последние созданные рассылки (если в бекенд-группу подключено несколько инстансов, то можно указать по какому именно).
/send TEMPLATE_NAME
Показать свойства указанного шаблона для рассылки.
/send sidSENDING_ID
Показать статус и свойства указанной рассылки, а также получить отчет об ее выполнении на текущий момент.
Редактирование и удаление шаблонов и рассылок
/send TEMPLATE_NAME name NEW_NAME
Задать новое имя для шаблона
/send TEMPLATE_NAME for MESSAGE_ID [now,delay,datetime]
Задать в шаблоне новое время отправки для сообщения с указанным ID
/send TEMPLATE_NAME del MESSAGE_ID
Удалить из шаблона сообщение с указанным ID
/send TEMPLATE_NAME del
Удалить указанный шаблон
/send sidSENDING_ID del
Удалить и отменить рассылку с указанным ID (доступно, только если рассылка еще не выполнялась и находится в статусе awaits)

/send в пользовательском топике (без reply)

Отправка указанного шаблона пользователю топика
/send TEMPLATE_NAME [now,delay,datetime]
Дополнительно можно указать время отправки.
Показ информации о шаблонах и рассылках
/send templates
Показать созданные в бекенд-группе шаблоны.
/send sendings
Показать отправки командой /send для текущего топика.
/send sidSENDING_ID
Показать статус и свойства указанной отправки (без получения отчета).
ВАЖНО: После добавления бота расширений @hotlinetg_extensions_bot в вашу бекенд-группу все вызываемые в пользовательских топиках функции команд /send и /mark становятся доступны всем пользователям бекенд-группы (сотрудникам, менеджерам). При этом администраторские функции команд /send, /mark или /export, вызываемые в General топике можно ограничить через параметр @EXTENSIONS_ALLOWED@ у соответствующего подключения в установочном боте @hotlinetg_bot.

Варианты использования команды /mark

Команда /mark позволяет задавать произвольный набор меток топикам с диалогами на стороне бекенд-группы (это могут быть как топики диалогов с пользователями или ботами, так и топики для общения в группах).

Метки могут быть использованы для задания произвольных дополнительных свойств топикам и/или удобных вспомогательных операций.
Возможности меток:

  • задание топикам дополнительных свойств для сегментации и/или последующего использования в рассылках командой /send или при экспорте командой /export
  • задание статусов воронки продаж, когда задание следующего статуса снимает все предыдущие статусы из заданного набора (параметр after)
  • автоматическая отправка шаблона с цепочкой сообщений после назначения топику соответствующей метки (параметр sends)
  • отображение в названии топика короткой строки или emoji, содержащей инициалы ответственного за сделку менеджера, флаг страны/языка пользователя или иное свойство (параметр ticker)
Команда /mark имеет 2 основных контекста использования:

/mark в General топике

/mark
Показать список созданных меток для данной бекенд-группы.
/mark new MARK_NAME
Создать новую метку с заданным именем. Имя метки должно начинаться с латинской буквы, может содержать латинские буквы, цифры, дефис или знак подчеркивания, регистр букв не учитывается.
/mark MARK_NAME
Показать свойства метки и список топиков с данной меткой.
/mark MARK_NAME after MARK1, MARK0
Задать параметр AFTER для метки. Значением указывается список названий меток, которые будут убраны у топика при назначении данной метки. Список может быть произвольной длинны, значения разделяются запятыми. Для очистки параметра отправьте значение CLEAR.
/mark MARK_NAME sends TEMPLATE_NAME
Задать параметр SENDS для метки. Значением указывается название шаблона команды /send (с одним сообщением или цепочкой сообщений), который будет активирован при назначении данной метки. Для очистки параметра отправьте значение CLEAR.
/mark MARK_NAME ticker STRING|EMOJI
Задать параметр TICKER для метки. Значением может быть короткая строка (латинские буквы, цифры, дефис, подчеркивание) или emoji, которые будут добавлены к названию топика при назначении данной метки. Для очистки параметра отправьте значение CLEAR.
/mark MARK_NAME name NEW_MARK_NAME
Задать новое имя для метки.

/mark в топике с диалогом

/mark
Показать список заданных меток для данного топика.
/mark MARK_NAME
Добавить указанную метку для данного топика.
/mark del MARK_NAME
Удалить указанную метку для данного топика.

Использование команды /export

Команда /export позволяет получить в виде файла список пользователей, с которыми была переписка через систему Hotline и обладающих указанной меткой.
Команда может быть использована только в General топике группы.
/export all
Экспортирует все топики в виде CSV файла, который содержит все основные свойства топика (user_id, дата последнего сообщения, статус диалога, название топика, тип топика, ссылку на топик).
/export MARK_NAME
Экспортирует все топики с заданной меткой в виде CSV файла в описанном выше формате.
В случае возникновения трудностей при использовании функций бота расширений обращайтесь к службе поддержки.