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

В ApiShip создаётся заказ на доставку: получатель с именем, телефоном и почтой, город и адрес из полей формы.

Из настройки интеграции: order.clientNumber, order.providerKey, order.pickupType, order.deliveryType, order.tariffId, order.weight.

Запрос в ApiShip: POST https://api.dev.apiship.ru/v1/orders.

{
  "contacts": {
    "name": "Юлия Ковалёва",
    "phone": "+7 950 614-29-87",
    "email": "yu.kovaleva@example.ru"
  },
  "answers": [
    {
      "q": "Что заказываете",
      "a": "Настольная лампа"
    },
    {
      "q": "Город доставки",
      "a": "Екатеринбург"
    },
    {
      "q": "Адрес",
      "a": "ул. Малышева, 51, кв. 12"
    }
  ],
  "quiz": {
    "name": "Заказ с доставкой"
  }
}

1. Доступ в ApiShip

   Логин и пароль кабинета ApiShip, код службы и номер тарифа.

   • Зарегистрируйтесь на apiship.ru, аккаунт заводится сам
   • Логин и пароль от кабинета и есть доступ к API: токен мы получаем сами при каждой отправке
   • Код службы доставки берётся из списка перевозчиков в кабинете, например cdek или dpd
   • Номер тарифа даёт расчёт стоимости: сделайте его в кабинете и запишите tariffId нужного варианта
   • Для проб есть тестовый контур с отдельным адресом, заказы в нём не уходят перевозчику

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

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

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

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

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

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

   Для ApiShip добавьте в квиз:

   • вопрос «Город доставки»
   • вопрос «Адрес»

4. Поля формы

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

   На вкладке «Настройка» в блоке «Поля формы» впишите:

   • «Город»: Город доставки
   • «Адрес доставки»: Адрес

5. Проверка

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

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