Wait For Signal

logic_wait_signal · logic · Logic & Flow · Available · v1.0.0

Description

Pause the workflow until an external signal arrives (POST /signals/:name). Survives restarts — pause can last weeks. Perfect for approvals & long-running flows.

⚙️ Configuration parameters

Fields shown in the editor when configuring the node. Generated directly from the NodeDefconfigFields.

Field	Type	Required	Default	Description
`signalName` Nome del segnale	`string`	yes	— es. contract_signed, approval_received	Identificatore univoco. I caller esterni fanno POST a /api/v1/signals/<name> per risvegliare il workflow. Deve essere unico per tenant. Usa snake_case.
`timeoutSeconds` Timeout (secondi)	`number`	no	`2592000`	Tempo massimo di attesa. Dopo questo l'engine prosegue con "defaultPayload". 0 = aspetta per sempre. 2592000 = 30 giorni (default). Calcoli rapidi: 3600=1h · 86400=1g · 604800=1sett.
`defaultPayload` Payload di default (in caso di timeout)	`code`	no	`{"timeout": true}`	JSON inviato ai nodi a valle quando scatta il timeout invece del segnale. Usa per distinguere "timeout" da "signal reale" (es. {"timeout": true}).
`matchKey` Chiave di correlazione (opzionale)	`string`	no	— es. order_id, ticket_id	Quando più workflow attendono lo stesso signal contemporaneamente, il body del signal deve contenere questa chiave col valore = expression sotto. Pattern "BPMN message correlation".
`matchValue` Match value expression	`expression`	no	— input.order.id	Evaluated at pause time. Stored with the paused row; signal payload must match.

💡 Configuration example

JSON snippet of the node as it appears in the workflow. Values are derived fromdefaultValue and from required parameters.

{
  "id": "node-logic_wait_signal-1",
  "defId": "logic_wait_signal",
  "label": "Wait For Signal",
  "config": {
    "signalName": "es. contract_signed, approval_received",
    "timeoutSeconds": 2592000,
    "defaultPayload": "{\"timeout\": true}"
  }
}

🔗 Related nodes in the same category

Ready to use Wait For Signal?

Available now on all FlowForge plans. Try it free without a credit card.

Start free Browse all nodes