WbCommunication icon

WbCommunication

n8n node to interact with WB API

Actions20

Overview

This node is designed to retrieve questions from a data source related to product inquiries, specifically filtering by whether the questions have been answered or not. It allows users to fetch a list of questions with various filtering and pagination options such as date range, sorting order, and product identifier. This node is useful in scenarios where you want to analyze customer questions about products, monitor unanswered queries, or integrate question data into workflows for further processing or reporting.

Practical examples include:

  • Fetching all unanswered questions about a specific product within a certain time frame to prioritize customer support.
  • Retrieving recently answered questions sorted by date to update FAQs or knowledge bases.
  • Paginating through large sets of questions for batch processing or exporting.

Properties

Name Meaning
Is Answered Filter questions by their answer status: true for answered questions, false for unanswered questions.
Nm Id The product article number (WB article ID) to filter questions related to a specific product.
Take Number of questions to retrieve. Maximum allowed value is 10,000. The sum of take and skip must not exceed 10,000.
Skip Number of questions to skip (offset). Maximum allowed value is 10,000. The sum of take and skip must not exceed 10,000.
Order Sorting order of questions by date. Possible values: dateAsc (ascending), dateDesc (descending).
Date From Start date of the period to filter questions, specified as a Unix timestamp.
Date To End date of the period to filter questions, specified as a Unix timestamp.

Output

The node outputs JSON data containing the list of questions matching the specified filters. Each item in the output typically includes details about the question such as its content, whether it has been answered, timestamps, and possibly associated product information.

If the node supports binary data output, it would generally relate to attachments or media linked to questions, but based on the provided code and properties, the primary output is structured JSON data representing questions.

Dependencies

  • Requires an API key credential to authenticate requests to the external service providing the questions data.
  • The node uses a base URL configured from an imported OpenAPI specification, indicating it interacts with a REST API endpoint.
  • No additional external dependencies are explicitly required beyond standard HTTP request capabilities and the API authentication.

Troubleshooting

  • Common issues:

    • Exceeding the maximum allowed sum of take and skip parameters (over 10,000) will likely cause errors or truncated results.
    • Providing invalid Unix timestamps for Date From or Date To may result in no data returned or API errors.
    • Incorrect or missing API credentials will prevent successful data retrieval.

  • Error messages:

    • Errors related to authentication failures suggest checking the API key or token configuration.
    • Validation errors on query parameters indicate adjusting take, skip, or date values within allowed ranges.
    • Network or timeout errors require verifying connectivity to the API endpoint.

Links and References

  • Unix Timestamp Converter — Useful for converting human-readable dates to Unix timestamps.
  • Documentation for the external API (not provided here) should be consulted for detailed parameter descriptions and response formats.

Discussion