Внешний HTTP-запрос
Отправляет один HTTP-запрос во внешний сервис и возвращает код ответа, тело и заголовки для дальнейшей автоматизации.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую проблему решает
Робот полезен для интегратора, связывающего CRM с внешним сервисом по HTTP. Процессу нужен ответ сторонней системы, а сотрудник вручную переносит запрос и результат. Робот выполняет один запрос с заданным адресом, методом, заголовками и телом, возвращая ответ в процесс.
Что делает и когда применять
Робот полезен, когда в процессе нужно обратиться во внешний сервис: проверить данные, передать событие, получить ответ от API или связать CRM со сторонней системой.
Что делает робот: выполняет один HTTP-запрос по заданному URL с выбранным методом, заголовками, телом и таймаутом.
Что подготовить
Нужен установленный робот из приложения «CRM роботы 2.0 + AI», право настроить нужный процесс и доступный внешний сервис с известным вам контрактом. Передавайте только те данные, которые разрешено отправлять выбранному получателю.
Узнайте контракт внешнего сервиса: доступный URL, HTTP-метод, формат тела, авторизацию и смысл кодов ответа. Для первого примера используйте собственный учебный сервис; example.com в инструкции является примерным доменом, а не готовой интеграцией.
Как настроить и использовать
- Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «Внешний HTTP-запрос». В шаблоне бизнес-процесса добавьте одноимённое действие.
- Узнайте контракт внешнего сервиса: доступный URL, HTTP-метод, формат тела, авторизацию и смысл кодов ответа. Для первого примера используйте собственный учебный сервис; example.com в инструкции является примерным доменом, а не готовой интеграцией.
- Заполните URL, Метод, Заголовки (JSON), Тело запроса, Таймаут (сек). Для рабочего сценария подставьте значения полей документа или результаты предыдущих действий вместо учебных данных ниже.
- Проверьте обязательные поля и варианты выбора в таблице настроек. Сохраните действие и свяжите его результаты с дальнейшими условиями процесса.
- Выполните пробный запрос к собственному учебному сервису. Сначала проверьте HTTP-код, затем тело ответа и нужное вам бизнес-условие. Для запросов с побочным действием заранее предусмотрите защиту от повторов со стороны сервиса.
Параметры робота
Имена полей ниже совпадают с настройками действия. Значения из таблицы относятся к самому роботу; результаты предыдущих шагов выбирайте через подстановку значения в редакторе.
| Поле в настройках | Что передать | Обязательность и исходное значение |
|---|---|---|
URL (url) |
Формат: строка. | Обязательно. Значение по умолчанию в настройках не задано |
Метод (method) |
Формат: строка. | Необязательно. Значение по умолчанию в настройках не задано |
Заголовки (JSON) (headers) |
Формат: строка. | Необязательно. Значение по умолчанию в настройках не задано |
Тело запроса (body) |
Формат: строка. | Необязательно. Значение по умолчанию в настройках не задано |
Таймаут (сек) (timeout) |
Формат: строка. | Необязательно. Значение по умолчанию в настройках не задано |
Учебный пример
Пример показывает способ настройки на вымышленных данных и ожидаемый смысл результата; это не отчёт о запуске на вашем портале.
- URL (
url):https://example.com/integration/check. - Метод (
method):POST. - Заголовки (JSON) (
headers):{"Content-Type":"application/json"}. - Тело запроса (
body):{"order":"demo-501"}. - Таймаут (сек) (
timeout):15.
Заголовки (JSON) (headers)
Копируйте в это поле только содержимое блока, без названия поля и внешней обёртки со всеми настройками. Здесь нужен JSON-объект в фигурных скобках. Пустой объект {} и массив [] имеют разный тип. Ключ объекта является названием HTTP-заголовка, значение строкой. Content-Type в примере объявляет JSON-тело; требуемые вашим сервисом заголовки добавляйте по его документации. Реальные ключи доступа подставляйте из защищённых настроек и не публикуйте в примерах.
{
"Content-Type": "application/json"
}
Если ваш учебный сервис принимает такой запрос и возвращает HTTP 200 с текстом статуса, соответствующие код и тело появятся в результатах. Робот не знает бизнес-смысл ответа: успешный HTTP-код может сопровождаться отказом внутри тела.
Какие данные возвращает и что делать дальше
| Результат | Какое значение получает следующий шаг |
|---|---|
Код ответа (status_code) |
строка |
Тело ответа (response_body) |
строка |
Заголовки ответа (JSON) (response_headers) |
строка |
Проверяйте «Код ответа» и содержимое «Тело ответа» до следующего действия. Перед повтором запроса, который создаёт внешний объект, сверяйте результат в сервисе или используйте предусмотренную им защиту повторов.
Ошибки и ограничения
Код HTTP отражает ответ внешнего сервиса, а не автоматически результат вашей бизнес-операции. Проверяйте тело ответа по правилам этого сервиса. При ошибке авторизации уточните доступ; при превышении ожидания сначала сверьте, не выполнилась ли операция на стороне получателя. Заголовки и тело могут содержать закрытые данные, поэтому не переносите их без проверки в публичные комментарии.