Skip to content

Initial commit for respond-to-chat #3339

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 9 commits into from
Jul 28, 2025
Original file line number Diff line number Diff line change
Expand Up @@ -80,7 +80,11 @@ If you select any option other than **Off**, you must connect the Chat trigger a
Use this option when building a workflow with steps after the agent or chain that's handling the chat. Choose from:

* **When Last Node Finishes**: The Chat Trigger node returns the response code and the data output from the last node executed in the workflow.
* **Using 'Respond to Webhook' Node**: The Chat Trigger node responds as defined in the [Respond to Webhook](/integrations/builtin/core-nodes/n8n-nodes-base.respondtowebhook.md) node.
* **Using Response Nodes**: The Chat Trigger node responds as defined in a [Respond to Chat](/integrations/builtin/core-nodes/n8n-nodes-langchain.respondtochat.md) node or [Respond to Webhook](/integrations/builtin/core-nodes/n8n-nodes-base.respondtowebhook.md) node. In this response mode, the Chat Trigger will solely show messages as defined in these nodes and not output the data from the last node executed in the workflow.

/// note | Using Response Nodes
This mode replaces the 'Using Respond to Webhook Node' mode from version 1.2 of the Chat Trigger node.
///

#### Require Button Click to Start Chat

Expand Down Expand Up @@ -112,7 +116,11 @@ If you select any option other than **Off**, you must connect the Chat trigger a
Use this option when building a workflow with steps after the agent or chain that's handling the chat. Choose from:

* **When Last Node Finishes**: The Chat Trigger node returns the response code and the data output from the last node executed in the workflow.
* **Using 'Respond to Webhook' Node**: The Chat Trigger node responds as defined in the [Respond to Webhook](/integrations/builtin/core-nodes/n8n-nodes-base.respondtowebhook.md) node.
* **Using Response Nodes**: The Chat Trigger node responds as defined in a [Respond to Chat](/integrations/builtin/core-nodes/n8n-nodes-langchain.respondtochat.md) node or [Respond to Webhook](/integrations/builtin/core-nodes/n8n-nodes-base.respondtowebhook.md) node. In this response mode, the Chat Trigger will solely show messages as defined in these nodes and not output the data from the last node executed in the workflow.

/// note | Using Response Nodes
This mode replaces the 'Using Respond to Webhook Node' mode from version 1.2 of the Chat Trigger node.
///

## Templates and examples

Expand All @@ -131,6 +139,10 @@ In a basic workflow, the Agent and Chain nodes output a parameter named either `

If you need to manually create the response sent to the user, you must create a parameter named either `text` or `output`. If you use a different parameter name, the Chat trigger sends the entire object as its response, not just the value.

/// note | Respond to Chat node
When you are using a [Respond to Chat](/integrations/builtin/core-nodes/n8n-nodes-langchain.respondtochat.md) node to manually create the response sent to the user, you must set the Chat Trigger response mode to 'Using Response Nodes'.
///

## Common issues

For common questions or issues and suggested solutions, refer to [Common Issues](/integrations/builtin/core-nodes/n8n-nodes-langchain.chattrigger/common-issues.md).
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
---
#https://www.notion.so/n8n/Frontmatter-432c2b8dff1f43d4b1c8d20075510fe4
title: Respond to Chat node documentation
description: Learn how to use the Respond to Chat node in n8n. Follow technical documentation to integrate the Respond to Chat node into your workflows.
priority: critical
---

# Respond to Chat node

Use the Respond to Chat node in correspondence with the [Chat Trigger](/integrations/builtin/core-nodes/n8n-nodes-langchain.chattrigger/index.md) node to send a response into the chat and optionally wait for a response from the user. This allows you to have multiple chat interactions within a single execution and enables human-in-the-loop use cases in the chat.

/// note | Chat Trigger node
The Respond to Chat node requires a [Chat Trigger](/integrations/builtin/core-nodes/n8n-nodes-langchain.chattrigger/index.md) node to be present in the workflow, with the [Response Mode](/integrations/builtin/core-nodes/n8n-nodes-langchain.chattrigger/index.md#response-mode) set to 'Using Response Nodes'.
///

## Node parameters

### Message

The message to send to the chat.

### Wait for User Reply

Set whether the workflow execution should wait for a response from the user (enabled) or continue immediately after sending the message (disabled).

Check warning on line 24 in docs/integrations/builtin/core-nodes/n8n-nodes-langchain.respondtochat.md

View workflow job for this annotation

GitHub Actions / runner / vale

[vale] reported by reviewdog 🐶 [from-write-good.Weasel] 'immediately' is a weasel word! Raw Output: {"message": "[from-write-good.Weasel] 'immediately' is a weasel word!", "location": {"path": "docs/integrations/builtin/core-nodes/n8n-nodes-langchain.respondtochat.md", "range": {"start": {"line": 24, "column": 99}}}, "severity": "WARNING"}

## Node options

### Add Memory Input Connection

Choose whether you want to commit the messages from the Respond to Chat node to a connected memory. Using a shared memory between an agent or chain [root node](/integrations/builtin/cluster-nodes/root-nodes/index.md) and the Respond to Chat node attaches the same session key to these messages and lets you capture the full message history.

### Limit Wait Time

When you enable **Wait for User Reply**, this option decides whether the workflow automatically resumes execution after a specific limit (enabled) or not (disabled).

## Related resources

--8<-- "_snippets/integrations/builtin/cluster-nodes/langchain-overview-link.md"

## Common issues

For common questions or issues and suggested solutions, refer to [Common Issues](/integrations/builtin/core-nodes/n8n-nodes-langchain.chattrigger/common-issues.md).
1 change: 1 addition & 0 deletions nav.yml
Original file line number Diff line number Diff line change
Expand Up @@ -229,6 +229,7 @@ nav:
- integrations/builtin/core-nodes/n8n-nodes-base.removeduplicates/index.md
- Templates and examples: integrations/builtin/core-nodes/n8n-nodes-base.removeduplicates/templates-and-examples.md
- integrations/builtin/core-nodes/n8n-nodes-base.renamekeys.md
- Respond to Chat: integrations/builtin/core-nodes/n8n-nodes-langchain.respondtochat.md
- integrations/builtin/core-nodes/n8n-nodes-base.respondtowebhook.md
- integrations/builtin/core-nodes/n8n-nodes-base.rssfeedread.md
- RSS Feed Trigger: integrations/builtin/core-nodes/n8n-nodes-base.rssfeedreadtrigger.md
Expand Down