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, articles, products, categories, orders, followers, tags, and menus. Specifically, the "Lấy Chi Tiết Bài Viết" (Get Article Detail) operation retrieves detailed information about a specific article by its token.

Common scenarios where this node is beneficial include:

• Fetching detailed content and metadata of an article published on a Zalo OA.
• Automating content management workflows by programmatically accessing article details.
• Integrating Zalo OA article data into other systems or dashboards.

Practical example:

• A marketing automation workflow that fetches article details to display in a CRM or sends notifications based on article content updates.

Properties

Output

The node outputs a JSON object containing the detailed information of the requested article. This includes fields returned by the Zalo OA API's article/getdetail endpoint, such as article ID, title, author, description, content body, cover image URL, status, comment settings, and other metadata.

If an error occurs (e.g., invalid token or network issues), the output JSON will contain:

• error: true
• message: Description of the error
• response: Raw response data from the API if available
• note and suggestion: Additional guidance for troubleshooting

The node does not output binary data for this operation.

Dependencies

• Requires an API authentication token credential for Zalo OA API access.
• Uses the Zalo OA API base URL: https://openapi.zalo.me/v2.0/oa.
• Relies on HTTP requests via Axios library.
• Proper permissions must be granted to the API token to access article details.

Troubleshooting

Common Issues

• Invalid or expired token: The provided article token may be incorrect or the API access token may have expired.
• Article not found: The article identified by the token might have been deleted or never existed.
• Permission errors: The API token lacks sufficient rights to access article details.
• Network or API downtime: Temporary connectivity issues or Zalo API service interruptions.

Error Messages and Resolutions

• "Lỗi khi lấy chi tiết bài viết: <error message>"
  Indicates failure to fetch article details. Check that the article token is correct and the API token has proper permissions.
• Response status codes like 401 or 403 suggest authentication or authorization problems; refresh or verify credentials.
• If the response contains additional notes or suggestions, follow them carefully, e.g., verifying token validity or consulting the latest Zalo OA API documentation.

Links and References

• Zalo Official Account API Documentation
• Zalo OA Article API Reference (for detailed parameters and responses)