View Categories

Proxy Action

3 min read

В OnePlatform есть возможность передавать заявки через Proxy Actions (настройки, отправляющей данные из формы, заполненной клиентом, на указанный адрес в том виде, в котором эти данные были получены).

Например, заявка с формы «Обратный звонок»  отправится POST-запросом, который в теле содержит следующий json с данными из формы:

{
  "method": "POST",
  "path": "/",
  "query": {},
  "headers": {
    "x-forwarded-for": "5.8.78.125",
    "x-forwarded-proto": "https", 
    "x-forwarded-port": "443",
    "host": "19cb27a3c20b37f5f1c78a41a503e877.m.pipedream.net",
    "x-amzn-trace-id": "Root=1-5f7b0527-28692a1a0d3d17cb17ff35cf",
    "content-length": "1105",
    "x-kdx-token": "",
    "content-type": "application/json",
    "accept-encoding": "gzip",
    "user-agent": "Go-http-client/2.0"
  },
  "bodyRaw": "{
  \"data\":{
     \"id\":\"\",
     \"type\":\"proxy_action\",
      \"attributes\": {
          \"request_type\":1,
          \"site_id\":\"5db2db90c9d34e00017bc9e0\",
          \"tag\":\"\",
          \"fields\": {
              \"analytics_google_client_id\":\"GA1.2.191789383.1598458337\",
              \"analytics_kodix_pixel\":\"2020-08-26T15:34:46Z.193487784\",
              \"analytics_page_id\":\"5f7b045e09c56a0001f6314e\",
              \"analytics_page_title\":\"Страница формы обратной связи\",
              \"analytics_page_url\":
              \"/call_back_request/\",
              \"analytics_page_utm_all\":\"\",
              \"analytics_page_utm_campaign\":\"\",
              \"analytics_page_utm_content\":\"\",
              \"analytics_page_utm_medium\":\"\",
              \"analytics_page_utm_source\":\"\",
              \"analytics_page_utm_term\":\"\",
              \"communication\":\"Да\",
              \"dealer_id\":\"5d973d2c4091c500014615ac\",
              \"dealer_name\":\"Название дилера\",
              \"department_id\":\"\",
              \"email\":\"test@ya.ru\",
              \"gender\":\"М\",\"importer_code\":\"10371\",
              \"last_name\":\"Фамилия\",
              \"name\":\"Имя\",
              \"phone\":\"+7 (999) 999-99-99\",
              \"processing_of_personal_data\":\"Да\",
              \"request_id\":\"5f7b0526b871ee0001cda38a\",
              \"subject\":\"Продажи\",
              \"text\":\"Прошу поблагодарить продавцов за качественный сервис!\",
              \"text_input\":\"Москва\"}}}}",
  "body": {
    "data": {
      "id": "", //уникальный идентификатор proxy action. По-умолчанию, поле пустое. Значение идентификатора задается
                //при неудачной попытке отправить Proxy Action и записи его в базу.
      "type": "proxy_action", //обязательное поле, приходит всегда с значение "proxy_action"
      "attributes": {
        "request_type": 1, //уникальный идентификатор типа запроса. 1 - форма обратной связи.
        "site_id": "5db2db90c9d34e00017bc9e0", //уникальный ID сайта
        "tag": "", //тэг этажа формы
        "fields": {
          "analytics_google_client_id": "GA1.2.191789383.1598458337",
          "analytics_kodix_pixel": "2020-08-26T15:34:46Z.193487784",
          "analytics_page_id": "5f7b045e09c56a0001f6314e",
          "analytics_page_title": "Страница формы обратной связи",
          "analytics_page_url": "/call_back_request/",
          "analytics_page_utm_all": "",
          "analytics_page_utm_campaign": "",
          "analytics_page_utm_content": "",
          "analytics_page_utm_medium": "",
          "analytics_page_utm_source": "",
          "analytics_page_utm_term": "",
          "communication": "Да",
          "dealer_id": "5d973d2c4091c500014615ac",
          "dealer_name": "Название дилера",
          "department_id": "",
          "email": "test@ya.ru",
          "gender": "М",
          "importer_code": "10371",
          "last_name": "Фамилия",
          "name": "Имя",
          "phone": "+7 (999) 999-99-99",
          "processing_of_personal_data": "Да",
          "request_id": "5f7b0526b871ee0001cda38a",
          "subject": "Продажи",
          "text": "Прошу поблагодарить продавцов за качественный сервис!",
          "text_input": "Москва"
        }
      }
    }
  }
}

Для того, чтобы данные приходили, необходимо в заявках > Proxy Actions заполнить поля:

  • Название — отображаемое имя Proxy Action;
  • URL Адрес — путь, по которому передаваемые данные смогут быть обработаны, какой-то сервер, который сможет принять и работать с POST-запросом и уже из него передавать данные куда вам необходимо. Сервер должен быть доступен из вне, указываем именно url, по которому сервер доступен, готов принять и обработать запрос;
  • Токен — при необходимости авторизации при получении данных.

Если с вашей стороны нет возможности настроить обработку запросов в присылаемом нами виде, вы можете воспользоваться сторонним сервисом, для передачи заявок, например, Albato (обращаем внимание, что сервис платный, с тарифами вы можете ознакомиться на их сайте), чтобы преобразовывать запрос в допустимый для вашей системы вид.

После того, как вы настроили Proxy Action, вам необходимо зайти в: заявки > настройки > «Добавить» и совместить тип заявки, для которой настроен Proxy Action с «Доступным действием»: