Zalo OAInstall

Overview

This node operation updates an existing article on a Zalo Official Account (OA). It allows users to modify various aspects of a published article such as the title, description, author name, cover photo URL and its display status, content body (supporting HTML), visibility status of the article itself, and whether comments are allowed. This is useful for maintaining up-to-date content, correcting errors, or refreshing articles without needing to delete and recreate them.

Practical examples:

• Updating the headline and summary of a news article after new information becomes available.
• Changing the cover image of a promotional post to reflect a new campaign.
• Hiding an article temporarily by changing its status to "hide".
• Enabling or disabling user comments on a specific article.

Properties

Output

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

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

No binary data output is involved in this operation.

Dependencies

• Requires a valid API access token credential for the Zalo Official Account with permissions to manage articles.
• Uses the Zalo OA API v3.0 endpoint https://openapi.zalo.me/v3.0/oa/article/update.
• The node internally uses HTTP POST requests with JSON payloads to communicate with the Zalo API.
• Proper network connectivity to Zalo's open API servers is required.

Troubleshooting

• Common issues:

  • Invalid or expired access token leading to authentication errors.
  • Incorrect or missing article token causing the API to fail finding the target article.
  • Invalid URLs for cover photos that cannot be accessed by Zalo servers.
  • Insufficient permissions on the OA account to perform article updates.
  • Malformed HTML content in the article body causing API rejection.

• Error messages and resolutions:

  • "API article/update trong Zalo OA API v3.0 gặp lỗi."
    Indicates a general API error during update. Check token validity and parameters.
  • "Vui lòng kiểm tra token bài viết và các tham số."
    Means the article token or parameters are invalid or missing. Verify the token and input fields.
  • Network or HTTP errors may appear if the API endpoint is unreachable; ensure internet access.
  • If the error mentions cover photo URL issues, verify the URL is publicly accessible and correctly formatted.

Links and References

• Zalo Official Account API Documentation
• Zalo OA Article Management API Reference
• n8n documentation on Creating Custom Nodes