Перейти к содержимому

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

Марина Погодина

5минут чтения

MAX ждёт ответа от бота 30 секунд. Если ответа нет, платформа повторяет запрос до 10 раз и через 8 часов без ответа отключает бота от адреса. С этого я начинаю, когда ко мне на обследование приносят готовые интеграции: открываю журнал вебхуков и смотрю, что бот делает при перезапуске сервера.

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

Как устроен бот в MAX, который не теряет заявки

Вебхук означает адрес, на который MAX присылает боту события. По документации платформы обработчик должен ответить кодом HTTP 200 не позже чем через 30 секунд. Поэтому рабочая схема отделяет приём события от его разбора: принять, записать в очередь, ответить, а бизнес-логику выполнить уже из очереди.

Тяжёлый запрос к складской базе прямо внутри обработчика вебхука съедает эти 30 секунд. Второе правило: строгая проверка состояния диалога. Необработанное состояние ломает сценарий, и разговор приходится передавать дежурному администратору.

Схема показывает четыре ступени развития бота: базовый сбор контактов, выдача документов из базы, интерактивные опросы и закрытая база знаний с поиском по регламентам
Развитие бота идёт от простого сбора контактов к автономной работе с внутренними базами данных

Пять сценариев чат-бота для компании

Первый сценарий: разбор первичных обращений по категориям. Бот спрашивает имя, телефон и город доставки и создаёт карточку сделки в CRM без участия секретаря.

Второй сценарий: бот сам выдаёт документы и счета на оплату. Клиент вводит номер договора, сервер проверяет права доступа через API учётной системы, и в диалог приходит готовый PDF.

Третий сценарий: оценка сервиса после отгрузки. Клиент получает шкалу прямо в переписке, а оценка записывается в хранилище с привязкой к смене сотрудников.

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

Пятый: модерация комментариев под постами канала, удаление ссылок на сомнительные ресурсы и защита от спама. Для этого сценария у PROMAREN есть готовый бот для комментариев в MAX.

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

Шаблон задания на разработку бота в MAX

Чтобы подрядчик назвал смету до подписания договора, передайте ему постановку задачи. Ниже краткий вариант из семи пунктов. Полное техническое задание оформляется по ГОСТ 34.602-2020, и эти пункты переносятся в его разделы. Персональные данные обрабатываются по Федеральному закону № 152-ФЗ "О персональных данных".

Скопируйте шаблон, заполните параметры в квадратных скобках и приложите к запросу подрядчику.

1. Цель проекта: автоматизация обработки обращений пользователей в мессенджере MAX для [название подразделения].

2. Серверная инфраструктура: база данных и обработчики размещаются в России, как требует 152-ФЗ.

3. Входные интерфейсы: официальный API платформы MAX, приём событий через вебхук, ответ HTTP 200 до 30 секунд, локальный журнал событий.

4. Роли: пользователь, авторизованный клиент, оператор поддержки, администратор системы.

5. Сценарии диалога: приветственное меню, сбор контактных данных [список полей], проверка статуса заказа в [название CRM или 1С].

6. Логика отказов: при недоступности внешних интеграций бот переводит диалог на дежурного сотрудника и записывает ошибку в журнал.

7. Требования к коду: репозиторий на аккаунте заказчика, документация по развёртыванию и инструкция администратора.

Как защитить компанию при заказе разработки бота

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

В PROMAREN репозиторий заводится на аккаунте заказчика до начала работ, исключительные права на код переходят заказчику по договору, а оплата идёт так: 50% перед этапом, 50% после приёмки.

Срок фиксируется в договоре: просрочка по нашей вине уменьшает стоимость работ по договору на 20% (пункт 3.2 образца договора). Гарантийный срок: 14 дней бесплатных доработок после запуска.

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

Пять элементов пакета проекта: техническое задание по ГОСТ 34.602-2020, репозиторий на аккаунте заказчика до начала работ, инструкция администратора, договор с уменьшением стоимости на 20% за просрочку и 14 дней бесплатных доработок после запуска
Пять вещей, с которыми бот остаётся у заказчика при смене разработчика

Частые вопросы о чат-боте в MAX

Где хранятся персональные данные клиентов бота в MAX?

База данных бота и журнал обращений размещаются на серверах в России, как требует 152-ФЗ. События MAX присылает по HTTPS, а идентификаторы пользователей связываются с профилями в вашей учётной системе.

Что происходит при потере связи с сервером базы данных?

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

Можно ли перенести готового бота на другой сервер без разработчиков?

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

Сколько стоит разработка и сопровождение бота для бизнеса?

Разработка бота под задачу стоит от 150 000 ₽, итоговая цена и срок фиксируются в договоре. Сопровождение стоит от 60 000 ₽ в месяц, без обязательного срока договора.

Что проверить в проекте самостоятельно

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

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

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

Бот для MAX: комментарии, кнопки, опросы

Без юрлица, 7 дней бесплатно, дальше от 299 ₽ в месяц

Чем подкреплено

Первоисточники

Вопросы

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

Где хранятся персональные данные клиентов бота в MAX?

База данных бота и журнал обращений размещаются на серверах в России, как требует 152-ФЗ. События MAX присылает по HTTPS, а идентификаторы пользователей связываются с профилями в вашей учётной системе.

Что происходит при потере связи с сервером базы данных?

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

Можно ли перенести готового бота на другой сервер без разработчиков?

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

Сколько стоит разработка и сопровождение бота для бизнеса?

Разработка бота под задачу — от 150 000 ₽, итоговая цена и срок фиксируются в договоре. Сопровождение — от 60 000 ₽ в месяц, без обязательного срока договора.

Кто делает

Марина Погодина, основатель PROMAREN

Марина Погодина, основатель PROMAREN

17 лет в ИТ и управлении технологическими рисками, из них 14 лет в аудите ИТ и внутреннем контроле. Более 60 аудитов ИТ и информационной безопасности.

Об автореКанал в MAX (откроется в новой вкладке)

Похожие материалы

Crumpled printed message with torn edges. Надпись: «Пост в MAX сломался молча», ниже — API вернул 200, разметка исчезла, картинка ушла отдельно.
MAX для бизнеса: каналы, боты, комментарии и API

Как публиковать посты в канал MAX через Bot API: шесть мест, где пост ломается молча

MAX Bot API без сюрпризов: токен в заголовке Authorization, поле format для разметки, обложка в два шага с отказом attachment.not.ready, пределы 4000 и 1024 знака.

Читать
Рука держит телефон, на экране вопрос с кнопками «Да» и «Нет». Надпись: «Опрос, на который реально отвечают», ниже — одна минута, вопрос без раздумий.
MAX для бизнеса: каналы, боты, комментарии и API

Как собрать опрос в MAX, на который отвечают: шесть механик и шаблоны формулировок

Шесть механик опросов в MAX, которые поднимают долю ответов, и готовые шаблоны формулировок вопросов, которые можно скопировать и применить сегодня.

Читать
A massive, heavy steel bank vault door installed on a flimsy, dented cardboard moving box. Надпись: «Автоматизация бизнеса. Скрипты дороже живых людей».
Автоматизация бизнеса: процессы, продажи, интеграции с 1С и CRM

Как начать автоматизацию бизнеса: экономика первых задач и таблица расчёта

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

Читать