Статья была полезной?
На GetCourse вы можете использовать интерактивные возможности Telegram-бота, чтобы собирать с пользователей обратную связь и учитывать ее в бизнес-процессах.
Содержание:
Отправка сообщения в Телеграм
При создании процесса можно выбрать операцию «Отправить 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-операция (интерактивный опрос)
Для организации интерактива в процессах используйте блок «Callback-операция».
Блок позволяет отправить пользователю сообщение и ожидать ответа на него.

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

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

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

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

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

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

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

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

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

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

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

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


Для запуска процесса по команде:
- В разделе «Сообщения» — «Telegram» кликните по боту.

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

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

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

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

Если в одном сообщении сразу несколько команд, то обрабатывается только одна команда в следующем приоритете:
- Искомый текст в начале (например, «Привет/*»);
- Искомый текст в конце (например, «*/вебинар»);
- Искомый текст в любом месте (например, «*/купить/*»).

Обратите внимание: если ученик отправит в Telegram-бота сообщение со следующей командой, то новая задача в процессе создана не будет, если предыдущая задача активна (в том числе тестовая).
Запуск процесса при нажатии на кнопку постоянной клавиатуры
Чтобы процесс запускался для пользователя при нажатии на кнопку в письме, к рассылке можно добавить постоянную клавиатуру. Для этого:
1. Создайте процессы по пользователям, которые будут запускаться при нажатии на кнопки в чате. В качестве примера будем добавлять пользователя в группу и отправлять ответное сообщение в Телеграм.

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

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

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

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

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

Интеграция GetCourse с Telegram предоставляет массу возможностей для вашего бизнес-процесса: опросы, рассылки и уведомления и даже управление закрытой группой. Обо всех возможностях читайте в основной статье.
авторизуйтесь
У меня стоит галочка "запустить процесс при запуске бота"
В первый раз процесс запускался, затем я удалил бота, перезапустил, но процесс уже не запускается. Как сделать так, чтобы он повторно запускался?
Ответили вам в рамках тех. поддержки.
Показать еще комментарии (1)
Напишите, пожалуйста, в техподдержку https://getcourse.ru/contacts с описанием вашей задачи, которую вы хотите решить с помощью команд в меню бота.
Ответили вам в рамках тех. поддержки.
Спасибо за обратную связь, внесли корректировки в статью.
Напишите, пожалуйста, в техподдержку https://getcourse.ru/contacts со ссылкой на ваш процесс и поясняющим скриншотом сообщения, для того чтобы мы могли дать рекомендации по настройкам.
Однако пользователь на этой же странице сможет подключить telegram-бот к своему профилю обратно.
Правильно ли я понимаю, что в вашем аккаунте настроен администрирующий Telegram-группу бот по инструкции в статье: https://getcourse.ru/blog/276126? В этом случае, если настройки произведены корректно, вы можете исключить пользователя из группы аккаунта GetCourse, по которой предоставляется доступ в telegram-группу.
Если у вас возникнут дополнительные вопросы или сложности по данной ситуации, опишите её, пожалуйста, подробно нам в техническую поддержку: https://getcourse.ru/contacts
Если так, то в настоящее время реализовать задачу нет возможности.
Если задача заключается в чем то другом и я неверно понял ситуацию, то опишите, пожалуйста, подробнее нам в технической поддержке https://getcourse.ru/contacts
В зависимости от специфики задачи вы может использовать разные блоки: https://getcourse.ru/blog/275872
1) задержка на 2 дня + проверка условия https://skr.sh/sCIARmqgoQB
2) ожидание условия в течение двух дней https://skr.sh/sCIsxClErHy
Если ученик так и не ответил на задание, то выполнить отправку напоминания.
Вы можете, например, создать процесс с периодической проверкой и в "Правило вхождения объекта" указать условия "В группе", "Подключен Telegram" https://skr.sh/sBIn2ofHNoL . Такой процесс будет запускаться только по пользователям, которые подключились к Telegram-боту и были добавлены в указанную группу. Добавлять пользователей в группу вы можете вручную или автоматически при регистрации в виджете https://getcourse.ru/blog/275960 .
А как сделать так чтобы бот задавал вопросы по имени, почте, номер телефона и подтягивал в геткурс?
Ответы из блоков "Callback-операция" выгрузить возможности нет. После выполнения Callback-операции вы можете добавлять пользователей в различные группы, в зависимости от ответа. Далее участников той или иной группы можно экспортировать из системы: https://getcourse.ru/blog/276069
А откуда взять ссылку на тг бота, чтоб вставить в страницу благодарности и если с одного бота идут 3 разные воронки
Короткая ссылка для подключения интегрированного в вашем аккаунте бота Telegram имеет вид https://домен.ru/tlgrm — указывается домен, по адресу которого открывается ваш аккаунт.
Подробнее о ссылке для подключения Telegram вы можете прочитать в статье: https://getcourse.ru/blog/302907.
У меня создан процесс с большим количеством колбэк операций.
С пользователями общаться будем через телеграм, соответственно.
При тестировании возник вопрос: После ответа пользователя процесс идет дальше по заданному маршруту, однако СТАРЫЕ кнопки остаются. Как их убрать? Команда [keyboard remove] завершает процесс, после нее маршрут заканчивается. Как быть? Или что я не так делаю?
В настоящий момент данная функция недоступна и убрана из интерфейса.
Менеджер может работать с задачами по процессу непосредственно из аккаунта. Организовать работу из Telegram возможности нет.
Для пользователей можно настроить процесс с отправкой сообщения в Telegram и выполнением различных действий в зависимости от выбранного пользователем варианта ответа. Подробнее в статье: https://getcourse.ru/blog/275852
Напишите, пожалуйста, в нашу техподдержку https://getcourse.ru/contacts с более подробным описанием вопроса.
Скажите пожалуйста, почему у меня больше не автоазапускается процесс с ботом телеграма?
Какие настройки нужно исправить?
Пожалуйста, напишите обращение в техподдержку https://getcourse.ru/contacts и дайте ссылку на процесс, а также на пользователя, по которому процесс должен был запуститься, но не запустился.