Быстрое руководство по созданию бота в MAX

Создать и настроить бота в MAX можно за 20–30 минут при наличии бизнес‑аккаунта: зарегистрируйте ИП/ООО, создайте бота в кабинете, получите токен, подключите webhook и настройте сценарий через Make.com или собственный код — ниже пошагово.

Перед стартом — требования и проверка доступа

• Нужен бизнес‑профиль: ИП (рекомендуется НПД/МПД) или ООО — обычный личный аккаунт не даст доступа к разделу "Чат‑боты".
• Зарегистрируйтесь в кабинете для бизнеса и пройдите верификацию (через Госуслуги или банк). Обычно занимает 1–2 дня.

• После верификации появится доступ к разделу "Чат‑боты" в кабинете.

Шаги: создание, получение токена и подключение webhook

1. Создание бота в кабинете

   • Откройте раздел "Чат‑боты" → "Создать бота".
   • Укажите название (до 32 символов), краткое описание и загрузите аватар (рекомендуем 512×512).
   • Ник генерируется автоматически (формат idИНН_bot). После отправки бот уходит на модерацию (от 10 минут до суток). По итогам модерации бот становится активным и получает публичную ссылку вида max.ru/idИНН_bot.

2. Получение токена

   • В настройках бота скопируйте API‑токен (Authorization: Bearer {токен}).

3. Подключение webhook (приём входящих сообщений)
   • Отправьте POST на: https://platform-api.max.ru/subscriptions
   • Заголовки: Authorization: Bearer {ваш_токен} Content-Type: application/json
   • Тело (пример):

   {
     "url": "https://your-webhook-url.com/webhook",
     "update_types": ["message_created"],
     "secret": "your_secret_key"
   }

• Ожидаемый ответ: {"success": true}
• После настройки отправьте тест‑сообщение боту — платформа пришлёт событие на ваш webhook.

Сценарии, интеграции и отправка ответов

• Быстрый без‑код сценарий через Make.com:
  1. Создайте Custom Webhook в Make и вставьте URL в подписку MAX.
  2. Добавьте модуль для обработки входящего JSON, затем модули OpenAI/Google Sheets/CRM.
  3. Для ответа вызывайте метод отправки сообщений: POST https://platform-api.max.ru/messages Заголовок: Authorization: Bearer {токен} Тело:

     {
       "chat_id": "{user_id_из_webhook}",
       "text": "Ваш ответ здесь"
     }
     ```
- Примеры логики:
  - Echo‑бот: возвращает "Вы сказали: {текст}".
  - Поддержка: поиск по FAQ и кнопки‑варианты ответа.
  - Магазин: корзина и платежный чек через интеграцию с платёжным модулем.
- Для полной автоматизации используйте код на Python/Node.js, храните состояние в БД и обрабатывайте webhooks локально.

## Тестирование и отладка
- Проверьте: приходят ли события на webhook, корректен ли секрет и возвращается ли 200.
- Логируйте тела запросов и ответы API (без токенов в логах).
- Частые ошибки: invalid JSON, неверный chat_id, отсутствие прав токена — проверяйте статус ответа API и тело ошибки.

## Частые ошибки
- Попытка создать бота до верификации — раздел недоступен.
- Хранение токена в открытом репозитории — приводит к захвату бота.
- Неправильный URL webhook (HTTP вместо HTTPS) — платформа отклонит подписку.
- Отправка некорректного JSON — обработчик возвращает 400.

## FAQ
- Сколько времени модерация бота? Обычно 10 минут — 24 часа, зависит от нагрузки.
- Можно ли подключить OpenAI? Да, через Make.com или свой сервер — отправляйте текст в OpenAI и формируйте ответ.
- Где посмотреть статистику? В кабинете бизнеса доступна аналитика по сообщениям.
- Нужно ли платить за бота? Базовая функциональность в кабинете доступна для бизнеса; интеграции могут требовать платных тарифов сторонних сервисов.

Удачи: начните с простого Echo‑бота, убедитесь в стабильности webhook и постепенно добавляйте интеграции и кнопки для улучшения UX.