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

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

Содержание:

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

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

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

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

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

Обратите внимание: если в списке «Выберите бота» оставить «Любой бот», то сообщение отправится по всем пользователям, подключившим хотя бы одного Telegram-бота.

Если к профилю пользователя привязано несколько Telegram-ботов, сообщение отправится:

• в основного бота;
• если основной не привязан, то в подключенного последним бота.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

В настройках блока укажите:

1. Telegram-бота, через которого отправится сообщение. О том, как отправляются сообщения в «Любой бот», читайте в предыдущем разделе.
2. Текст сообщения.
3. Изображение и видео (по желанию).
4. Варианты ответов для пользователя.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

По умолчанию запуск процесса срабатывает только при первом подключении бота. Чтобы процесс запускался повторно, дополнительно включите опцию «Процесс запускается при повторном подключении бота».

Данная опция позволяет запустить процесс, когда пользователь подключает Telegram-аккаунт, который ранее был отключен от профиля.

Обратите внимание:

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

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

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

1. В разделе «Сообщения» — «Telegram» кликните по боту.

2. Перейдите в настройки запуска процессов по команде из Telegram.

3. Укажите команду, по которой будет запускаться процесс.
4. Выберите из списка процесс по пользователям и сохраните изменения.

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

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

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

Если в одном сообщении сразу несколько команд, то обрабатывается только одна команда в следующем приоритете:

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

Обратите внимание: если ученик отправит в Telegram-бота сообщение со следующей командой, то новая задача в процессе создана не будет, если предыдущая задача активна (в том числе тестовая).

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

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

2. В настройках бота:

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

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

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

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

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

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