Actions12
Overview
This node integrates with the Coze AI platform, enabling users to interact programmatically with various Coze services. Specifically, for the Chat resource and the 查看对话详情 (Retrieve Chat Details) operation, the node fetches detailed information about a specific chat conversation by its unique chat ID.
Typical use cases include:
- Retrieving the full details of a particular chat session for review or processing.
- Integrating chat history retrieval into automated workflows, such as customer support ticketing or analytics.
- Accessing chat metadata or content to trigger further actions based on conversation context.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method used to authenticate API requests. Options: Service Token, OAuth2 |
| 对话 ID（chatId） | The unique identifier of the chat conversation to retrieve details for. This is required. |
Note: Although the property "会话 ID（conversationId）" exists in the node's properties, it is not applicable for the "查看对话详情" operation and thus not listed here.
Output
The node outputs a JSON array where each item corresponds to the retrieved chat detail object from the Coze platform. The structure typically includes all relevant information about the chat identified by the provided chat ID, such as messages, participants, timestamps, and metadata.
No binary data output is indicated for this operation.
Dependencies
- Requires an active connection to the Coze AI platform API at
https://api.coze.cn. - Requires authentication via either a service token or OAuth2 credentials configured in n8n.
- Proper API credentials must be set up in n8n prior to using this node.
Troubleshooting
Common Issues:
- Invalid or missing chat ID will result in errors or empty responses.
- Authentication failures due to incorrect or expired tokens.
- Network connectivity issues preventing access to the Coze API endpoint.
Error Messages:
- Errors related to authentication usually indicate invalid credentials; verify and update your API keys or OAuth tokens.
- If the chat ID does not exist or is malformed, the API may return a "not found" or similar error; ensure the chat ID is correct.
- Rate limiting or quota exceeded errors require checking your Coze account limits.
Links and References
- Coze AI Platform API Documentation (official API base URL)
- n8n documentation on Creating Custom Nodes