Интеграция Marquiz и MAX

В чат MAX приходит текстовое сообщение: заголовок «Заявка с сайта», форма, имя, телефон, почта, остальные поля, комментарий и страница.

Запрос в MAX: POST https://botapi.max.ru/messages.

{
  "contacts": {
    "name": "Вера Степанова",
    "phone": "+7 977 504-39-16",
    "email": "stepanova.v@example.ru"
  },
  "answers": [
    {
      "q": "Что нужно",
      "a": "Расчёт стоимости"
    }
  ],
  "quiz": {
    "name": "Обратная связь"
  }
}

1. Доступ в MAX

   Токен бота MAX и chat_id чата.

   • В MAX найдите @MasterBot, создайте бота и скопируйте токен
   • Добавьте бота в нужный чат или напишите ему в личку
   • Для личного диалога chat_id — ваш id пользователя. Id группового чата показывает метод /chats API MAX
   • Несколько чатов перечислите через запятую

   Где взять токен бота и chat_id в MAX

2. Интеграция в кабинете

   В кабинете откройте «Connect» и подключите MAX. На вкладке «Настройка» в поле «Источник заявок» выберите «Marquiz» и нажмите «Скопировать». Там же заполните блок «Бот».

3. Отправка из Marquiz

   • Квиз → Интеграции → «Webhook» → адрес вебхука из кабинета.
   • Включите отправку и пройдите квиз для проверки.
   • Контакты попадают в Имя, Телефон и Почту, ответы квиза — в комментарий построчно.

   Контакты берутся из контактной формы квиза: имя, телефон и почта. Если посетитель до неё не дошёл, заявки не будет. Ответы приходят массивом. Мы складываем их в комментарий построчно и добавляем каждый вопрос отдельным полем. Имя поля равно тексту вопроса. После переименования вопроса поле придётся заново сопоставить в настройках интеграции. Служебные данные квиза приходят в extra: мы разворачиваем их в поля заявки.

4. Поля формы

   Каждый вопрос квиза доступен и как отдельное поле по его тексту.

   Менять ничего не нужно: имя, телефон, почту и комментарий Woove находит сам.

5. Проверка

   Пройдите квиз до конца и оставьте контакты. На вкладке «Заявки» у неё будет статус «Черновик» и то, что уйдёт в MAX. Затем выключите «Черновой режим» на вкладке «Настройка».

   Marquiz и Woove Connect: заявки с форм в CRM и мессенджеры