WTS Chat icon

WTS Chat

Get data from Wts API

Actions39

Overview

The node interacts with the WTS Chat API to manage and retrieve data related to various resources such as contacts, messages, sessions, panels, sequences, and chatbots. Specifically for the Panel resource with the List Cards operation, it retrieves cards (items) from a specified panel, optionally filtered by step, contact, responsible user, text content, and archival status. It supports including additional details about the cards and handles pagination.

This node is beneficial in scenarios where you want to automate workflows involving project or task management boards represented as panels with cards. For example, you can list all cards in a specific panel step assigned to a particular user or filter cards containing certain keywords. This helps in integrating project management data into other systems or automating reporting and notifications.

Properties

Name Meaning
Panel Name or ID Select or specify the panel from which to list cards.
Step Name or ID Optionally select or specify a step within the panel to filter cards.
Contact ID Optionally filter cards associated with a specific contact ID.
Responsible Name or ID Optionally filter cards assigned to a specific responsible user.
Text Filter Optional text string to filter cards by matching text content.
Include Archived Boolean flag indicating whether to include archived cards in the results.
Include Details Multi-select options to include additional card details in the response. Options: Contacts, CustomFields, PanelTitle, ResponsibleUser, StepPhase, StepTitle.
CreatedAt.After Optional datetime filter to include cards created after this timestamp. Format: YYYY-MM-DD hh:mm (timezone-aware).
CreatedAt.Before Optional datetime filter to include cards created before this timestamp. Format: YYYY-MM-DD hh:mm (timezone-aware).
UpdatedAt.After Optional datetime filter to include cards updated after this timestamp. Format: YYYY-MM-DD hh:mm (timezone-aware).
UpdatedAt.Before Optional datetime filter to include cards updated before this timestamp. Format: YYYY-MM-DD hh:mm (timezone-aware).
Auto Pagination Boolean flag to enable automatic pagination, fetching multiple pages of results automatically.
Max Pages When auto pagination is enabled, limits the maximum number of pages to fetch (1-100).
Page Number When auto pagination is disabled, specifies the page number to retrieve.
Page Size When auto pagination is disabled, specifies the number of items per page (1-100).
Order By Field name to sort the results by.
Order Direction Direction of sorting: Ascending or Descending.

Output

The output is an array of JSON objects representing the cards retrieved from the specified panel. Each item contains the card's data fields as returned by the WTS Chat API, potentially including:

  • Card identifiers and titles
  • Associated step and panel information
  • Assigned responsible user
  • Linked contacts
  • Custom fields and metadata (if requested)
  • Archival status
  • Additional details depending on the "Include Details" property selection

The node does not output binary data for this operation.

Dependencies

  • Requires an active connection to the WTS Chat API via an API key credential.
  • The node uses internal services to call the WTS Chat API endpoints for panels and cards.
  • No additional external dependencies are required beyond the configured API credentials.

Troubleshooting

  • Missing Panel ID: If the "Panel Name or ID" property is not set or set to undefined, the node will throw an error prompting to fill in the panel ID field.
  • Invalid Card Filters: Providing invalid or empty values for filters like step ID or responsible user may result in no data or errors.
  • API Authentication Errors: Ensure the API key credential is valid and has sufficient permissions to access panel and card data.
  • Pagination Issues: When using auto pagination, setting an excessively high max pages value may lead to longer execution times or rate limiting.
  • Empty Results: If no cards match the filters, the output will be an empty array; verify filter criteria correctness.
  • Network or API Errors: Any network issues or API errors will be thrown as node errors with descriptive messages.

Links and References

Discussion