http-запрос

Интеграция HTTP-запрос позволяет отправлять произвольные HTTP-запросы на сторонние сервера. Это позволяет интегрировать Smartbot с вашим сайтом, CRM или интернет-магазином.

Чтобы настроить http-запрос, создадим соответствующий блок на экране сценария. Сделать это можно через правое дополнительное меню (раздел "интеграции"), или щелчком правой кнопкой мыши на свободном участке.

Новый блок появится на экране, и справа автоматически откроется его меню.

Меню блока

Если вы интегрируетесь с существующим сервисом, то всю необходимую информацию для настройки этого шага вы можете найти в официальной документации к API этого сервиса, либо свяжитесь с разработчиками вашего сайта.

Краткая справка по полям шага:

• Тип запроса (http-метод): GET/POST/...

• URL-адрес: страница (endpoint), к которой должен обратиться Smartbot, тут же можно указать query-параметры запроса, например: https://some.site/some_endpoint?key1=value1&key2=value2

• Тело запроса: полезная нагрузка, может быть задана в трёх разных форматах:

  • Форма: тело запроса представляет собой форму (список пар ключ-значение), запрос будет отправляться с заголовком Content-Type: application/x-www-form-urlencoded (если явно не задано другое значение этого заголовка)

  • JSON: тело запроса является JSON-документом. Запрос будет отправляться с заголовком

    Content-Type: application/json(если явно не задано другое значение этого заголовка)

  • Текст: данные отправляются as-is, никаких дополнительных заголовков не добавляется

• Заголовки: дополнительная информация, например, авторизационные данные: Authorization: Bearer [token]

Ниже, после настройки параметров запроса, задаются переменные, в которые будет сохранён ответ сервера:

• Тело ответа: данные, которые прислал сервер в ответ. Если Content-Type равенapplication/json, то типом этой переменной будет Словарь, иначе Строка

• Статус ответа: число, например 200, 400 или 500 вы можете проверять статус ответа, чтобы узнать завершился ли запрос успешно

• Заголовки ответа: сервер также может прислать какую-то дополнительную информацию в виде заголовков, они сохранятся в переменную типа Словарь

По умолчанию все эти данные сохраняются во временные переменные: %body%, %status% и %headers% соответственно.