Trigger on Webhook
Описание узла
Trigger on Webhook — триггер-узел, который служит точкой входа в сценарий. Запросы отправляются на URL узла Trigger on Webhook, инициируя выполнение сценария.
Настройка узла
После добавления узла Trigger on Webhook автоматически генерируются две версии его URL. Обе версии URL отображаются в поле Path:
- Production-версия доступна по нажатию на Production URL. Запросы на эту версию URL могут отправляться непрерывно, и выполнение сценария не прекратится, пока сценарий не будет остановлен вручную или не произойдёт критическая ошибка.
- Development-версия доступна по нажатию на Development URL. Отправка запроса на эту версию URL запускает сценарий один раз, после чего сценарий прекращает работу. Это полезно для тестирования и временной отладки сценария без длительного выполнения.
Сгенерированный URL можно либо частично изменить (1), либо скопировать (2) для последующего включения в запрос, отправляемый для запуска сценария.
Вы можете отправлять запросы на адрес узла Trigger on Webhook методом POST (если необходимо передать данные в узел) или методом GET (если требуется простой запуск узла).
Варианты ответа вебхука
На запрос вебхука платформа может отвечать тремя способами:
-
Ответ по умолчанию (
200 OK)
Если в сценарии не используется узел Webhook Response, платформа вернёт200 OK. -
Кастомный ответ через Webhook Response
Если вы добавите узел Webhook Response, вы сможете вернуть свой ответ — например, изменить тело, статус и заголовки. -
Мгновенный ответ (fast mode)
Если отправителю нужен ответ сразу (например, из‑за короткого таймаута), включите fast mode через параметры URL.
Fast mode
Fast mode — это режим, в котором вебхук отвечает сразу, не дожидаясь выполнения сценария. Он полезен, если отправитель ждёт ответ очень быстро и может разорвать соединение раньше.
__ln.fast=1 — fast mode
Параметр __ln.fast=1 включает быстрый режим: вебхук возвращает ответ сразу, не дожидаясь выполнения сценария. В этом режиме узел Webhook Response не используется для ответа вебхуку (он не сработает), потому что ответ уже отправлен сервису‑отправителю.
Важно
- В fast mode клиент, который отправляет запрос, может не увидеть ошибку сценария, например, если сценарий неактивен и т. д.
- Даже если вебхук не существует и для запроса с параметром
__ln.fast=1не найден, платформа всё равно вернёт200 OK.
Доступные параметры __ln.*
| Параметр | Что делает | Пример значения |
|---|---|---|
__ln.fast | Включает fast mode: Nodul отвечает сразу (до выполнения сценария). | __ln.fast=1 |
__ln.resp.body | Тело ответа для async случая (нет Webhook Response или включён __ln.fast=1). | __ln.resp.body=Hello%20World |
__ln.resp.status | HTTP‑статус ответа для async случая. | __ln.resp.status=201 |
__ln.resp.header.<header> | Заголовок ответа для async случая. | __ln.resp.header.content-type=application/json |
Пример полного URL
https://<your-webhook-url>?__ln.fast=1&__ln.resp.body=Hello%20World&__ln.resp.status=201&__ln.resp.header.content-type=application/json