Бот MAX для магазина: каталог, заказ, оплата и статус доставки

Бот MAX для магазина лучше собирать как короткий маршрут: выбрать категорию, уточнить вариант, оставить контакт, оплатить и получить следующий шаг. В MAXorg для этого есть сообщения с кнопками и медиа, вопросы, запрос контакта и email, условия, CRM, уведомления, ЮKassa и исходящий вебхук.

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

Что спроектировать до редактора

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

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

• категории и популярные позиции;
• телефон, email и параметры заказа;
• источник актуальной цены и остатка;
• ответственный за ручную проверку;
• действия после успешного платежа.

Как собрать витрину и заказ

Первое сообщение содержит две-три категории. Callback-кнопка ведёт к сообщению с фотографией, коротким отличием, ценой и действием «Заказать». Блок «Вопрос - ответ» сохраняет модель, размер, цвет или комментарий под выбранным ключом. Если наличие часто меняется, прямо напишите, что менеджер подтвердит его до оплаты.

Телефон запрашивайте кнопкой контакта, затем условием «Есть телефон» отделите подтверждённый контакт от отказа. Email можно спросить перед оплатой для чека. Геолокация даёт координаты, но не заменяет полный почтовый адрес. Не собирайте телефон, email, адрес и геолокацию без понятной цели.

1. Показать категории и товар сообщением.
2. Запросить телефон и параметры.
3. Проверить наличие человеком или внешней системой.
4. Показать итоговую сумму.
5. Перевести к оплате только подтверждённый заказ.

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

Как подключить ЮKassa

В блоке «Оплата» укажите сумму, описание, текст кнопки и ключи ЮKassa. Флажок СБП передаёт способ sbp, флажок карты передаёт bank_card; оба флажка разрешают оба способа. Если они выключены, доступные варианты определяет ЮKassa. При необходимости запросите email для чека.

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

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

CRM, уведомления и вебхук

После оплаты действие «Создать карточку в CRM» помещает заявку в выбранную колонку с названием и заметками. Блок уведомления отправляет владельцу письмо и сообщение в MAX; в шаблон подставляются имя, ID, телефон, email и username. Это сигнал сотруднику, а не подтверждение склада.

Вебхук отправляет POST на безопасный публичный HTTP- или HTTPS-адрес. Для боевой работы используйте HTTPS. Можно передать имя, username, телефон, email, геолокацию, user ID и последний текст. Секрет идёт в заголовке X-Webhook-Secret. Тайм-аут равен 8 секундам, разрешено не больше двух перенаправлений.

На стороне магазина нужен обработчик, который проверяет секрет, валидирует JSON и защищается от повторной обработки. Воронка сохраняет webhookStatus и webhookError, но автоматический повтор не гарантирован. Передавайте только нужные поля и заведите журнал ошибок.

• правильный секрет принимается, неверный отклоняется;
• пустой телефон не создаёт некорректный заказ;
• повторный запрос не создаёт дубль;
• ошибка вебхука видна ответственному сотруднику.

Как сообщать статус доставки

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

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

Минимальная рабочая схема

Соберите /start, меню категорий, карточку товара, запрос контакта, вопрос о варианте и проверку наличия. После этого покажите сумму и блок ЮKassa. Успешная ветка создаёт CRM-карточку, уведомляет менеджера и отправляет клиенту подтверждение. Неуспешная оплата ведёт к повтору или связи с сотрудником.

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

1. /start и выбор категории.
2. Товар с медиа и кнопкой «Заказать».
3. Контакт и параметры заказа.
4. Проверка цены и наличия.
5. ЮKassa с точной суммой.
6. CRM, уведомление и подтверждение после успеха.

Как тестировать и исправлять ошибки

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

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

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