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

 

Настройка получения данных из u-on.ru

Ощая схема получения данных из U-ON следующая:

1. На наш вебхук приходит уведомление о событии произошедшем в U-ON (оно содержит какие-то данные, но далеко не все которые обычно требуются)

2. Из сообщения извлекаем идентификатор заявки или обращения.

3. Отправляем запрос в U-ON, чтобы получить полные сведения об обращении или заявке, по которой пришло уведомление

4. Парсим из ответа нужные поля

5. Настраиваем действие по отправке данных по назначению.

 

Шаг 1. Настроить прием данных от U-ON на вебхук.

Выберите источник данных "HTTP-Запрос (Webhook)".

Нажмите на кнопку "Добавить"

В список параметров добавьте 1 параметр (r_id), как указано на рисунке ниже

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

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

 

Шаг 2. Настройте отправку уведомлений в личном кабинете u-on.ru.

Перейдите в меню "Интеграция".  Выберите пункт "API / WebHooks"

Выбирите тип уведомления, который хотите отправлять на вебхук, например "Создание обращения". Вставьте скопированную ссылку в поле "URL", как указано на рисунке ниже.

В следующих действиях мы настроем получение дополнительных данных по обращению или заявке.

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

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

Адрес: 
https://api.u-on.ru/{api}/request/{r_id}.json - если вы хотите получить данные по заявке
либо
https://api.u-on.ru/{api}/lead/{r_id}.json - если вы хотите получить данные по заявке

Ключ api можно взять тут https://{id}.u-on.ru/api.php
{id} - ваш id в u-on.ru

В следующем шаге мы настроем получение самих данных по обращению либо заявке.

Шаг4. Создаем в обработке действие JSON-Парсер:

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

Добавьте в настройки поле  "HTTP-запрос[Содержимое ответа]" и добавьте все поля которые необходимы для получения данных.

id - ["request"][0]["id"]
dat_lead - ["request"][0]["dat_lead"]
dat - ["request"][0]["dat"]
dat_close - ["request"][0]["dat_close"]
status_id - ["request"][0]["status_id"]
status - ["request"][0]["status"]
office_id - ["request"][0]["office_id"]
office_name - ["request"][0]["office_name"]
travel_type_id - ["request"][0]["travel_type_id"]
travel_type - ["request"][0]["travel_type"]
manager_id - ["request"][0]["manager_id"]
manager_surname - ["request"][0]["manager_surname"]
manager_sname - ["request"][0]["manager_sname"]
manager_name - ["request"][0]["manager_name"]
source_id - ["request"][0]["source_id"]
source - ["request"][0]["source"]
Нажмите на кнопку "Сохранить".

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

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