Coze icon

Coze

Interact with Coze AI platform
Join our community

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 operation 查看对话消息详情 (View Chat Message Details), it allows retrieving detailed information about a specific chat conversation by its ID.

Typical use cases include:

  • Fetching the full details of a particular chat session for analysis or display.
  • Integrating chat history retrieval into automated workflows.
  • Monitoring or auditing conversations within the Coze platform.

For example, a user might want to retrieve all messages and metadata from a customer support chat session identified by a unique chat ID.

Properties

Name Meaning
Authentication Method to authenticate API requests. Options: Service Token, OAuth2
会话 ID（conversationId） Optional identifier specifying which session the conversation belongs to. Used in some operations but not required here.
对话 ID（chatId） Required. The unique identifier of the chat conversation whose details are to be retrieved.

Output

The node outputs JSON data representing the detailed information of the specified chat conversation. This typically includes message contents, timestamps, sender information, and any associated metadata provided by the Coze platform.

If the node supports binary data output (not indicated explicitly here), it would represent attachments or media related to the chat messages, but this is not evident from the provided code and properties.

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.
  • No additional external dependencies are indicated.

Troubleshooting

  • Common Issues:

    • Missing or invalid chatId parameter will likely cause the API call to fail.
    • Incorrect or expired authentication credentials will result in authorization errors.
    • Network connectivity issues to the Coze API endpoint can cause request failures.

  • Error Messages:

    • Errors returned from the Coze API will be propagated; typical messages may include "Unauthorized", "Not Found" (if chatId does not exist), or "Bad Request" (if parameters are malformed).
    • To resolve, verify that the chatId is correct, ensure valid authentication credentials, and check network access.

Links and References

Discussion