Интеграция Яндекс Форм и ВКонтакте

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

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

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

{
  "answer": {
    "data": {
      "answer_short_text_58101": {
        "value": "Степан Горелов",
        "question": {
          "label": {
            "ru": "Имя"
          }
        }
      },
      "answer_short_text_58102": {
        "value": "+7 915 263-78-40",
        "question": {
          "label": {
            "ru": "Телефон"
          }
        }
      },
      "answer_short_text_58103": {
        "value": "gorelov.s@example.ru",
        "question": {
          "label": {
            "ru": "Почта"
          }
        }
      },
      "answer_long_text_58104": {
        "value": "Перезвоните после 18:00",
        "question": {
          "label": {
            "ru": "Комментарий"
          }
        }
      }
    }
  }
}

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

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

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

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

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

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

3. Отправка из Яндекс Форм

   • Откройте форму → Интеграции → «Отправить в вебхук» (или «HTTP-запрос»).
   • Адрес вебхука из кабинета, метод POST, тело — JSON с ответами.
   • Заполните форму для проверки: ответы придут по подписям вопросов.

   Яндекс Формы присылают ответы объектом: у каждого вопроса есть идентификатор, подпись и значение. Именем поля становится подпись вопроса. Если у вопроса задан короткий идентификатор, поле придёт и под ним, и под подписью. Ответы с несколькими вариантами склеиваются в одну строку через запятую. Одинаковые подписи у разных вопросов перезаписывают друг друга. Дайте вопросам разные подписи.

4. Поля формы

   Назовите вопросы «Имя», «Телефон», «Почта», тогда сопоставление не понадобится.

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

5. Проверка

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

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