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

Через процессы на платформе GetCourse можно воспользоваться интерактивными функциями Telegram-бота для сбора обратной связи от пользователей и учета ее в рабочем процессе.

Основные пункты:

1. Отправка сообщения в Телеграм: Отправка персонализированных сообщений пользователям через Telegram-бот, обеспечивая эффективное взаимодействие.

2. Callback-операция (интерактивный опрос): Использование callback-операций для создания интерактивных опросов, что позволяет собирать обратную связь и взаимодействовать в режиме реального времени.

3. Запуск процесса при подключении пользователя к Телеграм-боту: Автоматический запуск процесса при подключении нового пользователя к вашему Telegram-боту, обеспечивая персонализированный и адаптированный опыт.

4. Запуск процесса при получении сообщения от пользователя: Интеграция возможности автоматического запуска процесса при получении сообщения от пользователя в Telegram.

5. Запуск процесса при нажатии на кнопку постоянной клавиатуры: Автоматический запуск процесса при нажатии пользователями на кнопки постоянной клавиатуры, обеспечивая удобство в использовании.

Эти функции позволяют максимально эффективно взаимодействовать с вашей аудиторией в Telegram, создавая интерактивные и персонализированные сценарии общения.

Через операцию "Отправить сообщение в Telegram" вы можете интегрировать отправку сообщений пользователям в Телеграм в рамках вашего процесса.

Данную операцию могут добавлять:

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

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

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

В случае отсутствия основного бота, сообщение будет отправлено от последнего подключенного бота.

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

В операции "Отправить сообщение в Telegram" вы можете использовать дополнительные опции для отправки сообщений с ссылками. Эти опции действуют независимо друг от друга.

1. Опция "Оборачивать ссылки для авторизации": При включении данной опции, ссылки в сообщении будут предоставлять авторизацию пользователя при переходе. Это означает, что ученик, переходя по ссылке, автоматически входит в свой личный кабинет, без необходимости ввода пароля. Важно отметить, что из соображений безопасности эта опция не авторизует сотрудников и администраторов аккаунта.

2. Опция "Скрывать превью ссылок": Включение этой опции позволяет исключить отображение параметров страницы в сообщениях, отправленных с использованием транспорта "Telegram". Это полезно, если вы хотите избежать отображения превью ссылок в социальных сетях и поисковых системах.

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

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

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

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

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

Для того чтобы файл был прикреплен к сообщению, сохраните изменения в настройках.

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

Обратите внимание: с 28.11.2023 года в новых блоках процесса синтаксис для прикрепления файлов к Telegram-сообщению больше не будет поддерживаться. 

Теперь файлы можно прикреплять только через рассмотренные ранее кнопки.

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

После настройки операции "Отправить Telegram сообщение" в блоке появятся два выхода:

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

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

Примечание

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

Это ускорит отправку Telegram-сообщений с файлами и предоставит возможность предварительной проверки на наличие ошибок.

Для внесения в схему процесса блока с возможностью выбора ответа рекомендуется использовать callback-операцию "Отправить Telegram сообщение и ожидать ответа".

Этот блок может быть добавлен:

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

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

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

1. Ошибка — это отрицательный выход. Если пользователь отправит некорректное сообщение в ответ, процесс может, например, уведомить ответственного сотрудника и завершиться.

2. Отмена — это нейтральный выход. Если во время ожидания ответа сработают другие блоки callback-операций, настроенные в процессе, процесс будет ожидать ответа только по последней callback-операции.

3. Таймаут — также нейтральный выход. Если пользователь не реагирует на сообщение, полученное по callback-операции, в течение установленного времени таймаута, процесс перейдет по этому выходу.

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

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

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

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

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

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

Приведем пример процесса, который позволяет одновременно активировать две callback-операции. 

В данном примере блок № 1 "Отправить telegram сообщение и ожидать ответа" может получать и обрабатывать ответы от пользователя только в течение первых 5 минут после отправки. После 5 минут активизируется блок № 2 "Отправить telegram сообщение и ожидать ответа", и ответ пользователя будет принят только им. Если используется выход "Таймаут" в блоке № 1, он сможет продолжить выполнение только через этот выход.

Если возникнут дополнительные вопросы или если вам нужно еще что-то рассказать, не стесняйтесь сообщить!

Для проверки и отладки функционирования процесса, вы можете воспользоваться тестовым пользователем в режиме отладки:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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