MAX: Дополнительно
- MAX ID — уникальная переменная клиента в VK CXhub, которая является значением User_id в мессенджере МАХ. При отправке сообщения по MAX ID (User_id) сообщение приходит в персональный диалог клиента с ботом.
- Chat_id — это идентификатор чата в МАХ. В Chat_id может быть значение как группового чата с множеством участников, так и персонального диалога с клиентом (после того, как клиент первый раз напишет в бот МАХ, для клиента создается идентификатор персонального чата с ботом).
Таким образом, в персональный диалог с клиентом сообщение может отправляться как по User_id (переменная MAX ID в VK CXhub), так и по Chat_id.
При отправке сообщения по Chat_id оно отправляется в чат: если указан идентификатор группового чата, сообщение придет в групповой чат, а если указан идентификатор диалога с клиентом, сообщение придет в личный диалог с клиентом аналогично отправке по User_id.
Использование Chat_id в шагах сценария VK CXhub делает их универсальными для групповых чатов и диалогов.
Мы подготовили для вас шаблоны сценариев для мессенджера МАХ с наиболее популярными кейсами, в которых для вашего удобства полностью настроены логика и шаги. Вам остается только подключить необходимые интеграции, изменить тексты бота и запустить сценарий.
- В шаблонах готовых решений мы использовали все доступные в VK CXhub действия для чат-ботов МАХ, чтобы вы могли использовать готовые решения также в качестве примера при создании сценария чат-бота МАХ с нуля.
- Внутри каждого шага вы найдете примеры текстов, которые отправляет бот, а также указание того, какой шаг (действие) используется для данного шага.
- В окне редактирования каждого шага после его добавления в сценарий вы найдете подсказки по количеству символов для полей с текстом и названиями кнопок, а также подсказки о том, как получить Chat_id.
| Название шаблона | Описание шаблона |
| Серия сообщений в чат МАХ по расписанию | Отправка сообщений в групповой чат. Сценарий запускается в заданное время для указанного сегмента клиентов. Бот с заданной периодичностью отправляет сообщения с новыми уроками в чат, а также отправляет и закрепляет в группе сообщение со связанным чатом для обсуждения уроков и домашних заданий. По завершении курса закрепленное сообщение открепляется. Интеграции: МАХ |
| Модерация нарушений в группе МАХ | Сценарий для группового чата. При отправке в чат сообщений, которые соответствуют списку установленных запрещенных слов (запуск сценария по ключевым словам), бот удаляет сообщение и уведомляет нарушителя о том, что при повторном нарушении он будет удален из чата. При повторном нарушении бот удаляет нарушителя из чата. После обоих нарушений бот отправляет уведомление маркетологу. Интеграции: МАХ |
Для текстовых сообщений бота, которые отправляются через исходящие запросы, такие как:
- Отправка сообщения в чат (без кнопок)
- Сообщение в чат с кнопками (1 кнопка)
- Сообщение в чат с кнопками (2 кнопки)
- Сообщение в чат с кнопками (3 кнопки)
доступно форматирование.
Для них поддерживается следующий синтаксис Markdown:
- *курсив* и _это курсив_
- **жирный** и __такой же жирненький__
- ~~зачеркнутый~~
- ++подчеркнутый++
- `code` для встроенного monospaced текста (концы строк внутри этого блока рассматриваются как пробелы)
- ```code``` для monospaced текстового блока
- ^^что-то очень важное^^ для выделенного текста
- [название для ссылки](https://max.ru/) для встроенных URL-адресов
- # заголовок первого уровня
Если вам необходимо отправить более 3 кнопок в сообщении бота при использовании запроса «Сообщение в чат с кнопками», вам необходимо создать новый исходящий запрос, аналогичный запросам «Сообщение в чат с кнопками».
ℹ️ При внесении изменений в существующие запросы они перестанут работать.
1. Перейдите в разде «Интеграции».
2. Найдите вашу интеграцию МАХ и нажмите на нее. Откроется ваша подключенная интеграция:
3. В левой части экрана нажмите «Исходящие запросы» и нажмите кнопку «Создать новый запрос»
4. В новом окне перейдите еще раз на вкладку «Исходящие запросы» и найдите запрос «Сообщение в чат с кнопками (3 кнопки)», откройте его. Данный запрос будет использоваться в качестве примера.
5. На странице нового запроса заполните информацию:
- Название запроса: любое название, удобное вам
- Тип интеграции: МАХ
- Безопасное кодирование параметров: Отключить
- Метод: POST
- URL: https://platform-api.max.ru/messages?&chat_id=#chat_id#
- Headers:
- Content-Type / application/json
- Authorization / #access_token#
- Body:
тип Raw, тело запроса — тело запроса аналогично запросу, который мы рассматриваем в качестве примера, но в него необходимо добавить дополнительные строки для новых кнопок. В примере ниже жирным шрифтом выделен фрагмент, который добавляется для одной дополнительной кнопки. Фрагмент добавляется столько раз, сколько вам необходимо дополнительных кнопок. Менять в названиях переменных необходимо только цифры, соответствующие номеру кнопки. Для проверки корректности сформированного кода воспользуйтесь сервисом https://jsonlint.com/.
6. Нажмите кнопку «Сгенерировать настройки параметров» и заполните все поля аналогично запросу, который рассматриваем в качестве примера, включая те, которые открываются в модальном окне при нажатии на символ карандаша.
7. После внесения настроек нажмите кнопку «Сохранить запрос» и протестируйте запрос в блоке «Тестирование запроса».
8. После этого ваш созданный запрос появится в списке доступных запросов при добавлении шага «Действие → Выполнить исходящий запрос → МАХ → Название нового запроса».