Zalo OAInstall

Overview

This node interacts with the Zalo Official Account (OA) API to retrieve a list of articles posted on the OA. It supports fetching articles starting from a specified offset, limiting the number of articles returned, and filtering by article type (normal posts or video posts).

Common scenarios where this node is beneficial include:

• Automating content management workflows by retrieving recent or specific types of articles from a Zalo OA.
• Integrating Zalo OA content into other systems or dashboards for monitoring or analysis.
• Building custom notifications or reports based on new articles published on the OA.

Practical example:

• A marketing team wants to automatically fetch the latest 10 video posts from their Zalo OA to share them on other social media platforms or analyze engagement metrics.

Properties

Output

The output is a JSON object containing the response from the Zalo OA API's article list endpoint. The structure typically includes:

• data: An array of article objects, each representing an article with its details such as ID, title, author, cover image URL, description, and other metadata.
• usage_guide: An optional field providing usage instructions and examples for the API response.
• Other metadata fields related to pagination or status.

No binary data output is produced by this operation.

Dependencies

• Requires an API key credential for authenticating with the Zalo OA API.
• The node uses the official Zalo OA API endpoints (https://openapi.zalo.me/v2.0).
• Proper OAuth tokens (access token and refresh token) must be configured and valid.
• Network access to Zalo's API servers is necessary.

Troubleshooting

• Common issues:

  • Invalid or expired access tokens causing authentication failures.
  • Incorrect offset or limit values leading to empty or partial results.
  • Using unsupported article types (only "normal" and "video" are accepted).
  • Insufficient permissions granted to the API token for reading articles.

• Error messages and resolutions:

  • "Please check the parameters and OA access permissions."
    Ensure that the access token has the required scopes and is not expired.
  • "Vui lòng kiểm tra lại tham số type (chỉ chấp nhận giá trị 'normal' hoặc 'video'), quyền truy cập của OA và access_token."
    Confirm that the type parameter is either "normal" or "video".
  • API call errors with HTTP status codes may indicate network issues or invalid credentials; verify connectivity and token validity.
  • If persistent errors occur, consult the latest Zalo OA API documentation for any changes.

Links and References

• Zalo Official Account API Documentation
• Zalo OA Article List API Reference (may require login)
• n8n community forums and documentation for integrating with Zalo OA APIs