YClients → HTTP-запрос. Отправка данных

Передавайте данные из YClients

формируйте произвольные http-запросы и отправляйте в любые системы, которые имеют свое api и принимают запросы. С их момощью можно создавать контакты, сделки, задачи, отправлять письма и т.д.

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

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

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

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

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

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

Настройка получения данных из 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 и др.

Интеграция с произвольными сервисами через API

Многие сервисы имеют свое API и могут принимать http-запросы. С помощью этих запросов можно создавать контакты, заявки, сделки, отправлять письма и т.д.

Набор возможностей определяется сервисом, в который вы собираетесь отправлять запрос.

У каждого сервиса, который имеет свое API и может принимать запросы есть документация. В этой документации подробно описывается каким образом надо формировать запрос, куда отправлять и т.д.

Сформируйте нужный вам http-запрос

С помощью этого действия можно сформировать практически любой http-запрос. Можно задать все необходимые параметры запроса, указать адреса, заголовки, тело запроса и т.д. Ниже мы разберем основные параметры и дополнительные действия, необходимые для этого.

Еще раз отметим, что все подробности указаны в документации того сервиса, куда вы хотите отправлять запрос.

Добавьте действие http-запрос

Параметры запроса

Заполните параметры запроса

Метод
Укажите метод отправки данных. Это может быть POST или GET запрос.

GET-запросы чаще всего используются для получения данных,

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

Адрес
Нужно указать адрес, на который будет отправляться запрос. Например, сервис Bizon365 принимает запросы по адресу https://online.bizon365.ru/api/v1/course/student/add

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

Тело
Чаще всего в теле запроса отправляют данные в формате "Form Urlencoded" или "JSON".

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

Успешные коды статуса:

Укажите коды статуса, при которых надо считать, что запрос выполнился успешно.

По умолчанию это "2**", т.е. все успешные коды

Параметры строки запроса
Перечислите все параметры, которые необходимо добавить в строку запроса. Это могут поля с данными, например, name/phone или другие необходимые параметры.

Заголовки
В заголовках часто передают служебную информацию: коды для авторизации, токены и т.д.

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

Если в теле запроса данные в формате "Form Urlencoded", то необходимо добавить заголовок:
Content-Type: application/x-www-form-urlencoded

Если в теле запроса "JSON", то необходимо добавить заголовок:
Content-Type: application/json

Сохраните действие.

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

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

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

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

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

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

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