Zalo OAInstall

Overview

This node integrates with the Zalo Official Account (OA) API to perform various operations related to messaging, user management, content publishing, and store management on the Zalo platform. Specifically, for the Zalo OA resource and the Xác Thực Video (Video Verification) operation, it verifies a video that has been previously uploaded by its upload ID.

Common scenarios where this node is beneficial include:

• Automating interactions with Zalo users via messages.
• Managing followers and tags in Zalo OA.
• Publishing articles or managing product catalogs within Zalo stores.
• Uploading and verifying media such as images, GIFs, and videos.
• Verifying uploaded videos to ensure they meet platform requirements or for compliance purposes.

Practical example:

• After uploading a video to Zalo OA, you can use this node's "Xác Thực Video" operation to verify the video by providing its upload ID. This helps confirm the video's validity before further processing or publishing.

Properties

Output

The node outputs JSON data containing the response from the Zalo OA API regarding the video verification status. This typically includes fields indicating whether the video verification was successful, any error messages, and additional metadata returned by the API.

If the node supports binary data output (not explicitly shown for this operation), it would represent media files or attachments related to the operation.

Dependencies

• Requires an API key credential for authenticating with the Zalo OA API.
• Uses the Zalo OA API endpoints, specifically version 2.0 or 3.0 depending on the operation.
• Requires proper OAuth tokens (access token and refresh token) which can be stored in environment variables, workflow static data, or a database.
• Uses the axios library for HTTP requests.
• Uses form-data for multipart/form-data uploads when handling media files.

Troubleshooting

• Common issues:

  • Invalid or expired access tokens causing authentication failures.
  • Incorrect or missing upload ID parameter leading to API errors.
  • Insufficient permissions granted to the API token for video verification.
  • Network connectivity issues preventing API calls.

• Error messages and resolutions:

  • "Error uploading file:" or "Error uploading GIF:": Check the file format and ensure the OA has permission to access the file.
  • "Please check the parameters and OA access permissions.": Verify that all required parameters are correctly set and the API token has necessary scopes.
  • "No binary data property ... exists on item.": Ensure the binary data input is correctly referenced if uploading files.
  • "API article/remove trong Zalo OA API v3.0 gặp lỗi." (API error message): Indicates an issue with the API endpoint; check API documentation and token validity.
  • "Vui lòng kiểm tra token bài viết và các tham số.": Make sure the token and parameters like upload ID are valid and exist.

Links and References

• Zalo Official Account Developer Documentation
• Zalo OA API Reference
• n8n Documentation on Creating Custom Nodes

Note: The above summary is based on static analysis of the provided source code and property definitions without executing the code.