Яндекс.Формы → Создание клиента в maxma.com

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

Список Шагов:
Шаг 1. Добавления источника

Шаг 2. Настройка отправки данных из Яндекс.Формы

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

Шаг 1.  Добавления источника

 

Шаг 1.1 Нажмите на кнопку "Добавить".
Шаг 1.2 Выберите источник данных "HTTP-Запрос (Webhook)".

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

Шаг 1.4 Скопируйте ссылку.

 

Шаг 2. Настройка отправки данных из Яндекс.Формы
Настройте отправку заявок из Яндекс.Формы

Перейдите в Настроики вашего проекта в  Яндекс.Формы

1. Выберите созданую форму
2. Нажмите на вкладку "Интеграция"
3. Нажмите на кнопку "Добавить группу действий"
4. Выберите "API"
5. Выберите "Запрос заданным методом"
6. Укажите ваш адрес webhook в поле"URL" из Шага 1.4
7. Выберите метод "POST"
8. Тело запроса Добавьте параметры(Данные) которые нужно получать
9. Добавить заголовок Content-Type: application/x-www-form-urlencoded
10. Сохранить

Шаг 3. Отправка тестового лида из Яндекс.Формы
Отправьте Тестовый лид из Яндекс.Формы
Т.е. заполните вашу яндекс форму.
после того как отправите тестовый лид зайдите в обработку:

1. в блоке "1.Источник данных".
2. Нажмите на кнопку "Изменить".
3. Нажмите на кнопку "Получить" после этого появятся параметры.
4. Нажмите на кнопку "Сохранить".

На скринах ниже показано как это сделать.

 

На этом настройка получения данных о поступивших заявках из Яндекс.Формы закончена.
Заявки для квиза, для которого вы настроили отправку, будут поступать в обработку.
Далее можно настроить действия по отправке этих данных в 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 отобразится новый клиент, созданный после запроса. Пример на скрине ниже: