Zalo OA icon

Zalo OA

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

Overview

This node integrates with the Zalo Official Account (OA) API to create a new product in the OA's online store. It allows users to specify product details such as name, price, description, code, images, and display status. This is useful for businesses managing their product catalog on Zalo OA, enabling automated product creation workflows.

Common scenarios:

  • Automatically adding new products from an external inventory system into Zalo OA.
  • Creating promotional or limited-time products dynamically based on marketing campaigns.
  • Syncing product data between different sales channels and Zalo OA.

Example:
A retailer wants to add a new smartphone model to their Zalo OA store whenever it becomes available. Using this node, they can input the product name, price, description, SKU code, upload product images via URLs, and set the product visibility status. The node then calls the Zalo OA API to create the product entry.


Properties

Name Meaning
Tên Sản Phẩm (name) The name of the product (required).
Giá Sản Phẩm (price) The price of the product in Vietnamese Dong (VND) (required).
Mô Tả Sản Phẩm (description) A textual description of the product.
Mã Sản Phẩm (code) The product code or SKU identifier.
URL Hình Ảnh Sản Phẩm (photos) Comma-separated URLs of product images.
Trạng Thái Sản Phẩm (status) Display status of the product; options are "Hiển Thị" (show) or "Ẩn" (hide).

Output

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

  • Confirmation of product creation.
  • Product ID and details as stored in Zalo OA.
  • Any error messages if the creation failed.

No binary data output is produced by this operation.


Dependencies

  • Requires an active and valid API access token for Zalo Official Account.
  • The node uses HTTP POST requests to the Zalo OA API endpoint /store/product/create.
  • Proper permissions must be granted to the API token to manage products.
  • No additional external services beyond Zalo OA API are required.

Troubleshooting

  • Common issues:

    • Invalid or expired API access token leading to authentication errors.
    • Incorrect or missing required parameters such as product name or price.
    • Invalid image URLs or inaccessible images causing upload failures.
    • Insufficient permissions for the API token to create products.
  • Error messages and resolutions:

    • "Please check the product parameters and OA access permissions."
      Ensure all required fields are correctly filled and the API token has product management rights.
    • Network or API errors may include HTTP status codes and detailed messages in the response JSON. Check connectivity and token validity.
    • If images fail to load, verify that URLs are publicly accessible and correctly formatted.

Links and References


Note: This summary is based solely on static analysis of the provided source code and property definitions without runtime execution.

Discussion