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

Отправка сообщения в Telegram

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

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

Сохраните настройки для прикрепления файла к сообщению.

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

Синтаксис в старых блоках процесса будет работать до тех пор, пока не будут изменены сами блоки.

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

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

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

Callback-операция (интерактивный опрос)

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

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

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

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

В блоке «Отправить telegram сообщение» доступны аналогичные возможности:

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

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

Настройка вариантов ответа для пользователей

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

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

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

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

В качестве варианта ответа можно использовать звёздочку (*). Она полностью изменяет обработку ответа пользователя, если он введет любое сообщение, которое не совпадает ни с одним из предложенных вариантов:

1. Если вам важны исключительно указанные в блоке варианты и другие ответы не требуется анализировать, используйте звездочку (*). Произвольный ответ пользователя не отразится в истории выполнения задачи, а само сообщение не появится в разделе «Входящие».
2. Если вы планируете анализировать произвольные ответы, не используйте вариант со звездочкой (*). Ответ поступит в раздел «Входящие» аккаунта, а задача продолжит исполнение по ветке «Ошибка».

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

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

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

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

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

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

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

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

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

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

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

Callback-операция «Отправить telegram-сообщение для сбора данных»

С помощью данной операции вы можете запросить электронный адрес у пользователей через Telegram-бот и добавить его в их карточку на GetCourse. Это актуально для случаев, когда у пользователя указан технический email (то есть фактического адреса нет). Найти таких пользователей можно с помощью условия «Технический эл.адрес».

В будущем появится возможность запрашивать иные данные, например, имя или дату рождения — это сделает взаимодействие с пользователями еще более удобным! Следите за обновлениями в нашем телеграм-канале «GetCourse Update» → подписаться.

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

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

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

В блоке вы можете:

1. Выбрать бота, от имени которого отправится сообщение.
2. Добавить текст сообщения с переменными.
3. Выберите тип запрашиваемых данных — в настоящее время доступна лишь опция «email».
4. Включить дополнительные опции для сообщений со ссылками.
5. Активируйте опцию «Пользователь может пропустить этот вопрос», после чего в диалоге с ботом появится кнопка «Пропустить».

Как работает операция «Отправить telegram сообщение для сбора данных»

С помощью операции можно отправить сообщение пользователю с технической почтой с просьбой написать email в ответ. Далее возможны следующие варианты:

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

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

При вводе неверного кода бот предупредит об ошибке. После введения правильного кода пользователь получит сообщение «Данные приняты».

В дальнейшем email в карточке пользователя будет заменён с технического на реальный.

• Если в блоке установлен чекбокс «Пользователь может пропустить этот вопрос», то пользователь может нажать кнопку в сообщении и пропустить ответ на вопрос.

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

Возможные ответы (выходы из блока)

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

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

Запуск процесса при подключении пользователя к Telegram-боту

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

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

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

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

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

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

Запуск процесса при получении сообщения от пользователя

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

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

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

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

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

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

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

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

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

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

Запуск процесса при нажатии на кнопку постоянной клавиатуры

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

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

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

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

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

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

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

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

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