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

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

Содержание:

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

С помощью операции «Отправить telegram сообщение» вы можете добавить в схему вашего процесса отправку сообщения пользователю в Телеграм.

Добавить операцию в процесс могут:

• владелец аккаунта,
• администратор.

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

Если к профилю пользователя привязано несколько Telegram-ботов, сообщение отправится от основного бота. Если основной не привязан, то от подключенного последним бота.

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

В тексте сообщения можно использовать переменные в зависимости от объекта процесса. Подробнее об этом читайте в статье → «Как правильно использовать переменные в процессе».

В операции «Отправить telegram сообщение» можно использовать дополнительные опции для отправки сообщения, в котором есть ссылки. Опции работают независимо друг от друга.

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

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

К телеграм-сообщению можно прикрепить следующие типы файлов:

• изображения (формат jpg, png, размером не более 10 мб);
• видео (формат mp4, размером не более 50 мб);
• видеокружок (круглое или квадратное видео до 640×640 пикселей, в формате mp4, не длиннее 1 минуты);
• аудио (формат mp3, m4a, размером не более 50 мб);
• голосовое (формат ogg с кодировкой OPUS, размером не более 50 мб);
• документ (любые файлы размером не более 50 мб).

Изображения будут объединены в альбомы по 10 элементов. Если длина текста сообщения менее 1024 символов, то текст будет отправлен как подпись к альбому. Длинный текст отправляется отдельным сообщением.

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

Чтобы файл прикрепился к сообщению, сохраните настройки.

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

Обратите внимание: ранее для прикрепления файлов к telegram-сообщению также можно было использовать синтаксис. С 28.11.2023 в новых блоках процесса он работать не будет. Прикрепить файл в таких блоках можно только через рассмотренные ранее кнопки.

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

После настройки операции «Отправить telegram сообщение» вы увидите в блоке два выхода:

• «Доставлено» — для ситуаций, когда отправка удалась;
• «Ошибка» — для ситуаций, когда отправка не удалась.

Это позволит по-разному среагировать в процессе в зависимости от успешности отправки. Например, в случае ошибки можно направить сообщение на email.

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

Подробнее читайте в статье → «Как протестировать процесс».

Callback-операция позволяет отправить пользователю сообщение и ожидать ответа на него.

Чтобы добавить в схему процесса блок с возможностью выбора ответа, используйте callback-операцию «Отправить telegram сообщение и ожидать ответа».

Добавить блок могут:

• владелец аккаунта;
• администратор.

Как и в блоке «Отправить telegram сообщение» вы можете:

1. Выбрать бота, от имени которого отправится сообщение.
2. Добавить текст с переменными.
3. Включить дополнительные опции для сообщений со ссылками.
4. Прикрепить файлы.

Описание этих возможностей рассмотрели в разделе выше 🠕

Чтобы пользователь мог выбрать вариант ответа в сообщении, добавьте их ниже.

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

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

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

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

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

Обратите внимание: для корректной работы процесса не следует запускать одновременно более одной callback-операции для пользователя в рамках одного бота.

Это правило действует для callback-операциий, которые одновременно запущены в рамках:

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

Если для одного пользователя одновременно запущено несколько callback-операций, ответ получит только та, которая запущена последней.

Ниже рассмотрим пример процесса, который допускает одновременный запуск двух callback-операций.

В нашем примере блок № 1 «Отправить telegram сообщение и ожидать ответа» сможет получить и обработать ответ пользователя только в первые 5 минут после отправки.

Через 5 минут запустится блок № 2 «Отправить telegram сообщение и ожидать ответа» и ответ пользователя придет только в него.

Блок № 1 в данном случае сможет продолжить выполнение только по выходу «Таймаут», если он используется.

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

В полученном сообщении в 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 предоставляет массу возможностей для вашего бизнес-процесса: опросы, рассылки и уведомления и даже управление закрытой группой. Обо всех возможностях читайте в основной статье.