Как подключить мессенджер Max к аккаунту на GetCourse

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

В этой статье рассмотрим подключение Max-бота к аккаунту для отправки сообщений. Про администрирование группы/канала Max читайте в отдельной статье «Как настроить автоматический контроль доступа к группе или каналу Max».

1. Зарегистрируйтесь в Max для партнеров и верифицируйте профиль организации. Верификация доступна для Юр.лиц и ИП, которые являются резидентами РФ.
2. Нажмите на кнопку «Перейти» в блоке «Чат-боты» на главной странице.

3. Нажмите «Добавить бота».

4. Заполните данные бота:
   • Логотип — используется в качестве аватара бота. Рекомендуемый размер 500×500 пикселей, не более 5 мб.
   • Название бота, которое будет отображаться пользователям.
   • Ник — генерируется автоматически на основе вашего ИНН.
   • Телефон компании — номер телефона, который вы используете для авторизации в профиле Max.
   • Сайт — ссылка на сайт вашей организации, например, на аккаунт школы.
   • Описание — дополнительная информация до 200 символов. Например, задачи бота, основные функции, особенности использования и т.д.
5. Нажмите «Создать».

После создания бот отправится на модерацию. Если его одобрят, в личном кабинете станет доступен API Token, который нужно будет скопировать и добавить в настройки GetCourse. Об этом читайте ниже.

Подключить бота к аккаунту могут:

• владелец аккаунта,
• сотрудник или администратор с правом «Может настраивать мессенджеры».

Для этого:

1. Скопируйте токен Max-бота в блоке «Интеграция».

2. Перейдите на GetCourse в раздел «Сообщения» — «Max» и нажмите «Добавить бота» в блоке «Боты для сообщений в Max».

3. Вставьте токен и нажмите «Добавить».

4. При необходимости назначьте бот основным. В этом случае:
   • пользователи смогут подключаться к нему напрямую из профиля;
   • при отправке писем c настройкой «Любой бот» сообщение будет уходить в основной.

Готово! Max привязан к аккаунту. Теперь пользователи могут подключиться к вашему боту в своём профиле, а вы сможете отправлять им сообщения в Max.

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

Для этого:

1. Нажмите на бота в общем списке.

2. Раскройте настройки приветственных сообщений, которые описаны ниже.
3. Измените необходимые тексты и сохраните настройки.

Рассмотрим, когда приходит то или иное сообщение:

• «Сообщение после запуска бота для неизвестных пользователей» — такое сообщение придет при подключении тем, кто попал в бота неавторизованным. Например, новый пользователь, который подключился к боту по прямой ссылке.

По умолчанию в тексте сообщения есть переменная {max_auth_link}, обернутая тегами в ссылку. С её помощью пользователь сможет перейти на страницу входа и авторизоваться/зарегистрироваться.

После регистрации или авторизации откроется окно подключения к Max. Если пользователь подтвердит подключение, то Max будет привязан к его профилю, а бот отправит ему сообщение после успешного сопоставления Max-пользователя.

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

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

Пользователи могут подключиться к Max-боту 2 способами:

1. По кнопке в профиле
2. По короткой ссылке

2. Скопируйте короткую ссылку, нажав на. Она имеет следующий вид https://основной_домен_аккаунта/pl/maxstart?botId=xxx.

Далее полученную ссылку можно отправить ученикам, например, в рассылке.

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

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

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

Аналогично отправить сообщение можно через карточку пользователя по кнопке «В чат» (для старого дизайна «Общение с пользователем»).

• Отправка сообщения в Max через процесс
• Отправка сообщения с ожиданием ответа
• Запуск процесса при подключении пользователя к Max-боту
• Запуск процесса при получении сообщения от пользователя

Если вы хотите отправлять письма в Max через процесс, используйте операцию «Отправить сообщение в Max».

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

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

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

2. Опция «Скрывать превью ссылок» позволяет отключить в сообщениях с транспортом «Max» параметры страницы (title, description, image), которые отображаются в соц.сетях и в поисковых системах.

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

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

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

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

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

С помощью callback-операции «Отправить Max-сообщение и ожидать ответа» вы можете организовать интерактивный диалог с пользователем.

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

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

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

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

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

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

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

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

Также в качестве варианта ответа можно добавить звёздочку (*) и настроить для неё отдельную ветку процесса. Она сработает, если пользователь напишет что-то, чего нет в списке ваших вариантов ответа.

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

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

1. Перейдите к настройкам бота.
2. Включите опцию «Запускать процесс при подключении бота».
3. Выберите процесс по пользователям из списка.
4. Сохраните настройки.

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

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

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

1. Перейдите к Max-боту в GetCourse и раскройте настройки блока «Запуск процессов по команде из Max».

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

Когда клиент отправит в бот сообщения с командами вида */текст, текст/* или */текст/* они дополнительно отобразятся в разделе «Входящие» и в переписке с пользователем по кнопке «В чат» (в старом дизайне «Общение с пользователем»).

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

1. Команда, указанная в начале начале (например, привет/*);
2. Команда, указанная в конце (например, */вебинар);
3. Команда, указанная в любом месте сообщения (например, */купить/*).

Если какой-либо бот для вас уже неактуален, вы всегда можете удалить его из аккаунта.

Удалить подключенный к аккаунту бот можно 2 способами:

1. В общих настройках Max, нажав на иконку .

2. В настройках бота, нажав на кнопку «Удалить бота».