Интеграция Marquiz и 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.

{
  "contacts": {
    "name": "Максим Фёдоров",
    "phone": "+7 918 507-33-41",
    "email": "fedorov.m@example.ru"
  },
  "answers": [
    {
      "q": "Какой объект ищете",
      "a": "Двухкомнатная квартира"
    }
  ],
  "quiz": {
    "name": "Подбор квартиры"
  }
}

1. Доступ в INTRUM

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

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

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

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

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

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

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

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

4. Поля формы

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

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

5. Проверка

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

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