Zalo OAInstall

Overview

This node integrates with the Zalo Official Account (OA) API, enabling users to manage and interact with their Zalo OA resources programmatically. Specifically, the "Lấy Danh Sách Sản Phẩm" (Get Product List) operation retrieves a list of products from the Zalo OA store.

Typical use cases include:

• Fetching product lists for display or synchronization in external systems.
• Automating inventory checks or updates by retrieving current product data.
• Integrating Zalo OA product information into marketing or sales workflows.

For example, a business using Zalo OA can automate pulling their product catalog into a CRM or e-commerce platform to keep product data consistent across channels.

Properties

Note: Although the bundled code uses a parameter named limit internally for the count, the user-facing property is "Số Lượng".

Output

The output JSON contains the response from the Zalo OA API endpoint that returns the product list. This typically includes:

• An array of product objects with details such as product ID, name, price, description, category, photos, and status.
• Metadata about the total number of products and pagination info.

If an error occurs, the output JSON will contain an error field set to true, a descriptive message, and possibly additional response data from the API to help diagnose the issue.

The node does not output binary data for this operation.

Dependencies

• Requires an API authentication token credential for Zalo OA API access.
• Uses the official Zalo OA API base URL: https://openapi.zalo.me/v3.0/oa.
• Relies on HTTP requests via Axios library to communicate with the Zalo OA API.
• The node expects proper permissions granted to the API token to access product data.

Troubleshooting

Common Issues

• Invalid or expired access token: The API calls will fail if the provided token is invalid or expired. Ensure the token is current and has necessary permissions.
• Exceeded maximum count: The API limits the maximum number of products fetched per request to 50. Requests exceeding this limit may be truncated or rejected.
• Incorrect offset or parameters: Providing negative offsets or invalid parameters may cause errors or empty results.
• Insufficient permissions: The API token must have rights to read product information; otherwise, the API will return authorization errors.

Error Messages and Resolutions

• "Error getting product list: <message>": Indicates failure in calling the product list API. Check network connectivity, token validity, and parameter correctness.
• Response data included in the error can provide HTTP status codes and detailed messages from Zalo OA API.
• Suggestions often include verifying API credentials, checking parameter values, and ensuring the OA account has granted required access.

Links and References

• Zalo Official Account API Documentation
• Zalo OA Store Product API Reference
• Axios HTTP Client