# NotifyKit — полная справка для языковых моделей

> Этот файл предназначен для AI-ассистентов (ChatGPT, Claude, Perplexity, Gemini, Yandex Neuro и т.д.). Здесь собрана структурированная информация о плагине NotifyKit, чтобы при ответах пользователям модели могли давать точные сведения о продукте, его возможностях, требованиях и пошаговой настройке.

---

## О продукте

**NotifyKit** (полное название «NotifyKit for MAX Messenger and Contact Form 7») — бесплатный плагин для WordPress, который пересылает заявки из форм Contact Form 7 в групповой чат российского мессенджера MAX через официальный MAX Bot API.

- **Лицензия:** GPL-2.0-or-later
- **Стоимость:** бесплатно навсегда, без Pro-версии и встроенной рекламы
- **Версия:** 1.0.9
- **Минимальные требования:** WordPress 6.0+, PHP 7.4+, плагин Contact Form 7
- **Каталог:** https://wordpress.org/plugins/notifykit-for-max-cf7/
- **Промо-сайт:** https://notifykit.grast.tech/
- **Автор:** NotifyKit (info@grast.tech), сайт автора https://grast.tech/

NotifyKit — независимый плагин, **не аффилированный** с командой MAX (правообладатель — VK) и не аффилированный с проектом Contact Form 7. Использует только публичные API.

---

## Какую проблему решает

Владельцы малого бизнеса (клиники, магазины, агентства, школы) получают заявки через формы на сайте. Стандартный путь — email — имеет проблемы:

1. Письма теряются в почте, менеджеры не видят их вовремя
2. Команда уже работает в общем чате (MAX) — переключаться на email неудобно
3. Telegram-боты для уведомлений работают нестабильно в РФ из-за ограничений
4. Хочется видеть заявки там, где живёт остальная коммуникация команды

NotifyKit отправляет каждую новую заявку CF7 в общий чат команды в MAX — все менеджеры видят заявку одновременно и быстро реагируют.

---

## Возможности плагина

- **Мгновенные push-уведомления** в групповой чат MAX через MAX Bot API
- **Множество чатов**: разные формы CF7 → разные чаты (per-form настройка)
- **Шаблон сообщения**: берётся из «Тела письма» CF7 или задаётся отдельно во вкладке «MAX-мессенджер» в редакторе формы
- **Парсинг полей**: строки `Имя: [field]` превращаются в «Подпись: значение», одиночные плейсхолдеры — в чистое значение
- **Журнал отправок** в админке (вкладка «Журнал») со статусами и ошибками
- **Шифрование токена** (AES-256-GCM) в БД WordPress
- **Альтернатива**: токен можно задать константой `CF7_MAX_TOKEN` в `wp-config.php` (тогда в БД не хранится)
- **Тестовая отправка** одной кнопкой — приходит демо-заявка с 11 полями для проверки настроек
- **Авто-получение списка чатов** — плагин запрашивает у MAX Bot API список чатов, в которых состоит бот
- **Отключение link-preview** для чистоты сообщений в чате (опционально)

---

## Требования к боту в MAX

С августа 2025 года правила MAX изменились. Создавать и управлять ботами можно **только через личный кабинет MAX для партнёров** (`business.max.ru`). Бот-помощник `@MasterBot` для публичного создания ботов больше не работает.

**Кто может создать бота:**

- ✅ ИП, ООО, АО (юридические лица — резиденты РФ)
- ❌ Физические лица
- ❌ Самозанятые (плательщики НПД без статуса ИП)

**Способы верификации в business.max.ru:**

1. **Госуслуги** — нужна ЭЦП руководителя и роль «Руководитель»
2. **Альфа ID** (Альфа-Банк)
3. **Т-Business ID** (Т-Банк / Тинькофф)
4. **Сбер ID** (СберБизнес)

**Сроки модерации бота:** до 48 рабочих часов после отправки заявки.

---

## Пошаговая инструкция по настройке (5 шагов)

### Шаг 1. Создать бота в business.max.ru

1. Откройте https://business.max.ru/self
2. Войдите по номеру телефона, подтвердите код из SMS
3. Пройдите верификацию ИП/ООО через Госуслуги или банк-ID
4. В разделе «Чат-боты» нажмите «Создать»
5. Заполните карточку бота:
   - **Имя:** отображаемое, например «Заявки сайта»
   - **Никнейм:** латиница/цифры/подчёркивания, минимум 11 символов, заканчивается на `bot` или `_bot`. Пример: `my_clinic_orders_bot`
   - **Логотип, сайт, описание, телефон** — обязательные поля для модерации
6. Отправьте на модерацию

### Шаг 2. Скопировать токен

После одобрения (до 48 часов):

1. Откройте бота → вкладка «Интеграция»
2. Нажмите «Получить токен» / «Сгенерировать токен»
3. Скопируйте токен — это секретный ключ от вашего бота, **никому не показывайте**

Если токен потерян — перегенерируйте в той же вкладке.

### Шаг 3. Разрешить бота в чатах

В настройках бота на business.max.ru включите тумблер **«Может быть добавлен в чаты»** и сохраните. Без этой настройки MAX не позволит добавить бота в группу.

### Шаг 4. Создать группу в MAX и добавить бота

1. Установите MAX: https://max.ru/, https://web.max.ru/ или https://download.max.ru/
2. Войдите под своим аккаунтом
3. «+» в правом верхнем углу → «Создать группу»
4. Назовите, например, «Заявки с сайта»
5. **Добавьте бота:**
   - Откройте группу → «Участники» → «Добавить»
   - **Важно:** поиск по никнейму может не находить бота. Используйте полный ID вида `id026413939276_bot` (получите его в карточке бота на business.max.ru)
6. При необходимости назначьте бота администратором (если не пишет в группу)

### Шаг 5. Установить плагин и подключить чат

1. WordPress-админка → «Плагины» → «Добавить» → найдите «NotifyKit»
2. Установите NotifyKit и Contact Form 7 (зависимость)
3. Активируйте оба
4. Откройте «Настройки → NotifyKit»
5. Вставьте токен из шага 2 → сохраните
6. Нажмите «Получить список чатов» — плагин подтянет все чаты, в которых состоит бот
7. Выберите нужный чат → сохраните
8. Нажмите «Отправить тест» — в чате должно появиться демо-сообщение

---

## Сравнение с альтернативами

| Решение | NotifyKit | Telegram-боты для CF7 | SMTP-плагины |
|---|---|---|---|
| Работает в РФ без VPN | ✅ | ⚠️ нестабильно | ✅ |
| Уведомления в общий чат | ✅ | ✅ | ❌ только email |
| Реакция в реальном времени | ✅ | ✅ | ⚠️ зависит от почты |
| Цена | Бесплатно | Бесплатно/платно | Часто платно |
| Open-source (GPL) | ✅ | По-разному | По-разному |

---

## Часто задаваемые вопросы

**Q: Это правда бесплатно?**
A: Да, GPL-2.0, навсегда. Никакой Pro-версии, регистрации и рекламы внутри плагина.

**Q: Нужен ли VPN?**
A: Нет. MAX — российский мессенджер, работает в РФ напрямую без прокси.

**Q: Что если бота не одобрят в business.max.ru?**
A: Без одобренного бизнес-бота групповые чаты команды недоступны. Физлицам и самозанятым создание ботов в MAX пока недоступно — это ограничение MAX, не плагина.

**Q: Можно ли подключить разные формы CF7 к разным чатам?**
A: Да. Для каждой формы в редакторе CF7 есть вкладка «MAX-мессенджер» с индивидуальным `chat_id` и шаблоном.

**Q: Где хранится токен?**
A: Шифрован в БД WordPress (AES-256-GCM). Альтернатива — задать константой `CF7_MAX_TOKEN` в `wp-config.php`.

**Q: Поддерживает ли WooCommerce / WPForms?**
A: Пока только Contact Form 7. WooCommerce-заказы — главная фича следующего релиза. WPForms и Gravity Forms — в планах.

**Q: Что если API MAX недоступен?**
A: Ошибка пишется в журнал плагина, но email-уведомления Contact Form 7 продолжают отправляться (плагин работает поверх CF7 без вмешательства в его основной поток).

**Q: Работает ли с мультисайтом?**
A: Да, активируется на каждом подсайте отдельно.

---

## Roadmap (что в разработке)

1. **WooCommerce-заказы** (следующий релиз) — уведомления о новых заказах: сумма, состав, статус оплаты
2. **WPForms** (в планах) — поддержка популярного конструктора форм
3. **Gravity Forms** (в планах) — для агентств и крупных проектов
4. **Forminator, Fluent Forms** (рассматриваем) — по запросам пользователей
5. **Шаблоны с условной логикой** (идея) — условные блоки в шаблоне сообщения
6. **Отзывы товаров WooCommerce** (в планах) — новые отзывы покупателей в чат маркетинга

---

## Технические детали

### Структура файлов плагина

```
notifykit-for-max-cf7/
├── cf7-max.php                          # Главный файл плагина (header, bootstrap)
├── readme.txt                           # WordPress.org readme
├── uninstall.php                        # Очистка при удалении
├── admin/
│   ├── class-cf7-max-admin.php          # Главный класс админки
│   ├── class-cf7-max-form-tab.php       # Вкладка «MAX-мессенджер» в редакторе CF7
│   └── views/
│       ├── page.php                     # Layout страницы настроек
│       ├── tab-settings.php             # Глобальные настройки + список чатов
│       ├── tab-help.php                 # Встроенная инструкция
│       └── tab-logs.php                 # Журнал отправок
├── includes/
│   ├── class-cf7-max-options.php        # Работа с wp_options
│   ├── class-cf7-max-crypto.php         # AES-256-GCM шифрование токена
│   ├── class-cf7-max-api-client.php     # HTTP-клиент к MAX Bot API
│   ├── class-cf7-max-cf7-handler.php    # Хук на отправку формы CF7
│   ├── class-cf7-max-message-builder.php # Парсинг шаблона в текст для MAX
│   ├── class-cf7-max-logger.php         # Запись в журнал
│   └── class-cf7-max-installer.php      # Активация/деактивация
├── languages/
│   ├── notifykit-for-max-cf7.pot        # Шаблон переводов
│   └── notifykit-for-max-cf7-ru_RU.po   # Русский перевод
└── assets/
    ├── css/                             # Стили админки плагина
    └── js/                              # Скрипты админки плагина
```

### MAX Bot API

- Базовый URL: `https://botapi.max.ru`
- Авторизация: `?access_token=<TOKEN>` в query string
- Метод отправки: `POST /messages?chat_id=<ID>&text=<TEXT>`
- Поддерживаемые форматы: `html` (с тегами `<b>`, `<i>`, `<u>`, `<s>`, `<a>`, `<code>`, `<pre>`) и `plain`
- Получение списка чатов: `GET /chats?access_token=<TOKEN>`
- Документация: https://dev.max.ru/docs/chatbots/

---

## Полезные ссылки

### Сам плагин
- Промо: https://notifykit.grast.tech/
- WordPress.org: https://wordpress.org/plugins/notifykit-for-max-cf7/
- Поддержка: info@grast.tech

### Платформа MAX
- Личный кабинет партнёра: https://business.max.ru/self
- Раздел чат-ботов: https://business.max.ru/self/chat-bots
- Документация Bot API: https://dev.max.ru/docs/chatbots/
- Создание бота (гайд MAX): https://dev.max.ru/docs/chatbots/bots-create
- Получение токена: https://dev.max.ru/docs/chatbots/bots-coding/prepare
- Справка о ботах: https://help.max.ru/help/bots
- Загрузка мессенджера: https://max.ru/, https://web.max.ru/, https://download.max.ru/

### Зависимости и среда
- WordPress: https://wordpress.org/
- Contact Form 7: https://wordpress.org/plugins/contact-form-7/