YClients → Создание клиента в maxma.com

Настройка получения данных из YClients
 

Шаг 1. Выбор источника данных

Выберите пункт HTTP-Запрос (Webhook) и нажмите на кнопку "Добавить"

Не изменяя параметров, нажмите кнопку "Сохранить"

Скопируйте ссылку.

Шаг 2. Отправка заявок из YClients

Перейдите в настройки и выберите пункт "Вебхук" в блоке "Системные настройки"
Укажите адрес webhook, скопированный на шаге 1, в поле "Отправить по адресу",  выберите отправку нужных заявок и нажмите "Добавить"

Шаг 3. Настройка JSON парсера данных

Нажмите на кнопку "Добавить" в разделе "Действия" 

Выберите пункт меню "Парсер"

Добавьте в настройки поле "HTTP-запрос[Тело]" и добавьте все необходимые поля с данными в формате "JSON", приходящие из YClients

Дополнительные поля:

data_staff_name - ["data"]["staff"]["name"]

data_client_card - ["data"]["client"]["card"]

data_client_success_visits_count - ["data"]["client"]["success_visits_count"]

data_client_fail_visits_count - ["data"]["client"]["fail_visits_count"]

data_client_discount - ["data"]["client"]["discount"]

data_clients_count - ["data"]["clients_count"]

data_date - ["data"]["date"]

data_comment - ["data"]["comment"]

data_services_title_1 - ["data"]["services"][0]["title"]

data_services_title_2 - ["data"]["services"][1]["title"]

data_services_title_3 - ["data"]["services"][2]["title"]

data_services_title_4 - ["data"]["services"][3]["title"]

data_services_title_5 - ["data"]["services"][4]["title"]

data_services_cost_1 - ["data"]["services"][0]["cost"]

data_services_cost_2 - ["data"]["services"][1]["cost"]

data_services_cost_3 - ["data"]["services"][2]["cost"]

data_services_cost_4 - ["data"]["services"][3]["cost"]

data_services_cost_5 - ["data"]["services"][4]["cost"]

data_custom_fields_roistat - ["data"]["custom_fields"]["roistat"]

status - ["status"]

Нажмите на кнопку "Сохранить".

На этом настройка получения данных о поступивших заявках из YClients закончена.
Заявки, для которых вы настроили отправку, будут поступать в обработку.
Далее можно настроить действия по отправке этих данных в amoCRM, Bitrix24, Telegram и др.

Отправка заявки в maxma.com

Шаг 1. Добавьте действие "HTTP-запрос"

Выберите действие "HTTP-запрос"

Заполните параметры формы. Пример на изображении ниже.

Адрес: https://api.maxma.com/new-client

Тело: 

{
   "client":{
      "phoneNumber":"номер телефона",
      "email":"почта",
      "fullName":"ФИО",
      "gender":1,
      "card":"2222000257862"
   }
}

 

Список основных полей, которые можно передать в сервис Maxma:

phoneNumber - номер телефона

fullName - Фамилия, имя и отчество одной строкой

card - Штрих-код карты

gender - Пол  Значения       
          - 0 — пол неизвестен,
          - 1 — мужской,
          - 2 — женский

 

Полный список полей можно найти в документации maxma по ссылке: https://docs.maxma.com/api/#tag/Rabota-s-klientskoj-bazoj/paths/~1new-client/post

Заголовки:
X-Processing-Key: секретный ключ для подключения к API (выдается менеджером MAXMA)
Content-Type: application/json
Accept: application/json

Нажмите на кнопку "Сохранить".
На этом настройка действия закончена.

 

После выполнения действия отправки данных, сервис Maxma присылает ответы.

При успешном создании клиента:

{
   "client":{
      "phoneNumber":"+779******",
      "card":222********891,
      "cardString":"222********891",
      "name":"Max",
      "fullName":"Max",
      "gender":1,
      "email":"ds*********.ru",
      "level":1,
      "isEmailSubscribed":true,
      "isPhoneSubscribed":true,
      "bonuses":0,
      "pendingBonuses":0
   },
   "bonuses":[      
   ]
}

 

Также может сообщать об ошибках:

{"errorCode":25,"description":"Карта уже привязана к другому клиенту"}

 

В интерфейсе Maxma в разделе maxma.com/#/app/clients отобразится новый клиент, созданный после запроса. Пример на скрине ниже: