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 делает их универсальными для групповых чатов и диалогов.
Для текстовых сообщений бота, которые отправляются через исходящие запросы, такие как:
- Отправка сообщения в чат (без кнопок)
- Сообщение в чат с кнопками (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. После этого ваш созданный запрос появится в списке доступных запросов при добавлении шага «Действие → Выполнить исходящий запрос → МАХ → Название нового запроса».