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 "Cập Nhật Danh Mục" (Update Category) operation allows updating an existing product category in the OA store by modifying its name, description, image URL, and display status.

Common scenarios for this node include:

• Updating product category details in a Zalo OA online store.
• Managing product catalog structure dynamically based on business needs.
• Automating category updates as part of larger workflows involving inventory or marketing.

Practical example:

• A retailer wants to rename a category from "Summer Collection" to "Summer 2024" and update its description and visibility status. This node can perform that update automatically using the category ID.

Properties

Output

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

• Confirmation of success or failure.
• Updated category data if successful.
• Error information if the update failed, including error messages and suggestions.

No binary data output is produced by this operation.

Example output JSON structure (simplified):

{
  "error": false,
  "message": "Category updated successfully",
  "data": {
    "id": "12345",
    "name": "New Category Name",
    "description": "Updated description",
    "status": "show",
    "photo": "https://example.com/image.jpg"
  }
}

Or in case of error:

{
  "error": true,
  "message": "Error updating category: Invalid category ID",
  "response": { /* detailed API error response */ },
  "suggestion": "Please check the category ID and parameters."
}

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/update.
• HTTP requests are made via Axios library.
• Content-Type header must be set to application/json.
• Proper permissions and valid access token are necessary to perform category updates.

Troubleshooting

Common Issues

• Invalid or missing category ID: The update will fail if the provided category ID does not exist or is incorrect.
• Insufficient permissions: The access token may lack required scopes to modify categories.
• Incorrect parameter formats: For example, invalid URLs for images or unsupported status values.
• Network or API errors: Temporary issues with the Zalo API service.

Common Error Messages and Resolutions

• "Error updating category: <message>"
  Check that the category ID is correct and exists in your OA store. Verify all input parameters for correctness.

• "Please check the category ID and parameters."
  Ensure all required fields are provided and formatted properly.

• API response errors with HTTP status codes (e.g., 401 Unauthorized, 403 Forbidden)
  Confirm that the API credentials are valid and have sufficient permissions.

• Network timeouts or connection errors
  Retry the operation later or verify network connectivity.

Links and References

• Zalo Official Account API Documentation
• Zalo OA Store Category Update Endpoint (link assumed based on typical docs structure)