ChatWoot

Interact with ChatWoot API

Actions113

Contacts Actions
- Contact Details
- Contact Delete
- Contact Search
- Contact Update
- Contact Conversations
- Contact Filter
- Contact Create
- Contact List
Contact Actions
- Contact Inbox Creation
- Contactable Inboxes Get
Automation Rule Actions
- Get Account Automation Rule
- Get Details Of A Single Automation Rule
- Update Automation Rule In Account
- Add New Automation Rule To Account
- Delete Automation Rule From Account
Help Center Actions
- Get Portal
- Update New Portal To Account
- Add New Portal To Account
- Add New Category To Account
- Add New Article To Account
Conversations Actions
- Conversation List
- Conversation Filter
- Toggle Status Of A Conversation
- Conversation List Meta
- New Conversation
- Get Details Of A Conversation
- Toggle Priority Of A Conversation
Conversation Assignment Actions
- Assign A Conversation
Conversation Labels Actions
- Conversation Add Labels
- List All Labels Of A Conversation
Inboxes Actions
- Get Inbox
- Update Inbox
- Update Agent Bot
- Add New Agent To Inbox
- Update Agents In Inbox
- List All Inboxes
- Inbox Creation
- Get Inbox Agent Bot
- Get Inbox Members
- Delete Agent In Inbox
Messages Actions
- Create A New Message In A Conversation
- List All Messages
- Delete A Message
Integrations Actions
- Get Details Of All Integrations
- Delete An Integration Hook
- Create An Integration Hook
- Update An Integrations Hook
Teams Actions
- List All Teams
- Get Details Of A Single Team
- Update A Team
- Create A Team
- Delete A Team
- Get Team Members
- Add New Agent To Team
- Update Agents In Team
- Delete Agent In Team
Custom Filters Actions
- List All Filters
- Get Details Of A Single Custom Filter
- Update A Custom Filter
- Create A Custom Filter
- Delete A Custom Filter
Webhooks Actions
- Create A Webhook
- Update A Webhook
- List All Webhooks
- Delete A Webhook
Reports Actions
- List All Conversation Statistics Summary
- Get Agent Conversation Metrics
- List All Conversation Statistics
- Get Account Conversation Metrics
Accounts Actions
- Get Details Of An Account
- Update An Account
- Create An Account
- Delete An Account
Account Users Actions
- Create An Account User
- List All Account Users
- Delete An Account User
Agent Bots Actions
- Create An Agent Bot
- Delete An Agent Bot
- Get Details Of A Single Agent Bot
- Update An Agent Bot
Users Actions
- Create A User
- Delete A User
- Get Sso Url Of A User
- Get Details Of A User
- Update A User
Contacts API Actions
- Create A Contact
- Update A Contact
- Get Details Of A Contact
Inbox API Actions
- Get Details Of A Inbox
Conversations API Actions
- List All Contact Conversations
- Create A Conversation
Messages API Actions
- Create A Message
- List All Converation Messages
- Update A Message
CSAT Survey Page Actions
- Get Csat Survey Page
Account Agent Bots Actions
- Create An Account Agent Bot
- Delete An Account Agent Bot
- List All Account Agent Bots
- Get Details Of A Single Account Agent Bot
- Update An Account Agent Bot
Agents Actions
- Get Account Agents
- Delete Agent From Account
- Add New Agent To Account
- Update Agent In Account
Canned Responses Actions
- Get Account Canned Response
- Delete Canned Response From Account
- Add New Canned Response To Account
Custom Attributes Actions
- Get Account Custom Attribute
- Get Details Of A Single Custom Attribute
- Update Custom Attribute In Account
- Add New Custom Attribute To Account
- Delete Custom Attribute From Account
Canned Response Actions
- Update Canned Response In Account

Overview

This node interacts with the Messages API of a chat platform to list all messages within a specific conversation. It is useful for retrieving the entire message history of a conversation between a contact and an inbox channel, enabling workflows that require message auditing, analysis, or synchronization.

Practical examples include:

Fetching conversation messages to display in a custom dashboard.
Archiving chat histories for compliance or record-keeping.
Triggering follow-up actions based on message content or timestamps.

Properties

Name	Meaning
Inbox Identifier	The unique identifier of the inbox channel from which to retrieve conversation messages.
Contact Identifier	The source ID of the contact involved in the conversation, obtained when the contact was created.
Conversation Id	The numeric ID representing the specific conversation whose messages are to be listed.

Output

The node outputs a JSON array containing the messages of the specified conversation. Each item in the array represents a single message with details such as sender, timestamp, message content, and potentially other metadata depending on the API response.

If the API supports binary data (e.g., attachments), those would be included in the output as binary fields, but this node primarily focuses on textual message data.

Dependencies

Requires an API key credential for authenticating with the chat platform's API.
The base URL for the API must be configured in the node credentials.
The node depends on the external chat platform's Messages API being accessible and responsive.

Troubleshooting

Missing or invalid identifiers: Ensure that the Inbox Identifier, Contact Identifier, and Conversation Id are correctly provided and correspond to existing entities in the chat platform.
Authentication errors: Verify that the API key credential is valid and has sufficient permissions to access conversation messages.
API connectivity issues: Check network connectivity and the correctness of the API base URL.
Empty results: If no messages are returned, confirm that the conversation ID is correct and that messages exist in that conversation.

Common error messages might include unauthorized access, resource not found, or bad request due to missing parameters. Resolving these typically involves verifying input properties and credentials.

Links and References

Chat platform official API documentation (Messages API section)
n8n documentation on creating and using API credentials
General REST API troubleshooting guides