WTS Chat icon

WTS Chat

Get data from Wts API

Overview

This node operation 'Get All Cards' under the 'Panel' resource retrieves a list of cards from a specified panel in the WTS Chat system. It supports filtering by panel ID, step ID, contact ID, responsible user ID, text filter, and whether to include archived cards. It also allows including additional details such as contacts, custom fields, panel title, responsible user, step phase, and step title. Pagination and sorting options are supported to manage large datasets. This operation is useful for users who want to fetch and analyze cards within a panel, for example, to monitor tasks, track progress, or generate reports.

Use Case Examples

  1. Retrieve all cards from a specific panel to display in a dashboard.
  2. Filter cards by responsible user to see tasks assigned to a particular team member.
  3. Include detailed information like contacts and custom fields for comprehensive card data analysis.

Properties

Name Meaning
Responsible Name or ID Filter cards by the responsible user ID or name.
Contact ID Filter cards by a specific contact ID.
Panel Name or ID Specify the panel from which to retrieve cards.
Step Name or ID Filter cards by a specific step within the panel.
Text Filter Filter cards by text content.
Include Archived Whether to include archived cards in the results.
Include Details Specify additional details to include in the card data, such as contacts, custom fields, panel title, responsible user, step phase, and step title.
CreatedAt.After Filter cards created after this date/time.
CreatedAt.Before Filter cards created before this date/time.
UpdatedAt.After Filter cards updated after this date/time.
UpdatedAt.Before Filter cards updated before this date/time.
Auto Pagination Enable automatic pagination to retrieve multiple pages of results.
Max Pages Maximum number of pages to retrieve when auto pagination is enabled.
Page Number The page number to retrieve when auto pagination is disabled.
Page Size Number of items per page when auto pagination is disabled.
Order By Field to sort the results by.
Order Direction Direction of sorting, either ascending or descending.

Output

JSON

  • json - Array of card objects with details as per the specified filters and included details.

Dependencies

  • WtsCrmService for interacting with the WTS CRM API to fetch card data.

Troubleshooting

  • Error 'Fill in the panel ID field' occurs if the panel ID is not provided; ensure the panel ID is specified.
  • If no cards are returned, verify the filters such as panel ID, step ID, and responsible user ID are correct.
  • API errors from the WTS CRM service are wrapped as NodeApiError; check API credentials and network connectivity.

Links

Discussion