Как мгновенно получать ответы из Яндекс.Форм в бота MAX Messenger
Коротко
Эта инструкция проведёт вас через создание бота в экосистеме MAX, получение API-токена и настройку
вебхука для приёма данных из Яндекс.Форм. После настройки ответы на форму будут приходить в чат с
ботом в мессенджере MAX.
Важно: Если вы не планируете использовать свой бот, то переходите сразу к пункту 3
Шаг 1 — Создание бота в MAX
- Перейдите на платформу партнеров Max: https://business.max.ru/. (👉Инструкция по регистрации на платформе)
- Авторизуйтесь через ВКонтакте или номер телефона.
- В разделе «Чат-боты» нажмите «Создать бота».
- Заполните данные:
- Название — имя бота в чате (например,
FormNotifier); - Описание — кратко, для чего бот;
- Аватар — логотип (опционально).
- Название — имя бота в чате (например,
- После создания бот отправится на модерацию.
Важно: Ник бота формируется автоматически:
id{ИНН}_bot. Изменить его после создания нельзя.Шаг 2 — Получение API-токена
- После одобрения бота перейдите в раздел «Чат-боты» → «Интеграция».
- Нажмите кнопку «Получить токен».
- Скопируйте выданный токен вида:
AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw
🔐 Безопасность: Токен — это ключ доступа к вашему боту. Не
публикуйте его в открытом коде, не передавайте третьим лицам и регулярно обновляйте при
подозрении на утечку.
Шаг 3 — Регистрация бота в сервисе
- Перейдите на страницу авторизации, нажмите на кнопку "Авторизоваться через MAX" далее вы перейдете в наш бот в мессенджере MAX
- Нажмите "Свой бот" и напишите API токен бота. Или нажмите "Этот бот", если вы не планируете использовать свой бот.
- После успешной регистрации вы получите уникальную ссылку для API Яндекс.Форм, например:
https://raadigital.ru/yf/max/123abcAbC. Скопируйте её — она понадобится на шаге интеграции в Яндекс.Формах.
Шаг 4 — Создание Яндекс.Формы
- Откройте Яндекс Формы и создайте новую форму.
- Добавьте нужные вопросы (текстовые поля, варианты ответов и т. п.).
- Проверьте корректность названий вопросов — они будут приходить в уведомления.
Шаг 5 — Подключение формы к Max-боту (API)
- Перейдите в вашу форму → вкладка Интеграции.
- Прокрутите вниз до раздела API и выберите опцию Запрос JSON-RPC POST.
- В поле URL вставьте ранее скопированную ссылку с сайта регистрации бота
(например,
https://raadigital.ru/yf/max/12Abc678). - Метод:
POST. - Добавьте параметры — нажмите + Добавить параметр:
- Левое поле — название параметра, например: Ответы.
- В правом поле нажмите + и выберите опцию Ответы на вопросы
!!! Будьте внимательны - НЕ "Ответы на вопросы в виде JSON". - Настройте параметры выбора вопросов: выберите нужные вопросы или нажмите Выбрать все.
- Оставьте поле Фильтры пустым (если нет специальных условий).
- В поле Форматирование ответа выберите JSON.
- Нажмите Сохранить, затем Сохранить в самой форме добавления API.
Если интерфейс Яндекс.Форм изменился — ищите
опции с
похожими названиями: «Интеграции», «API», «JSON», «POST».
Шаг 6 — Проверка работы
- Поделитесь формой с друзьями или заполните её самостоятельно.
- После отправки формы проверьте Telegram — должен прийти уведомительный текст с выбранными вопросами и ответами.
- Если уведомление не пришло:
- Проверьте токен бота (правильный ли он).
- Проверьте, нажали ли вы Старт в чате с ботом (обязательно для получения сообщений).
- Убедитесь, что URL, вставленный в Яндекс Формы, точен (копируйте ссылку вместо ручного набора).
Дополнительные советы
- Проверка токена: Ошибка в токене приведёт к сбою. Проверьте, что токен скопирован целиком.
- Тестирование: Перед публикацией протестируйте форму и убедитесь, что данные приходят корректно и читабельно.
- Несколько форм: Можно подключать несколько форм к одному боту — чаще всего используют одну и ту же ссылку/интеграцию.
- Формат сообщений: Если нужно более сложное форматирование (например, кнопки, клавиатуры, разбор JSON), можете обратиться к нашей компании - мы разработаем для вас индивидуальную интеграцию.
Итог
Теперь у вас есть всё, чтобы настроить мгновенные уведомления из Яндекс.Форм в Max без разработки
собственного сервера: создайте бота, зарегистрируйте его в боте для интеграции, подключите JSON-RPC
POST в
Яндекс.Формах — и проверяйте ответы в Max.