Подробная инструкция для подключения Яндекс Форм к MAX-боту

Коротко

Эта инструкция проведёт вас через создание бота в экосистеме MAX, получение API-токена и настройку для приёма данных из Яндекс.Форм. После настройки ответы на форму будут приходить в чат с ботом в мессенджере MAX.

Важно: Если вы не планируете использовать свой бот, то переходите сразу к Шаг 3 — Регистрация бота в сервисе

Шаг 1 — Создание бота в MAX

1. Перейдите на платформу партнеров Max: https://business.max.ru/. (👉Инструкция по регистрации на платформе)
2. Авторизуйтесь через ВКонтакте или номер телефона.
3. В разделе «Чат-боты» нажмите «Создать бота».
4. Заполните данные: Название — имя бота в чате (например, FormNotifier);
   Описание — кратко, для чего бот;
   Аватар — логотип (опционально).
5. После создания бот отправится на модерацию.

Ник бота формируется автоматически: id{ИНН}_bot. Изменить его после создания нельзя.

Шаг 2 — Получение API-токена

1. После одобрения бота перейдите в раздел «Чат-боты» → «Интеграция».
2. Нажмите кнопку «Получить токен».
3. Скопируйте выданный токен вида:
   AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw

🔐 Безопасность: Токен — это ключ доступа к вашему боту. Не публикуйте его в открытом коде, не передавайте третьим лицам и регулярно обновляйте при подозрении на утечку.

Шаг 3 — Регистрация бота в сервисе

1. Откройте наш cайт авторизуйтесь через MAX - бот автоматически начнет работу.
2. В боте: Нажмите "Свой бот" и напишите API токен бота. Или нажмите "Этот бот", если вы не планируете использовать свой бот.
3. После успешной регистрации вы получите уникальную ссылку для API Яндекс.Форм, например:
   https://raadigital.ru/yf/max/123abcAbC. Скопируйте её — она понадобится на шаге интеграции в Яндекс.Формах.

Шаг 4 — Создание Яндекс.Формы

1. Откройте Яндекс Формы и создайте новую форму.
2. Добавьте нужные вопросы (текстовые поля, варианты ответов и т. п.).
3. Проверьте корректность названий вопросов — они будут приходить в уведомления.

Шаг 5 — Подключение формы к Max-боту (API)

1. Перейдите в вашу форму → вкладка Интеграции.
2. Прокрутите вниз до раздела API и выберите опцию Запрос JSON-RPC POST.
3. В поле URL вставьте ранее скопированную ссылку с сайта регистрации бота (например, https://raadigital.ru/yf/max/12Abc678).
4. Метод: POST.
5. Добавьте параметры — нажмите + Добавить параметр:Левое поле — название параметра, например: Ответы.
   В правом поле нажмите + и выберите опцию Ответы на вопросы
   !!! Будьте внимательны - НЕ "Ответы на вопросы в виде JSON".
6. Настройте параметры выбора вопросов: выберите нужные вопросы или нажмите Выбрать все.
7. Оставьте поле Фильтры пустым (если нет специальных условий).
8. В поле Форматирование ответа выберите JSON.
9. Нажмите Сохранить, затем Сохранить в самой форме добавления API.

Если интерфейс Яндекс.Форм изменился — ищите опции с похожими названиями: «Интеграции», «API», «JSON», «POST».

Шаг 6 — Проверка работы

1. Поделитесь формой с друзьями или заполните её самостоятельно.
2. После отправки формы проверьте Telegram — должен прийти уведомительный текст с выбранными вопросами и ответами.
3. Если уведомление не пришло:Проверьте токен бота (правильный ли он).
   Проверьте, нажали ли вы Старт в чате с ботом (обязательно для получения сообщений).
   Убедитесь, что URL, вставленный в Яндекс Формы, точен (копируйте ссылку вместо ручного набора).
   

Дополнительные советы

• Проверка токена: Ошибка в токене приведёт к сбою. Проверьте, что токен скопирован целиком.
• Тестирование: Перед публикацией протестируйте форму и убедитесь, что данные приходят корректно и читабельно.
• Несколько форм: Можно подключать несколько форм к одному боту — чаще всего используют одну и ту же ссылку/интеграцию.
• Формат сообщений: Если нужно более сложное форматирование (например, кнопки, клавиатуры, разбор JSON), можете обратиться к нашей компании - мы разработаем для вас индивидуальную интеграцию.

Итог

Теперь у вас есть всё, чтобы настроить мгновенные уведомления из Яндекс.Форм в Max без разработки собственного сервера: создайте бота, зарегистрируйте его в боте для интеграции, подключите JSON-RPC POST в Яндекс.Формах — и проверяйте ответы в Max.

Нужна помощь с кодом или настройкой? Напишите мне в MAX — помогу оптимизировать под ваши задачи. ☕