Вебхук (Weebhook)

Нода получает вебхуки от сервисов для запуска workflow.

Для чего нужна

• Принимать ответы из формы на сайте
• Получать события из других приложений. (Например: создан заказ)
• Использовать как «Мини-API»: получить данные — обработать — вернуть результат

Параметры

Webhook URLs

Есть две ссылки:

• Тестовая — нужна, чтобы быстро проверить, что всё приходит.
• Рабочая — включается, когда вы активировали сценарий.

Тип запроса. (HTTP Method)

Чаще всего используют GET или POST.
Пример: форма обычно шлёт POST.

Путь (Path)

Конец адреса, например /new-order.
Можно вставить переменные в путь: /users/:id. Тогда :id попадёт в данные запроса.

Аутентификация (Authentication)

Можно оставить «Без защиты», а можно потребовать логин/пароль или специальный заголовок/токен.
Это нужно, чтобы посторонние не стучались вебхук.

Как отвечать на запрос (Respond)

Когда отправлять ответ:

1. Сразу — вернуть «Ок, сценарий запущен».
2. После завершения — дождаться конца сценария и отдать его результат.
3. Отдельной нодой “Respond to Webhook” — полный контроль над ответом (текст, коды, заголовки).
4. Потоком (Streaming) — отдавать ответ по кусочкам во время работы.

Дополнительные настройки

Allowed Origins (CORS)

Кому с сайтов можно обращаться к вашему вебхуку из браузера.

Binary Property (Принять файл)

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

Ignore Bots (Игнорировать ботов)

Защита от «предпросмотров» и роботов, которые просто проверяют ссылку.

IP Whitelist (Список разрешённых IP)

IP-адреса, которым можно обращаться.

Raw Body (Сырое тело запроса)

Принять данные «как есть» (например, чистый JSON или XML), не разбирая форму.

Response Content-Type (Тип ответа)

Подсказка для клиента, что отправляется: текст, JSON и т. п.

Response Headers (Заголовки ответа)

Дополнительные параметры ответа.

Property Name (Имя поля)

Если нужно вернуть только одно поле из результата.

No Response Body (Без тела ответа)

Вернуть только код 200, без текста

Response Code (Код ответа)

Код ответа сервера

Response Data (Что вернуть)

Если выбрали «После завершения», можно выбрать:
— вернуть весь массив данных;
— вернуть только первый элемент как JSON;
— вернуть файл;
— вернуть пустой ответ.

Настройки ноды

Allow Multiple HTTP Methods

Можно разрешить сразу несколько методов (например, и GET, и POST) для одного вебхука.