Как создать чат-бот в Максе для компании: профиль, модерация, кнопки и связь с CRM

Бота в MAX создают на платформе MAX для партнеров, и подключиться к ней могут юрлица, ИП и самозанятые, резиденты России. Физическим лицам и нерезидентам проверка профиля пока недоступна, поэтому зарегистрировать бота на частное лицо или на зарубежную компанию не получится.

Организация или ИП создает до 5 ботов, самозанятый до 2. Этого хватает, чтобы развести бота для клиентов и бота для партнеров или дать филиалам разные сценарии.

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

Откройте веб-версию платформы business.max.ru/self или мини-приложение «MAX для бизнеса». В веб-версии вход по номеру телефона и коду из СМС. Документация советует корпоративный номер или рабочий номер ответственного сотрудника, который всегда под рукой: на него приходят коды и важные уведомления.

Затем выберите тип профиля: организация, ИП или самозанятый. Один номер телефона или адрес почты соответствует одному типу профиля.

Организацию подтверждает владелец или представитель с правом первой или единственной подписи. На Госуслуги входите с ролью «Руководитель» или «Администратор»: с ролью сотрудника проверка не пройдет. Если к учетной записи привязано несколько организаций, выберите нужную из списка.

Данные ЕГРЮЛ или ЕГРИП на Госуслугах должны быть свежими. Устаревшие обновляют в разделе «Профиль организации», пункт «Данные организации», кнопка «Обновить»: обычно это занимает от нескольких минут до часа, в редких случаях до 24 часов. Об успешной проверке напишет бот «MAX для бизнеса». Если подтвердить организацию не удалось, пишите в чат «Поддержка MAX для бизнеса» или на partner_support@max.ru и укажите ИНН, номер телефона, порядок своих действий и снимок экрана с ошибкой.

В профиле откройте раздел «Чат-ботычат-бот Чат-бот это программа, которая переписывается с человеком в окне чата: на сайте, в мессенджере или в приложении. Подробнее в словаре» и нажмите «Создать». Карточку клиент видит раньше первого ответа бота, поэтому заполните ее как вывеску компании.

Логотип: 500х500 пикселей, квадрат 1:1, файл JPG или PNG до 5 МБ, обрезать его можно прямо на платформе. Название: до 59 символов, только латиница, кириллица и цифры, без эмодзи. Описание: до 200 символов, здесь эмодзи уже допустимы.

Никнейм платформа создает сама: idИНН_bot для юрлица и ИП, отдельный вид с номером организации для самозанятого. Выбрать или поменять его пока нельзя. После создания в карточке появятся название организации, ссылка вида max.ru/idИНН_bot и QR-код: их вы потом поставите на сайт и в материалы для клиентов.

В описании документация советует указать часы работы, контакты поддержки, телефон или адрес офиса. Текст должен соответствовать деятельности организации, а в названии, логотипе и описании не должно быть ненормативной лексики, материалов 18+ и данных других компаний.

После повторного нажатия «Создать» бот уходит на проверку. Она занимает до 48 часов по рабочим дням, и все это время настройки бота заблокированы. О результате сообщит бот «MAX для бизнеса» в личных сообщениях.

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

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

Токентокен Токен это кусочек текста: слово, часть слова или знак, с которыми работает языковая модель. Подробнее в словаре выдают только после модерации. В разделе «Чат-боты» выберите бота, нажмите «⋮» и «Настройки», затем значок копирования справа от поля токена. Токен дает полное управление ботом: не храните его в открытом доступе и передавайте только сервису или подрядчику, который собирает сценарий. Если токен мог попасть к посторонним, обновите его там же значком обновления.

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

Конструктор. Готовые шаблоны, сценарий из блоков и кнопок, аналитика после запуска. Конструкторы делают официальные партнеры MAX, а не сам мессенджер: на платформе откройте «Интеграции», «Подключить» и выберите категорию или найдите сервис по названию. Среди партнеров есть платформы чат-ботов, чаты поддержки, CRM и конструкторы мини-приложений. Сервис подключают своим токеном или заказывают у партнера разработку под ключ. Правки потом вносят на сайте конструктора, а не в MAX, и работать в нем документация советует с компьютера.

Свой код. Бот работает через API MAX по адресу platform-api2.max.ru, токен передается в заголовке Authorization, лимит 30 запросов в секунду. У MAX есть официальные библиотеки для JavaScript, TypeScript и Go, а схема API опубликована в формате OpenAPI, и по ней генерируют код для Python, Java, PHP и других языков.

Рабочему боту MAX доставляет сообщения только через вебхук: адрес HTTPS на порту 443 с сертификатом доверенного центра или Минцифры. Сервер должен ответить за 30 секунд, иначе MAX повторит отправку до 10 раз, а если успешного ответа нет 8 часов, отпишет бота от вебхука. Long Polling годится только для разработки и тестов, и оба способа сразу включить нельзя. Подписку на вебхук по шагам мы разобрали в инструкции по сборке ИИ-агента в MAX.

Как выбрать. Конструктор быстрее, но сценарий хранится у поставщика и меняется только в его интерфейсе. Свой код требует сервера и разработчика, зато логика и данные остаются у компании, а бота можно связать с любой вашей системой.

Сценарий обычного бота строится на кнопках. MAX поддерживает семь типов: callback присылает вашему серверу событие о нажатии, link открывает ссылку, request_contact просит клиента поделиться телефоном, request_geo_location просит геопозицию, open_app открывает мини-приложение, message отправляет боту готовый текст, clipboard копирует текст в буфер обмена.

В одной клавиатуре до 210 кнопок в 30 рядах, в ряду до 7 кнопок, а кнопок со ссылкой, мини-приложением, запросом телефона или геопозиции не больше 3. Надпись, которая не помещается на кнопке, обрезается, поэтому пишите коротко: «Записаться», «Узнать цену», «Позвать менеджера».

Текст сообщения до 4000 символов, его можно оформить через Markdown или HTML. В один диалог бот отправляет не больше двух сообщений в секунду, поэтому длинный ответ удобнее дать одним сообщением, а не пятью короткими подряд.

Рабочий сценарий для компании короткий: приветствие с тремя или четырьмя кнопками, ответы на частые вопросы, кнопка запроса телефона для заявки и кнопка «Позвать менеджера» на каждом шаге. Если бот собирает имена и телефоны, решите до запуска, где они хранятся: требования 152-ФЗ и наш подход описаны на странице о безопасности данных.

Сайт. Проще всего поставить ссылку max.ru/idИНН_bot и QR-код из карточки бота на страницу контактов и в подвал сайта. Чтобы понимать, откуда пришел клиент, используйте диплинк вида max.ru/никнейм?start=метка. Когда клиент переходит по нему, бот получает событие bot_started с этой меткой, и видно, что человек пришел со страницы доставки, а не из рекламы.

У метки три правила. Она не длиннее 128 символов, иначе бот ее не получит. В ней нельзя передавать конфиденциальные данные открытым текстом, а отправлять через диплинки сообщения для авторизации запрещено. Чтобы бот получал такие переходы, событие bot_started нужно включить в подписку вебхука.

CRM. Если ваша CRM есть в разделе «Интеграции», ее подключают токеном бота без разработки. Если нет, заявку из бота передает ваш код: сценарий собирает имя, телефон и суть запроса и создает лид или сделку через API CRM. Как это устроено в конкретных системах, смотрите на страницах про amoCRM и Битрикс24.

Команда. Добавить бота в личный диалог нельзя, а в групповой чат сотрудников можно. Сначала в настройках бота в разделе «Приватность» разрешите добавление в группы: по умолчанию оно выключено. Затем создайте групповой чат в MAX, добавьте бота через «Участники» и назначьте администратором с правами read_all_messages и write. Теперь бот может присылать в чат каждую новую заявку, и дежурный менеджер видит ее сразу.

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

В карточке. Эмодзи в названии: там разрешены только буквы и цифры. Логотип не квадратный или тяжелее 5 МБ. Описание не про вашу деятельность или с данными другой компании. Ненормативная лексика и материалы 18+ в любом поле.

В сценарии. Требования MAX запрещают использовать API для рекламных, маркетинговых и других массовых рассылок, если договор с MAX прямо этого не разрешает. Конкурсы и акции внутри бота нужно отдельно согласовать с MAX. Разработчик обязан опубликовать политику обработки персональных данных и сведения о себе, поддерживать пользователей и разбирать их претензии.

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

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

Бот перестает справляться, когда клиенты пишут своими словами: «можно на четверг после шести и сколько выйдет с доставкой?». Кнопок на такие вопросы не напасешься. Здесь нужен ИИ-агентИИ-агент ИИ-агент это нейросеть, которая не просто отвечает, а сама выполняет задачу по шагам: ищет данные, пользуется программами и проверяет результат. Подробнее в словаре: он понимает свободный текст, сверяет цены и свободное время, заводит сделку в CRM и передает человеку сложный случай вместе с историей переписки. Подробнее о разнице в статье о том, чем ИИ-агент отличается от чат-бота.

Собрать агента в MAX самостоятельно можно по нашей инструкции: бот, вебхук и открытая модельмодель с открытыми весами Модель с открытыми весами (open-weights model) это нейросеть, файлы параметров которой можно скачать и запустить на своем оборудовании. Подробнее в словаре на вашем сервере. Если агент должен сразу работать с CRM и клиентами, мы подключаем его под ключ: пилот за 14 дней от 150 000 ₽ с метрикой в договоре, подробности на странице ИИ-агента для MAX. Для потока типовых обращений есть отдельное решение: чат-бот поддержки в MAX.