Zalo OAInstall

Overview

This node integrates with the Zalo Official Account (OA) API, enabling users to manage articles, messages, followers, products, categories, orders, and tags within their Zalo OA. Specifically, the "Lấy Chi Tiết Bài Viết" (Get Article Detail) operation retrieves detailed information about a specific article using its unique token.

Typical use cases include:

• Fetching full details of an article published on a Zalo OA for display or further processing.
• Automating content management workflows by retrieving article metadata and content.
• Integrating Zalo OA article data into other systems or dashboards.

Example: You have a list of article tokens and want to fetch each article's details to update your CMS or send notifications based on article content.

Properties

Output

The node outputs a JSON object containing the response from the Zalo OA API for the requested article detail. This typically includes fields such as article title, author, description, content body, cover image URL, status, comments setting, and other metadata related to the article.

If an error occurs (e.g., invalid token or permission issues), the output JSON will contain an error flag set to true, an error message, optional response details from the API, and suggestions for troubleshooting.

The node does not output binary data for this operation.

Dependencies

• Requires an API authentication token credential for Zalo OA with appropriate permissions.
• Uses the Zalo OA API endpoint at https://openapi.zalo.me/v2.0/article/getdetail.
• Requires network access to Zalo's open API servers.
• The node expects the token parameter to be valid and correspond to an existing article.

Troubleshooting

• Common Issues:

  • Invalid or expired token: The API will return an error if the article token is incorrect or the article no longer exists.
  • Insufficient permissions: The access token used must have rights to read article details.
  • Network or API downtime: Temporary connectivity issues can cause failures.

• Error Messages:

  • "Lỗi khi lấy chi tiết bài viết: <error message>": Indicates failure in fetching article details. Check the token validity and API permissions.
  • API response errors may include HTTP status codes and detailed messages; review these to identify issues.

• Resolutions:

  • Verify that the article token is correct and corresponds to an existing article.
  • Ensure the API key/credential has the necessary scopes and is not expired.
  • Confirm network connectivity and that Zalo OA API services are operational.
  • Consult the latest Zalo OA API documentation for any changes in endpoints or parameters.

Links and References

• Zalo Official Account API Documentation
• Zalo OA Article API Reference (check for latest version and usage)

Note: This summary focuses exclusively on the "Lấy Chi Tiết Bài Viết" operation under the "Zalo OA" resource as requested.