AgentBrains Conversation
List conversations, retrieve conversation history, and send outbound agent messages from n8n.
AgentBrains Conversation
Use the Conversation resource when a workflow needs to inspect or continue customer conversations handled by AgentBrains. Conversation support is available in n8n-nodes-agent-brains version 3.3.0 or newer.
Operations
| Operation | Use it for | Required fields | Optional fields |
|---|---|---|---|
| Get Many | Find conversations by filters. | none | testId, reason, location, disableAi, channel, type, status, source, recipient, campaign, sort, limit, page |
| Get History | Retrieve the transcript/history for one conversation. | conversationId | none |
| Send Agent Message | Save an outbound agent message in a conversation. | conversationId, body | none |
Get Many filters
Select Conversation as the resource and Get Many as the operation.
| Filter | Type | Description |
|---|---|---|
testId | string | Test ID filter. |
reason | string | Reason filter. |
location | string | Location filter. |
disableAi | boolean | Disable-AI flag filter. |
channel | string | Conversation channel. Supported values: web-chat, email. |
type | number | Conversation type filter. |
status | number | Conversation status filter. |
source | number | Conversation source filter. |
recipient | string | Recipient filter. |
campaign | string | Campaign filter. |
sort | string | Sort expression. |
limit | number | Page size. |
page | number | Page number starting from 1. |
Expected output: a paginated conversation list returned by AgentBrains.
Get History
Select Conversation as the resource and Get History as the operation.
Required field:
conversationId: ID of the conversation to retrieve history for.
Expected output: the conversation history returned by the API.
Send Agent Message
Select Conversation as the resource and Send Agent Message as the operation.
Required fields:
conversationId: ID of the conversation to send the message to.body: message text to send as the agent.
HTTP request body behind the node:
{
"body": "message text"
}This creates and saves an outbound agent message for the selected conversation.
Example: Find a conversation and send an agent reply
- Add the AgentBrains n8n node.
- Select Conversation as the resource.
- Select Get Many.
- Add filters such as
channel = web-chat,status,recipient, orcampaign. - Select a
conversationIdfrom the returned items. - Add another AgentBrains node.
- Select Conversation → Get History and pass the
conversationId. - Add another AgentBrains node.
- Select Conversation → Send Agent Message.
- Set
conversationIdandbody.
Expected result: the workflow retrieves conversation context and saves an outbound agent message.
API mapping
| n8n operation | Public HTTP API |
|---|---|
| Get Many | GET /conversations |
| Get History | GET /conversations/{conversationId}/history |
| Send Agent Message | POST /conversations/{conversationId}/message |