WAIT_FOR_USER_RESPONSE

What it does

WAIT_FOR_USER_RESPONSE node.

Inputs & outputs

Configuration

No configuration.

Example

How it works

WAIT_FOR_USER_RESPONSE is used inside a Chatflow to pause the conversation until the user replies. It suspends the chatflow's execution and resumes when the user's next message arrives, exposing the text on the user_response output. Set mode to form_field and pick a fieldType (email, phone, number, or text) to validate the reply — on a bad answer the node returns user_response: null with a validation_error and should_retry: true, so you can re-prompt.

Example

Scenario: A WhatsApp chatbot collects the user's email address.

1. A CHATFLOW_SEND_MESSAGE node asks "What's your email?".
2. Add a WAIT_FOR_USER_RESPONSE node. Set mode to form_field and fieldType to email.
3. On a valid reply, user_response carries the address; on an invalid one, branch on should_retry to ask again.

CHATFLOW_SEND_MESSAGE ──► WAIT_FOR_USER_RESPONSE ──(user_response)──► next step

This node only runs within a Chatflow graph, not a normal Workflow.