FloraKIT
Max

Создать бота в Max

Пошагово: токен Max, мини-приложение и подключение магазина в FloraKIT

Бот в Max — это ваш мини-магазин и уведомления о заказах. Нужен тариф Про и выше.

1. Создайте бота на платформе Max

  1. Откройте платформу Max для партнёров (или мини-приложение «MAX для бизнеса»).
  2. Раздел Чат-боты → создайте бота.
  3. Скопируйте токен (Расширенные настройки → Настроить / команда «Получить токен»).

Никому не пересылайте токен.

2. Укажите URL мини-приложения

В расширенных настройках бота вставьте URL вашей витрины (HTTPS), например:

https://ваш-магазин.florakit.ru/

Выберите вид кнопки открытия (Открыть / Старт) и сохраните. Без этого кнопка «Открыть магазин» в чате не откроет каталог внутри Max.

3. Подключите бота в FloraKIT

  1. Кабинет → Приложения → Max.
  2. Вставьте токен → Подключить.
  3. FloraKIT подпишет webhook на https://…/api/max/webhook/<id> (нужен HTTPS).

4. Напишите боту Старт

  1. Найдите бота в Max по username.
  2. Нажмите Старт или отправьте /start.
  3. Должно прийти приветствие с кнопками «Открыть магазин» и «Сайт».

Так же бот запоминает ваш чат для уведомлений о заказах.

Локальная разработка

Max не принимает HTTP и самоподписанные сертификаты. Задайте:

MAX_WEBHOOK_BASE_URL=https://xxxx.ngrok-free.app

и пробросьте туннель на локальный Next.

Если что-то не получается

Что видитеЧто сделать
Ошибка про токенСкопируйте токен ещё раз целиком
https_requiredНужен публичный HTTPS (ngrok или прод)
Бот молчитПроверьте статус «подключён» и снова Старт
Мини-приложение пустоеURL витрины должен быть в настройках бота на платформе Max

Готово: клиенты открывают магазин из Max, вы получаете заказы там же.

On this page