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

В INTRUM одним запросом появляется контакт и прикреплённая к нему заявка.

Из настройки интеграции: apikey, params[customer][phone][0][comment], params[customer][email][0][comment], params[request][request_type], params[request][request_name], params[request][status].

Запрос в INTRUM: POST https://mycompany.intrumnet.com/sharedapi/applications/addCustomer.

{
  "answer": {
    "data": {
      "answer_short_text_58101": {
        "value": "Максим Фёдоров",
        "question": {
          "label": {
            "ru": "Имя"
          }
        }
      },
      "answer_short_text_58102": {
        "value": "+7 918 507-33-41",
        "question": {
          "label": {
            "ru": "Телефон"
          }
        }
      },
      "answer_short_text_58103": {
        "value": "fedorov.m@example.ru",
        "question": {
          "label": {
            "ru": "Почта"
          }
        }
      },
      "answer_long_text_58104": {
        "value": "Бюджет до 9 млн ₽",
        "question": {
          "label": {
            "ru": "Комментарий"
          }
        }
      }
    }
  }
}

1. Доступ в INTRUM

   Ключ API INTRUM из админпанели CRM и номер типа заявки.

   • Админпанель INTRUM → раздел API: там ключ активируется и копируется
   • Ключ ровно 32 символа; у пользователя, которому он выдан, должны быть права на добавление контактов и заявок
   • Номер типа заявки нужен обязательно: нажмите «Проверить ключ» на вкладке «Настройка», и мы покажем до шести типов с номерами
   • Адрес CRM — это поддомен вида mycompany; если у вас свой домен, впишите его целиком
   • По умолчанию соединяемся по https. Документация INTRUM описывает http и порт 81 — он оставлен запасным вариантом на случай, если у вас старая установка

   Где взять доступ к INTRUM

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

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

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

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

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

4. Поля формы

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

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

5. Проверка

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

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