Интерактивные возможности Telegram

На GetCourse вы можете использовать интерактивные возможности Telegram-бота, чтобы собирать с пользователей обратную связь и учитывать её в бизнес-процессах.

Содержание:

• Отправка сообщения в Телеграм
• Callback-операция (интерактивный опрос)
• Запуск процесса при подключении пользователя к Телеграм-боту
• Запуск процесса при получении сообщения от пользователя
• Запуск процесса при нажатии на кнопку постоянной клавиатуры

При создании процесса можно выбрать операцию «Отправить telegram сообщение».

В блоке можно:

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

Обратите внимание: дополнительно указывать ссылку на изображение/видео в тексте сообщения не нужно.

Ограничения:

• Для изображений: формат — .jpg, .png, размер — не более 5 Мб.
• Для видео: формат — .mp4, размер — не более 20 Мб.

Изображения и видео будут объединены в альбомы по 10 элементов.

Если длина текста менее 200 символов, то текст будет отправлен как подпись к альбому.

Более длинный текст отправляется отдельным сообщением.

Для удаления приложенных файлов выставите отметку «Удалить», а затем сохраните изменения в блоке.

Изображения и видео в сообщения также можно добавить с помощью html-кода:

[image url="https://ссылка_на_файл" text="подпись к картинке"]
и
[video url="https://ссылка_на_видеофайл.mp4"]

Изображения, которые вставлены в сообщение с помощью кода и имеют подпись к картинке в атрибуте text="", отправляются отдельным сообщением. Видео — добавляются к альбому.

Операция отправки сообщения имеет два выхода: «Отправлено», когда отправка удалась, и «Ошибка», когда отправка не удалась. Это позволяет по-разному среагировать в процессе в зависимости от успешности отправки.

В операции «Отправить telegram сообщение» можно выбрать две опции для настройки сообщения:

1. Опция «Оборачивать ссылки для авторизации» включает авторизацию пользователя при переходе по ссылке в сообщении. Таким образом, при переходе по ссылке ученик автоматически попадёт в свой личный кабинет и ему не нужно будет вводить пароль для входа.

Обратите внимание: из соображений безопасности такая ссылка не авторизует сотрудников и администраторов аккаунта.

2. Опция «Скрывать превью ссылок» позволяет отключить в сообщениях с транспортом «Telegram» параметры страницы, которые отображаются в соц.сетях и в поисковых системах. Ниже привели примеры, когда данная опция включена и отключена.

Эти две опции работают независимо друг от друга.

Для организации интерактива в процессах используйте блок «Callback-операция».
Блок позволяет отправить пользователю сообщение и ожидать ответа на него.

В настройках блока укажите текст сообщения (1) и добавьте варианты ответов для пользователя (2). Также можно прикрепить изображение и видео (3).

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

По умолчанию в блоке есть предсозданные варианты ответа с отдельными выходами:

• Ошибка — отрицательный выход. Переход по этой ветке произойдёт, если пользователь отправит в ответ некорректное сообщение. В этом случае можно, например, уведомить ответственного сотрудника и завершить процесс.
• Отмена — нейтральный выход. Переход по этой ветке произойдёт, если во время ожидания ответа сработают другие блоки callback-операций, настроенные в процессе. В этом случае процесс будет ожидать ответа только по последней callback-операции.
• Таймаут — нейтральный выход. Переход по этой ветке произойдёт по истечению указанного времени таймаута, если пользователь не среагирует на полученное по callback-операции сообщение.

В качестве варианта ответа можно добавить звёздочку (*).

В сообщении пользователь её не увидит, но процесс пойдёт по ветке этого варианта, если пользователь отправит некорректный ответ, стикер, файл, аудиосообщение и т. д.

Отличие от выхода «Ошибка» состоит в том, что в этом случае вы сможете продолжить процесс по нейтральной или положительной ветке и далее предложить пользователю другие варианты взаимодействия.

Проверить и отладить работу процесса вы сможете на тестовом пользователе в режиме тестирования:

В полученном сообщении в Telegram пользователь увидит настроенный вопрос и варианты ответа в виде кнопок.

Выбрать вариант ответа он сможет как по нажатию на кнопку, так и отправив в ответ текст, указанный на ней.

В операции «Отправить telegram сообщение и ожидать ответа» можно выбрать две опции для настройки сообщения:

1. Опция «Оборачивать ссылки для авторизации» включает авторизацию пользователя при переходе по ссылке в сообщении. Таким образом, при переходе по ссылке ученик автоматически попадёт в свой личный кабинет и ему не нужно будет вводить пароль для входа.

Обратите внимание: из соображений безопасности такая ссылка не авторизует сотрудников и администраторов аккаунта.

2. Опция «Скрывать превью ссылок» позволяет отключить в сообщениях с транспортом «Telegram» параметр страницы, которые отображаются в соц.сетях и в поисковых системах. Ниже привели примеры, когда данная опция включена и отключена.

Эти две опции работают независимо друг от друга.

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

Важно: процесс должен быть создан по объекту «Пользователи».

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

Для запуска процесса по команде:

1. Откройте раздел «Сообщения — Настройки» вкладку «Уведомления — Настройки Telegram».
2. Выберите из списка процесс по пользователям.
3. Укажите команду, по которой будет запускаться процесс.
4. Сохраните изменения.

При этом предусмотрена возможность использования дополнительного синтаксиса:

1. «текст» — процесс запустится, если сообщение содержит только искомый текст.
2. «текст/*» — процесс запустится, если сообщение начинается с искомого текста.
3. «*/текст» — процесс запустится, если сообщение заканчивается на искомый текст.
4. «*/текст/*» — процесс запустится, если в сообщении искомый текст содержится в любом месте.

Когда клиент отправит вам сообщений с командой (2-4), они дополнительно отобразятся в разделе «Входящие» и в «Общении с пользователем». Команда, по которой произошла обработка, выделится жирным шрифтом.

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

1. Искомый текст в начале (например, «Привет/*»);
2. Искомый текст в конце (например, «*/вебинар»);
3. Искомый текст в любом месте (например, «*/купить/*»).

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

1. Создайте процессы по пользователям, которые будут запускаться при нажатии на кнопки в чате. В качестве примера будем добавлять пользователя в группу и отправлять ответное сообщение в Телеграм.

2. В настройках телеграм:

• добавьте команды, которые отобразятся на кнопках в чате;
• укажите процессы, которые будут запущены по каждой из команд;
• сохраните настройки.

3. Создайте рассылку с транспортом «Telegram» и откройте настройки кнопочного меню по иконке клавиатуры.

4. Добавьте кнопку для каждой из команд и нажмите «Применить».

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

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

Интеграция GetCourse с Telegram предоставляет массу возможностей для вашего бизнес-процесса: опросы, рассылки и уведомления и даже управление закрытой группой. Обо всех возможностях читайте в основной статье.