Как создать бота в MAX: инструкция для бизнеса без кода

Проверьте, можно ли вам создать бота в MAX

Бот в MAX принадлежит бизнесу, не частному лицу, а от вида профиля зависят три вещи. Мы свели их в таблицу по ответам платформы:

Задачу часто поручают сотруднику, но один шаг он за компанию не сделает. Раздел о подключении оставляет подтверждение организации её владельцу, то есть единоличному исполнительному органу, либо представителю, который подписывает документы первой или единственной подписью. Найдите с директором время до старта, иначе работа встанет на середине.

Зарегистрируйтесь на платформе MAX для партнёров

Быстрее начать в самом мессенджере: откройте «MAX для бизнеса» - это мини-приложение, учётная запись для него не нужна. Нажали «Начать» - и заполняете профиль. Кому удобнее компьютер, тому подойдёт сайт платформы.

На сайте сначала попросят телефон и пришлют на него SMS с кодом. С номером не спешите: к нему привяжется ровно один профиль (компании, ИП или самозанятого), а с ним всё, что вы в нём заведёте, - каналы, боты, мини-приложения. Поэтому платформа советует номер компании либо рабочий телефон представителя, который отвечает за профиль. Хуже всего личная сим-карта сотрудника: однажды он уволится.

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

Там же, в помощи, есть предупреждение, которое легко пропустить. Имя и фамилия в вашем аккаунте мессенджера MAX - это ответственный представитель, а не компания. Если вместо имени стоит вывеска бизнеса, аккаунт рискует показаться подозрительным и попасть под блокировку.

Пройдите верификацию профиля

Сначала платформа спросит статус: самозанятый, ИП или организация. Затем придётся доказать, что бизнес настоящий. Подробно об этом - в разделе о подключении.

Организация и ИП выбирают между Госуслугами и входом через банк, то есть T-Business ID или Alfa ID. Банк пока доступен только на сайте платформы. На Госуслугах обычно спотыкаются о три пункта, проверьте их заранее:

1. Компания или ИП заведены на Госуслугах и у них есть свой личный кабинет.
2. Вы зашли туда «Руководителем» или «Администратором». Сотрудник подтвердить организацию не сможет, сколько ни пробуй.
3. Данные из ЕГРЮЛ или ЕГРИП в кабинете актуальны. Если нет, кнопка «Обновить» есть в разделе «Профиль организации» → «Данные организации». Обновление занимает минуты, максимум час, а в редких случаях тянется сутки.

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

Об успехе скажут две вещи: откроется главный экран с выбором сервисов, а в бот «MAX для бизнеса» придёт сообщение, что верификация пройдена. Застряли - платформа просит написать в поддержку, приложив ИНН, номер телефона, описание своих шагов и по возможности снимок экрана с ошибкой.

Создайте бота и заполните его карточку

Бот заводится быстрее профиля, по инструкции MAX это несколько нажатий. В своём профиле зайдите в «Чат-боты» и нажмите «Создать». Откроется карточка: заполните её и подтвердите кнопкой «Создать» в самом низу.

Рядом с полями видно превью: так бот будет выглядеть у клиентов. Адрес (никнейм) придумывать не нужно - его назначают, выбирать пока нельзя. Юрлицо или ИП получит idИНН_bot, самозанятый - адрес из номера своего профиля. Это единственное в карточке, что после проверки не исправить.

Мат, контент 18+ и чужие данные других компаний под запретом везде - в названии, описании и на логотипе. Описание обязано совпадать с реальным делом бизнеса. Хороший приём подсказывает сама платформа: впишите график оператора, телефон или адрес, и человек поймёт, с кем переписывается.

Два поля профиля появятся без вашего участия - название организации и ссылка на бота с QR-кодом. Первое для клиента знак: бот официальный, а не подделка.

Готовые описания для карточки бота

Все три укладываются в лимит 200 символов. Возьмите ближайшее к вашему делу и поправьте под себя.

Дождитесь модерации и скопируйте токен

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

Заметили опечатку, пока идёт проверка? Ждать незачем: бота можно стереть и завести заново без ошибки. У опубликованного всё иначе: каждое изменение отправляет его на повторную модерацию, а клиентам до её конца показывается прежний вариант.

Токен - ключ для любой программы, которая пишет клиентам за бота: собственного кода, конструктора, ИИ-консультанта. Появляется он, только когда бот прошёл проверку. Путь к нему описан в разделе об управлении ботом: «Чат-боты» → «⋮» напротив нужного бота → «Настройки». Скопировать токен можно значком сразу за полем.

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

Выберите, как бот будет отвечать клиентам

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

Написать код самому

Без своего разработчика сюда лучше не ходить. Порядок работы в разделе о разработке такой: бот и токен, затем подписка на события через Webhook (пока идёт разработка и отладка, хватит Long Polling), потом отправка сообщений с кнопками и загрузка файлов. Официальные библиотеки MAX выпустил для JavaScript и Golang, остальным языкам остаётся спецификация OpenAPI. Потолок нагрузки - 30 запросов в секунду.

Плюс кода - полная свобода. Минус - бот целиком на вас: сервер, обновления, исправления, и даже каждая новая фраза бота проходит через программиста.

Собрать сценарий в конструкторе

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

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

Подключить ИИ-консультанта

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

Для этого нужны токен и сервис, совместимый с MAX. Как это устроено в CyberAI, показано в следующем разделе.

Разницу между кнопочным и ИИ-ботом и то, откуда берётся цена, мы разбирали в статье «Чат-боты для бизнеса».

Как подключить ИИ-консультанта к боту MAX: пример CyberAI

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

Вставьте токен бота

Откройте «Подключения» → «MAX» и вставьте токен. Копируйте токен целиком и без пробела в начале или в конце: из чата он часто копируется вместе с невидимым пробелом. Токен от Telegram сюда не подойдёт - боты заводятся похоже, но ключи разные.

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

Загрузите то, что бот должен знать

Раздел «База знаний», кнопка «+ Добавить источник». Способов пять, и они дополняют друг друга:

• сайт - бот обойдёт страницы сам; обычно там написано про доставку, оплату и возврат. Сайт заново не перечитывается: поменяли страницу - добавьте её ещё раз;
• файлы - PDF, DOCX, TXT, MD, CSV. Прайс в CSV или таблице разбирается по строкам, и бот отвечает про конкретную позицию;
• текст вручную - то, чего нет ни в одном документе: «работаем без выходных», «самовывоз со склада»;
• фото - этикетка, таблица размеров, прайс на бумаге: текст распознаётся и ложится в базу;
• пары вопрос-ответ - готовые ответы на частые вопросы.

Напишите правила бота

«Настройки бота» → «Правила бота». Это инструкция своими словами: кто вы, на «вы» или на «ты», насколько коротко отвечать, что предлагать в конце и чего не делать. Знаний правила не добавляют: фраза «ты знаешь наш ассортимент» ничего не даст, ассортимент должен лежать в базе. Правила управляют только тем, как бот говорит.

Готовые правила для магазина, услуг и опта

Каждый вариант вставляется в поле целиком. Для интернет-магазина:

Для мастерской, салона или другого бизнеса с записью:

Для оптовых покупателей:

Проверьте ответы в тест-чате

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

Решите, когда разговор переходит к человеку

«Настройки бота» → вкладка «Кто отвечает». Режимов три: «Только бот» (не знает ответа - честно говорит, что не знает), «Бот, а сложное - вам» и «Только вы», когда каждый ответ сначала идёт к вам. Ниже выбирается, куда приходят разговоры: в Telegram или в MAX.

Если выбран MAX, напишите своему боту команду /admin - по-другому он вас не найдёт, ников у MAX нет. Получатель в MAX один. Вместе с обращением приходит черновик ответа текстом: ответьте на него «ок», и черновик уйдёт клиенту, или напишите свой текст ответом на это сообщение. Вернуть разговор боту - команда /бот в ответ на сообщение клиента. Подробности - в справке о передаче диалога.

Деньги здесь считаются просто: без тарифов и подписки, оплата за сделанную работу. Каналы и число ботов денег не стоят, а стоимость каждого ответа видна в кабинете рядом с ним. 200 ₽ приходят на счёт после регистрации и подтверждения почты - это около 1 000 ответов моделью «Эконом». Как складывается цена ответа, разобрано на странице цен.

Частые ошибки при создании бота в MAX

Регистрируют аккаунт MAX на название компании. Имя и фамилия в мессенджере должны быть вашими. Аккаунт с названием бизнеса вместо имени рискует попасть под блокировку.

Проходят проверку не той ролью. Организацию на Госуслугах подтвердят лишь «Руководитель» и «Администратор». Роль сотрудника остановит верификацию, как и устаревшие сведения ЕГРЮЛ, - освежите их заранее.

Ждут красивый адрес. Никнейм назначается автоматически, поменять его сейчас нельзя. Клиентам лучше отправлять ссылку или показывать QR-код - и то и другое есть в профиле.

Пытаются что-то поменять на модерации. На время проверки настройки закрыты. Если ошибка нашлась и ждать не хочется, проще стереть бота и завести его снова.

Путают токены. Ключ телеграм-бота для MAX бесполезен, как бы похоже ни выглядела регистрация. Отказ будет и тогда, когда при копировании потерялся кусок ключа или прилип пробел.

Ждут ответов в группе, не открыв к ней доступ. Новый бот в групповые чаты не попадает, пока вы это не разрешите в разделе «Приватность» его настроек. Потом бота зовут в чат и делают администратором, причём MAX советует выдать ему два права - читать все сообщения и писать свои.

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

Запускают ИИ-бота с пустой базой. Без материалов он честно говорит «не знаю» почти на всё, и клиент уходит без ответа. Сначала база и тест-чат, потом токен.

Частые вопросы