Zalo OA icon

Zalo OA

Tương tác với Zalo Official Account API

Actions36

Overview

This node integrates with the Zalo Official Account (OA) API, enabling users to manage products within their Zalo OA store. Specifically, the "Cập Nhật Sản Phẩm" (Update Product) operation allows updating details of an existing product in the OA store.

Typical use cases include:

  • Updating product information such as name, price, description, code, images, and visibility status.
  • Synchronizing product data from external systems or databases into the Zalo OA store.
  • Automating product catalog management workflows within marketing or sales automation pipelines.

For example, a user can update the price and photos of a product after a promotional campaign or correct product descriptions dynamically based on inventory changes.

Properties

Name Meaning
ID Sản Phẩm The unique identifier of the product to update.
Tên Sản Phẩm New name for the product.
Giá Sản Phẩm New price of the product in Vietnamese Dong (VND).
Mô Tả Sản Phẩm New description text for the product.
Mã Sản Phẩm New product code or SKU.
URL Hình Ảnh Sản Phẩm New image URLs for the product, multiple URLs separated by commas.
Trạng Thái Sản Phẩm Display status of the product; options are "Hiển Thị" (show) or "Ẩn" (hide).

Output

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

  • Confirmation of the update operation success or failure.
  • Updated product details or error messages if the update failed.
  • If an error occurs, the output JSON contains fields like error, message, and possibly detailed API response data to help diagnose issues.

No binary data is output by this operation.

Dependencies

  • Requires an API authentication token (access token) for the Zalo Official Account API.
  • Uses the Zalo OA REST API endpoint at https://openapi.zalo.me/v2.0/oa/store/product/update.
  • The node expects proper configuration of credentials in n8n to provide the access token.
  • The API requires appropriate permissions granted to the access token to update product information.

Troubleshooting

Common Issues

  • Invalid or expired access token: The API call will fail if the token is invalid or expired. Ensure the credential is up-to-date.
  • Incorrect product ID: If the product ID does not exist or is incorrect, the API will return an error.
  • Malformed input data: Providing invalid formats for fields like price (non-numeric), photos (incorrect URL format), or status may cause errors.
  • Insufficient permissions: The access token must have rights to modify product data in the OA.

Error Messages and Resolutions

  • "Error updating product: <message>" — Check the product ID and all parameters for correctness.
  • API response errors often include HTTP status codes and messages; review these to identify issues such as permission denied or validation errors.
  • Suggestions usually recommend verifying the access token validity and ensuring the product exists in the OA store.

Links and References

Discussion