Zalo OAInstall

Overview

This node interacts with the Zalo Official Account (OA) API to retrieve detailed information about a specific article (post) published on a Zalo OA. It is useful for scenarios where you need to programmatically fetch and process content details from your Zalo OA articles, such as for analytics, content management, or integration with other systems.

A practical example use case is when you want to automatically pull the full details of an article by its token (unique identifier) to display it in a dashboard or to synchronize content with another platform.

Properties

Output

• The output is a JSON object containing the detailed information of the requested article.
• The structure corresponds to the response from the Zalo OA API endpoint /article/getdetail.
• Typical fields include article metadata such as title, author, cover image URL, description, body content, status, comments, and other related data.
• No binary data output is involved in this operation.

Dependencies

• Requires an API access token credential for Zalo OA with appropriate permissions to read article details.
• The node uses the official Zalo OA API v2.0 endpoint https://openapi.zalo.me/v2.0/oa/article/getdetail.
• Proper configuration of the API key/token in n8n credentials is necessary.
• Network connectivity to the Zalo OA API endpoint is required.

Troubleshooting

• Common issues:

  • Invalid or expired access token: Ensure the API token used has not expired and has the correct permissions.
  • Incorrect or non-existent article token: Verify that the provided article token exists and is correctly input.
  • API rate limits or network errors: Check network connectivity and Zalo OA API usage limits.

• Error messages:

  • "Lỗi khi lấy chi tiết bài viết: <error message>" — Indicates failure calling the article detail API; check token validity and article existence.
  • Errors including HTTP status codes and response bodies are logged and returned in the output JSON under an error field with suggestions to verify parameters and permissions.

Links and References

• Zalo Official Account API Documentation
• Article Get Detail API Reference

This summary is based on static analysis of the node's source code focusing on the "Lấy Chi Tiết Bài Viết" (Get Article Detail) operation within the Zalo OA resource.