Как подключить MAX-бота

Что подготовить

• Аккаунт MAX и доступ к рабочему номеру телефона.
• Профиль организации, ИП или самозанятого, зарегистрированного в России, для подтверждения на платформе MAX.
• Название магазина, описание и изображение для карточки бота.
• Доступ к вашей CRM: «Настройки» → «Мессенджеры». Для webhook нужен публичный адрес CRM с https://.
• Компьютер для однократной настройки получения сообщений в шаге 6.

MAX предоставляет создание ботов через подтверждённый профиль бизнеса. Обычного личного аккаунта для этого недостаточно. Условия подключения опубликованы в справке MAX.

1. Откройте MAX для партнёров и начните регистрацию или войдите в существующий профиль.
2. Используйте рабочий номер телефона, к которому у вас будет постоянный доступ. Выполните подтверждение входа, которое предложит платформа.
3. Создайте профиль своего бизнеса и заполните запрашиваемые сведения.
4. Пройдите подтверждение профиля предложенным способом. Для организации и ИП доступны Госуслуги или поддерживаемый банковский ID; для самозанятого — Госуслуги.
5. Дождитесь подтверждения и выберите этот профиль для дальнейшей работы.

Конкретные действия подтверждения зависят от типа бизнеса. Пользуйтесь актуальными инструкциями MAX: регистрация и создание профиля.

1. В подтверждённом профиле откройте «Чат-боты» → «Создать».
2. Заполните карточку бота: название магазина, описание его назначения и изображение, если эти поля предложены платформой.
3. Нажмите «Создать» и дождитесь успешной модерации. Если MAX запросит исправления, внесите их в карточку.

Никнейм MAX формирует автоматически. Используйте присвоенный боту никнейм; выбирать собственный при создании не требуется. Порядок описан в справке о чат-ботах MAX.

1. После модерации откройте «Чат-боты» в кабинете MAX.
2. У нужного бота выберите ⋮ → «Настройки».
3. Нажмите значок копирования справа от токена. На экране он частично скрыт, но кнопка копирует полное значение.

Перенесите эту строку в поле API token в CRM. Никнейм, ID профиля и номер телефона в это поле не подходят. Токен храните как пароль и не отправляйте покупателям.

Откройте «Настройки» → «Мессенджеры» → «Добавить подключение». Перенесите данные по таблице. Проверьте канал и API URL, даже если в форме уже есть значения. На телефоне таблицу можно прокрутить по горизонтали.

Нажмите «Создать подключение». Для одного магазина или общей области допускается одно активное подключение MAX. Если оно уже есть, редактируйте существующее.

Адрес platform-api2.max.ru указан в актуальной документации MAX API.

В строке созданного подключения откройте ⋮ → «Обновить статус». Успешный результат — «Авторизован».

Этот статус подтверждает доступ к боту по токену. Получение сообщений нужно включить отдельно в следующем шаге.

Скопируйте полный адрес из столбца «Webhook» в строке подключения MAX в CRM. Это адрес, на который MAX будет присылать сообщения. Он должен начинаться с https:// и быть доступен из интернета. Используйте адрес именно своей CRM.

Однократно зарегистрируйте этот адрес через MAX API. Сделайте это в настольном Postman по следующим шагам.

1. Скачайте и установите Postman для компьютера.
2. Откройте приложение. На экране входа выберите работу без аккаунта — lightweight API Client. В этом режиме запросы хранятся на вашем компьютере.
3. Выберите New → HTTP или откройте новую вкладку запроса кнопкой +. Затем заполните поля по инструкции ниже.

Описание этого режима: официальная справка Postman. После настройки удалите запросы с токеном из локальной истории и закройте их вкладки.

1. Выберите метод POST и вставьте адрес https://platform-api2.max.ru/subscriptions.
2. На вкладке Authorization выберите No Auth. Авторизацию укажем отдельной строкой ниже.
3. Откройте Headers. Добавьте строку: Key = Authorization, Value = полный токен из шага 3. Вставьте только токен, без Bearer.
4. Откройте Body → raw и выберите формат JSON. Он задаёт заголовок Content-Type: application/json.
5. Вставьте тело запроса ниже. Вместо ВАШ_WEBHOOK_URL вставьте адрес из столбца «Webhook», сохранив кавычки.

{"url":"ВАШ_WEBHOOK_URL","update_types":["message_created","bot_started"]}

Нажмите Send. Успешный ответ содержит "success": true. Эти два типа событий нужны для новых сообщений и запуска бота по ссылке заказа.

Проверьте зарегистрированный адрес

Создайте второй запрос: метод GET, адрес https://platform-api2.max.ru/subscriptions. Добавьте такой же заголовок Authorization с токеном, выберите No Auth и нажмите Send. В массиве subscriptions найдите запись, у которой url совпадает с адресом из CRM.

Формат запроса и ответа опубликован в документации MAX: создание подписки и проверка подписок.

1. Откройте заказ магазина, для которого настроен бот.
2. В общей информации рядом с телефоном покупателя нажмите значок MAX. CRM откроет окно «Ссылка для клиента» с адресом и QR-кодом.
3. Нажмите «Скопировать ссылку» и отправьте покупателю или предложите ему отсканировать QR-код.
4. Покупатель открывает ссылку в MAX и запускает бота. Для проверки сделайте это со своего аккаунта в тестовом заказе.
5. Отправьте боту «Проверка подключения».
6. В чате этого заказа в CRM выберите канал MAX, дождитесь сообщения и отправьте ответ. Проверьте, что он появился в MAX.

Ссылка из CRM содержит данные заказа для привязки чата. Используйте её целиком. Обычная ссылка на профиль бота без данных заказа не выполняет такую привязку. Сначала покупатель запускает бота, затем менеджер может отвечать из CRM.

Если не получилось

Официальные инструкции

• Регистрация и условия подключения к MAX.
• Создание чат-бота и получение токена.
• Настройка webhook MAX API.
• Как подключить Telegram-бота к DoorLine CRM.