Table of contents

MAX: Подключить сценарий к чат-боту

С помощью VK CXhub вы можете создать и запустить сценарий для чат-бота в МАХ.

Рассказываем как это сделать:

1. Выберите или создайте чат-бота, чтобы получить токен

Токен можно получить в специальном чате @MasterBot. Найдите его в мессенджере МАХ и начните с ним диалог.

Если у вас уже есть созданные боты, воспользуйтесь командой /list, чтобы получить список ваших ботов, затем нажмите на выбранный бот, и вам будет отправлено сообщение в мессенджер с информацией о боте, включая токен:

Чтобы создать чат-бота, напишите в диалоге /create и следуйте указаниям @MasterBot:

  • Придумайте ник для бота. Он будет отображаться в ссылке на бота как в этом примере — max.ru/usernamebot. Минимальное количество символов — 11.
  • Отправьте имя бота — до 16 символов. Так его будут видеть и искать в глобальном поиске пользователи мессенджер. Можно использовать латиницу и кириллицу.

Пример диалога с @MasterBot:

2. Скопируйте токен

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

На скриншоте выше токен выделен красным цветом.

3. Создайте новую интеграцию в VK CXhub

  • Перейдите в раздел «Интеграции» в главном меню VK CXhub. Найдите в списке интеграций «МАХ» → Нажать «Создать»:
  • В поле «Название интеграции» задайте название вашей интеграции, в поле «API ключ» вставьте скопированный в п.2 данной инструкции токен и нажмите «Перейти к авторизации». 

Рекомендация: если вы планируете создание интеграций МАХ для нескольких ботов, можно указать в названии интеграции ник вашего бота, чтобы в дальнейшем было удобно определять, к какому боту относится интеграция.

  • После успешного создания интеграции вы будете автоматически перенаправлены на страницу интеграции, и в левом верхнем углу под названием вашей интеграции будет сообщение «Подключено» зеленого цвета:

4. Создайте переменную MAX ID в VK CXhub

  • Перейдите в раздел «Настройки» -> «Управление данными» -> «Переменные клиентов» и нажмите в правом верхнем углу «Создать переменную». В открывшемся модальном окне заполните поля:

Название переменной — MAX ID

Системное имя — MaxUserID

Тип поля — Строка

Уникальная переменная — Да (важно)

После заполнения полей нажмите «Добавить»: