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

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

Из настройки интеграции: appointments[0].id, appointments[0].services[0], appointments[0].staff_id, appointments[0].seance_length.

Запрос в YCLIENTS: POST https://api.yclients.com/api/v1/book_record/123456.

{
  "contacts": {
    "name": "Ольга Лебедева",
    "phone": "+7 903 511-26-40",
    "email": "olga.lebedeva@example.ru"
  },
  "answers": [
    {
      "q": "Какая услуга нужна",
      "a": "Стрижка и укладка"
    },
    {
      "q": "Удобная дата",
      "a": "12.10.2026"
    },
    {
      "q": "Удобное время",
      "a": "14:30"
    }
  ],
  "quiz": {
    "name": "Запись в салон"
  }
}

1. Доступ в YCLIENTS

   Партнёрский токен YCLIENTS и user-токен филиала.

   • Партнёрский токен выдаёт YCLIENTS по заявке на интеграцию — напишите в их поддержку
   • Пользовательский токен получается для конкретного филиала через метод авторизации API
   • Идентификатор филиала виден в адресе кабинета

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

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

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

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

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

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

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

   • вопрос «Удобная дата»
   • вопрос «Удобное время»

4. Поля формы

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

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

   • «Дата»: Удобная дата
   • «Время»: Удобное время

5. Проверка

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

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