Zalo OA

Overview

This node integrates with the Zalo Official Account (OA) API, enabling users to manage various aspects of their Zalo OA such as messaging, followers, tags, articles, products, categories, and orders. Specifically, the "Tạo Danh Mục" (Create Category) operation allows users to create a new product category within their Zalo OA store.

Typical use cases include:

• Automating the creation of product categories in an online store managed via Zalo OA.
• Organizing products into categories for better management and display on the Zalo platform.
• Integrating Zalo OA product catalog management into broader workflows, e.g., syncing inventory or updating categories based on external data.

Example: Automatically creating a new category named "Summer Collection" with a description and image URL, setting its visibility status to "Hiển Thị" (Show).

Properties

Note: Although the bundled code also supports an optional parentId parameter for nested categories, it is not listed in the provided properties JSON but is used internally if supplied.

Output

The node outputs a JSON object containing the response from the Zalo OA API after attempting to create the category. This typically includes:

• Confirmation of the created category details such as ID, name, description, status.
• Any error messages if the creation failed, including error flags and suggestions.

The output structure directly reflects the API response and can be used downstream in workflows for further processing or logging.

No binary data output is involved in this operation.

Dependencies

• Requires an active Zalo Official Account API access token credential configured in n8n.
• Uses the Zalo OA API endpoint at https://openapi.zalo.me/v2.0/oa/store/category/create.
• HTTP requests are made using Axios.
• Proper permissions must be granted to the access token to allow category creation.

Troubleshooting

Common Issues

• Invalid or expired access token: The API will reject requests if the token is invalid or expired.
• Insufficient permissions: The access token must have rights to manage store categories.
• Incorrect property values: Missing required fields like category name or invalid URLs may cause errors.
• Network issues: Connectivity problems can prevent successful API calls.

Error Messages and Resolutions

• "Error creating category: <message>": Indicates failure returned by the API or network error.
  • Check that all required parameters are correctly set.
  • Verify the access token validity and permissions.
  • Ensure the image URL (if provided) is accessible and properly formatted.
• Response status codes and data are logged internally for debugging.
• Suggestions are provided in the output JSON to guide resolution steps.

Links and References

• Zalo Official Account API Documentation
• Zalo OA Store Category API Reference (link inferred, please verify with official docs)