HTTP-запрос. Получение данных → Создание ученика (заявки)

Принимайте данные, отправленные http-запросом, откуда угодно

и на основе этих данных создавайте лиды и покупателей в ParaplanCRM

Создайте "Обработку"

Создайте "Обработку" в Webjack. В ней настраивается что/откуда получать и куда/как передавать.

Нажмите кнопку “Создать”,

дайте название для "Обработки" и нажмите "Cохранить"

Добавьте “Источник данных”

Добавьте “Источник данных”, нажмите кнопку “Добавить

Получение данных с помощью http-запросов

Посмотрите видео Произвольные http запросы в качестве входных данных

Вы можете указать в качестве источника данных произвольные HTTP-запросы.

Основные настройки http-запроса

В окне настройки можно указать метод запроса, который будет приниматься. Это может быть GET, POST и др. виды запросов.

Если вам не надо, делать никакого ответа, то на этом настройку входных данных HTTP-запросом можно считать законченой.
Нажмите кнопку "Сохранить" и перейдите к настройке действий обработки.

После нажания на кнопку "Сохранить" будет создан уникальный адрес, на который необходимо будет отправлять HTTP-запросы

Дополнительные настройки

Если вам необходимо, чтобы наш сервер на этот запрос дал какой-нибудь ответ, то тогда необходимо настроить "Параметры ответа".
Можно настроить все необходимые параметры, начиная от "Кода статуса ответа", "Текста статуса ответа" и заканчивая "Параметрами запроса" и "Заголовками запроса".

Важно: Некоторые сайты не позволяют отправлять запросы на любые сайты и требуют в заголовке ответа разрешение. Чтобы сообщить, что мы разрешаем отправлять на наш адрес запросы с любых адресов, необходимо добавить в поле "Загловки ответа" следующую строку:

Access-Control-Allow-Origin:*

Парсинг данных в формате JSON

Если в качестве тела запроса вам будет приходить JSON, то можно получить доступ отдельно к каждому параметру используя действие "JSON-парсер"

Данные, которые поступают в виде JSON, можно парсить.

Для этого необходимо добавить и заполнить "поля JSON":

  • Имя - это произвольное имя внутри обработки, в которое мы запишем данные, которые получим из JSON. Оно будет использовано в дальнейших действиях в обработке.
  • Путь - это путь до необходимого значения

Пример 1.
Предположим вам приходит JSON следующего содержания:

{
    "firstName": "Александр", 
    "phone": "+79090000001",
    "appealType": {
        "Code": "101",
        "Name": "Заказать звонок"
    },
    "appealText": "target_fb"
}

Чтобы получить все поля мы должны настроить JSON-парсер следующим образом:

Пример 2.
Если нам приходит JSON где есть массивы

 {
  "raw": [
    {
      "q": "ab6c5412-5c7f-489d-8d79-173ce632930e",
      "a": "3f0bb0ea-fc31-4b49-86b5-337ca0cf86da"
    },
    {
      "q": "d337ecb3-b903-4664-94c1-16acf2c2e3bb",
      "a": "f3d4933b-6af3-48a9-a836-0173bbbf6415"
    }
  ]
}

, то получить поле со вторым полем "q" можно следующим образом:

 ["raw"][1]["q"]

 

Для каждого из полей можно настроить варианты действий при отстутствии данных. Если в какое-то поле не будет найдено в JSON, то можно прервать выполнение обработки, либо записать туда пустое значение.

Для передачи данных в ParaplanCRM необходимо получить токены доступа. Получить токены доступа можно сделав запрос к серверу paraplancrm указав свой логин и пароль.

Получение токенов доступа

Для получения токенов доступа необходимо сделать запрос к paraplancrm. Для этого мы заранее подготовили коллекцию в postman, чтобы облегчить составление запроса. 

Шаг 1. Зарегистрируйтес в Postman.com

Postman это бесплатный сервис, в котором можно в ручном режиме выполнить нужный нам запрос.

Зарегистрируйтес в Postman.com используя любой удобный вам способ. Если вы уже имеете аккаунт в Postman, то войдите в него.

Только после этого можно переходить к следующему шагу.

Шаг 2. Подготовьте запрос. Для этого перейдите по ссылке https://www.postman.com/webjack-ru/workspace/webjack-public-collection/collection/11365683-88b7fd8c-9496-4c64-9c55-535eea1ae315

Нажмите на кнопку "Fork" чтобы создать копию этого запроса.

Нажмите на кнопку "Fork Collection"

После этого перейдите во вкладку "Variables" и заполните поля domenm username и password, как указано на рисунке

Где domen - это адрес вашей CRM, например it.startap.ru - тут не должно быть лишних символов в начале и в конце

username - имя пользователя, который имеет доступ в CRM

password - пароль пользователя, который имеет доступ в CRM

Шаг 3. Выполните запрос. Для этого выберите запрос "login" и нажмите кнопку "Send", как указано на рисунке

Теперь выберите опять пункт "paraplancrm.ru" и перейдите во вкладку "Variables".

Тут появятся два новых параметра "XSRF-TOKEN" и "JSESSIONID". Именно они нам и понадобятся в дальнейшем при настройке действий отправки в ParaplanCRM

Настройка действий по отправке в ParaplanCRM.ru

Шаг 1. Добавьте действие "Компановщик JSON"

Вставьте следующий текст в поле JSON:

 

{
  "assigneeId": "",
  "comment": "",
  "email": "",
  "name": "",
  "sex": "MALE",
  "phoneList": [
    {
      "main": true,
      "name": "",
      "phone": ""
    }
  ],
  "sourceId": "",
  "statusId": ""
}

 

В текст JSON вставьте нужные для отправки поля, как на рисунке

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

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

Настройте его следующим образом:

Адрес - https://paraplancrm.ru/api/open/leads

X-XSRF-TOKEN - укажите значение из Postman

JSESSIONID - укажите значение из Postman

Content-Type - application/json

Cookie - CRM_REMEMBER_ME={Значение из одноименного поля в Postman}; JSESSIONID={Значение из одноименного поля в Postman}; XSRF-TOKEN={Значение из одноименного поля в Postman}

 

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

 

Если все сделано правильно, то теперь поступающие заявки будут отправляться в ParaplanCRM.

Запустите обработку

Нажмите на кнопку "Запустить"

С этого момента данные будут обрабатываться.

Как все будет работать?

  1. В обработку будут поступать данные из настроенного вами "Источника данных"
  2. Поочередно будут выполняться все действия, которые вы настроили
  3. Все поступающие в обработку данные, а также статус и история их обработки будут отражаться в "Истории операций"

В случае возникновения каких-либо ошибок в процессе обработки, вы получите письмо-уведомление на email.

Если вы обнаружили ошибку или неточность в описании, либо что-то не понятно, напишите нам в чат на сайте. Мы внесем правки.