Zalo OAInstall

Overview

The "Zalo OA" node integrates with the Zalo Official Account (OA) API, enabling users to manage content and interactions on their Zalo OA. Specifically, the "Tạo Bài Viết" (Create Article) operation allows users to create new articles on their Zalo Official Account by providing details such as title, author, description, cover image, content, and display settings.

This node is beneficial for businesses or content creators who want to automate publishing articles directly to their Zalo OA without manual intervention. For example, it can be used to programmatically post news updates, blog posts, or promotional content to engage followers on Zalo.

Properties

Output

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

• Confirmation of the article creation.
• Details about the created article such as its ID or token.
• Any error messages if the creation failed.

If an error occurs, the output JSON will contain an error flag set to true, an error message, and possibly additional response data from the API to help diagnose the issue.

The node does not output binary data for this operation.

Dependencies

• Requires an API authentication token (access token) for the Zalo Official Account API.
• Uses the Zalo OA API endpoint at https://openapi.zalo.me/v2.0/article/create.
• Requires proper permissions granted to the access token to create articles.
• The node uses the axios library for HTTP requests.
• If using cover images, the URLs must be accessible and valid.

Troubleshooting

• Common Issues:

  • Invalid or expired access token leading to authentication errors.
  • Incorrect or missing required fields such as title or content.
  • Invalid cover photo URL or inaccessible image causing upload failures.
  • API changes or deprecations affecting endpoint availability.

• Error Messages:

  • "Lỗi khi tạo bài viết: <error message>": Indicates failure during article creation. Check the error message and API response for details.
  • Errors related to cover image URL or permissions suggest verifying that the image URL is correct and publicly accessible.
  • Permission-related errors recommend ensuring the access token has rights to create articles on the OA.

• Resolutions:

  • Verify and refresh the API access token.
  • Ensure all required properties (Tiêu Đề Bài Viết, Nội Dung Bài Viết) are provided.
  • Confirm the cover photo URL is valid and accessible.
  • Review Zalo OA API documentation for any recent changes.

Links and References

• Zalo Official Account Developer Documentation
• Zalo OA API Reference
• Axios HTTP Client