WTS Chat icon

WTS Chat

Get data from Wts API
Join our community

Actions38

Overview

The node interacts with the "Panel" resource of the WTS Chat API, specifically supporting the operation to Get All Annotations for a given card. This operation retrieves all annotation entries linked to a specified card within a panel.

This node is useful in scenarios where you want to programmatically fetch notes, comments, or other annotations associated with a particular card in a project management or CRM-like system. For example, it can be used to gather all feedback or updates related to a task or customer record represented by the card.

Practical examples:

  • Fetching all annotations on a sales lead card to review communication history.
  • Retrieving comments and files attached as annotations on a project task card for reporting.
  • Automating the extraction of annotation data for analytics or backup purposes.

Properties

Name Meaning
Card ID The unique identifier of the card whose annotations you want to retrieve.
CreatedAt.After Filter annotations created after this date/time (format: YYYY-MM-DD hh:mm).
CreatedAt.Before Filter annotations created before this date/time (format: YYYY-MM-DD hh:mm).
UpdatedAt.After Filter annotations updated after this date/time (format: YYYY-MM-DD hh:mm).
UpdatedAt.Before Filter annotations updated before this date/time (format: YYYY-MM-DD hh:mm).
Auto Pagination Whether to automatically paginate through results to retrieve more items per page.
Max Pages Maximum number of pages to retrieve when auto pagination is enabled (1 to 100).
Page Number The specific page number to retrieve when auto pagination is disabled.
Page Size Number of items per page when auto pagination is disabled (1 to 100).
Order By Field name to sort the annotations by.
Order Direction Direction of sorting: Ascending or Descending.

Output

The output is an array of JSON objects, each representing an annotation linked to the specified card. Each annotation object contains details such as text content, file URLs if any, creation and update timestamps, and possibly metadata depending on the API response.

The node does not output binary data for this operation; all data is returned as structured JSON.

Dependencies

  • Requires an active connection to the WTS Chat API via an API key credential.
  • The node uses the WtsCrmService.getAllAnnotation method internally to fetch annotations.
  • Proper configuration of the API key credential in n8n is necessary for authentication.

Troubleshooting

  • Error: "CardID is empty, please fill it in"
    This error occurs if the Card ID property is not provided. Ensure that you specify a valid Card ID before executing the node.

  • API Errors / Network Issues
    If the node throws errors related to network connectivity or API response failures, verify your API key validity, internet connection, and that the WTS Chat API service is operational.

  • Pagination Misconfiguration
    When using auto pagination, setting an excessively high Max Pages value may cause long execution times or timeouts. Adjust accordingly.

Links and References

Note: Internal credential names and service identifiers have been generalized to comply with guidelines.

Discussion