Интеграция Marquiz и ВКонтакте

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

Из настройки интеграции: access_token, v, peer_id, random_id.

Запрос во ВКонтакте: POST https://api.vk.com/method/messages.send.

{
  "contacts": {
    "name": "Степан Горелов",
    "phone": "+7 915 263-78-40",
    "email": "gorelov.s@example.ru"
  },
  "answers": [
    {
      "q": "Что нужно",
      "a": "Расчёт стоимости"
    }
  ],
  "quiz": {
    "name": "Обратная связь"
  }
}

1. Доступ в сообществе ВКонтакте

   Ключ доступа сообщества с правом «сообщения» и peer_id получателя.

   • Сообщество → Управление → Работа с API → Ключи доступа → «Создать ключ» с правом «сообщения сообщества»
   • В разделе «Сообщения» включите сообщения сообщества
   • Напишите сообществу от своего имени: иначе оно не сможет написать вам
   • peer_id — номер вашей страницы без «id». Для беседы сообщества это 2000000000 плюс номер беседы

   Где взять ключ сообщества ВКонтакте

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

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

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

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

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

4. Поля формы

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

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

5. Проверка

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

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