Базовые команды¶

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

/ Внутренние комментарии¶

Любое сообщение, начинающееся с символа / и пробелом за ним, считается внутренним комментарием и не отправляется клиенту.

/ Разговаривал с клиентом по телефону, ему нужна другая модель работы нашей команды

/ TODO: уточнить у маркетинг-отдела условия будущей акции и отправить клиенту

/ @alex108 помоги разобраться с этим случаем, тут #advanced

Возможности комментариев:

• Обсуждение ответа с командой прямо в контексте диалога
• Использование #хештегов для категоризации
• @упоминания коллег для привлечения внимания
• Пин комментариев с важной дополнительной информацией или задачами

Статусы топиков¶

Каждый топик с диалогом имеет один из трех статусов, который отображается цветным квадратиком в названии топика.

Быстрая справка /help¶

В любой момент получите краткую справку по доступным командам и статусам, отправив команду /help в любом топике рабочей группы.

Информация о топике /info¶

Получите базовую информацию о текущем топике командой /info.

Блокировка /ban и /unban¶

Блокируйте пользователей без чувства такта командой /ban и разблокируйте при необходимости через команду /unban.

Принцип работы команд отличается взависимости от типа подключения и типа диалога. В приватных диалогах команда работает непосредственно по пользователя, с которым ведется диалог. В топиках, куда ведется трансляция из групповых чатов, команде необходимо передать в качестве параметра идентификатор пользователя, которого надо исключить из чата, например /ban USERNAME.

Игнорирование /ignore и /unignore¶

Игнорируйте входящие сообщения из указанных диалогов любых типов командой /ignore, и возвращайте их обратно командой /unignore.

Команда /ignore отличается от /ban:

• /ban для аккаунтов не добавляет chat_id в IGNORE_CHATS, блокирует пользователя на стороне Telegram.
• /ignore всегда добавляет чат в IGNORE_CHATS, после чего сообщения из диалога перестают приходить в бекенд-группу, но отправитель на стороне Telegram не блокируется.

Скрытие диалога /hide¶

Удаляйте backend-диалоговый топик из бекенд-группы, сохраняя сообщения на фронтенде, командой /hide.

Обычное удаление топика в бекенд-группе удаляет все сообщения на фронтенде в соответствующем диалоге, команда /hide позволяет удалить топик на бекенде не трогая сообщения на подключенном боте или аккаунте.

Команда удобна для чистки бекенд-группы от лишних или не актуальных топиков, когда не обязательно блокировать сообщения от соответствующего пользователя или группового чата. Если кроме удаления топика необходимо прекратить получать сообщения из соответствующего диалога, то перед вызовом команды можно выполнить в топике команду /ignore.

Что происходит при выполнении:

• Топик с диалогом удаляется только из бекенд-группы.
• Все сообщения в соответствующем frontend-чате сохраняются.
• В случае если в диалог опять придет сообщение (и диалог не был заблокирован командой /ignore или /ban), топик заново создается и активируется, пользователю или в чат высылается привествие (если оно активировано на подключении).
• В топик General отправляется отчёт о скрытии топика.

Создание топиков /new¶

Создавайте новые диалоги c пользоватлеями или вступайте в чаты командой /new.

Возможности команды отличаются взависимости от типа подключения.

/new USERNAME | *USER_ID | #PHONE

/new USERNAME | *USER_ID | #PHONE
/new BOT_USERNAME | *BOT_USER_ID 

//start
//help

/new PUBLIC_CHAT_LINK
/new PUBLIC_CHANNEL_LINK
/new https://t.me/PUBLIC_CHAT_LINK
/new https://t.me/PUBLIC_CHANNEL_LINK
/new https://t.me/+PRIVATE_INVITE_HASH

/new USERNAME i{INSTANCE_ID}

Массовое создание топиков для диалогов¶

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

Команды в топике General:

• /new или /new help — показать справку по режимам.
• /new file — создать диалоги из прикреплённого файла (одно значение на строку, никаких лишних строк).
• /new list VALUE1,VALUE2,... — создать диалоги из списка в сообщении через запятую.

Поддерживаемые значения в файле или списке:

• *USER_ID — ID пользователя Telegram
• *-CHAT_ID — ID группы или канала (со знаком минус)
• #PHONE — номер телефона
• USERNAME — имя пользователя (без @)
• t.me/... или invite-ссылка

Как это работает:

• Между созданиями диалогов задержка 5 секунд.
• Все созданные диалоги получают статус closed.
• По итогам работы команды в топик General отправляется CSV-отчёт с результатом по каждому получателю.
• Одновременно в одной бекенд-группе может выполняться только один bulk /new.
• Максимум можно создать 1000 диалогов за одну команду.

Дополнительные модули¶

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

Кастомные команды¶

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

• Интеграция с внешними системами (CRM, ERP, таск-трекеры)
• Автоматизация специфичных бизнес-процессов
• Создание собственных команд под ваши задачи
• Подключение внешних сервисов через вебхуки

Подробнее о внешних интеграциях