Zalo OA icon

Zalo OA

Tương tác với Zalo Official Account API

Overview

The "Zalo OA" node integrates with the Zalo Official Account API, enabling automation of various interactions and management tasks related to a Zalo Official Account. Specifically, the "Xác Thực Video" (Video Verification) operation allows users to verify videos that have been uploaded to Zalo's platform by providing an upload ID.

This node is beneficial in scenarios where businesses or developers need to automate content verification workflows on Zalo, such as confirming the authenticity or status of uploaded videos before publishing or further processing. For example, after uploading a promotional video to Zalo, you can use this node to programmatically verify the video’s status without manual intervention.

Properties

Name Meaning
Upload ID The unique identifier of the video that has been uploaded and needs to be verified. This is a required string input.

Output

The node outputs a JSON object containing the response from the Zalo Official Account API regarding the video verification request. This typically includes details about the verification status, any errors, or additional metadata returned by the API.

If the node supports binary data output for other operations, it would represent media files or attachments; however, for the "Xác Thực Video" operation, the output is purely JSON-based.

Dependencies

  • Requires an API authentication token (access token) for the Zalo Official Account API.
  • Uses the Axios HTTP client library to make REST API calls.
  • Requires proper configuration of credentials within n8n to provide the access token.
  • The base URL for API requests is https://openapi.zalo.me/v3.0/oa.

Troubleshooting

  • Common Issues:

    • Invalid or expired access token leading to authentication failures.
    • Incorrect or missing Upload ID causing the API to reject the verification request.
    • Network connectivity issues preventing communication with the Zalo API endpoint.
  • Error Messages:

    • Errors returned from the API will be included in the JSON output under error fields.
    • If the Upload ID is invalid, the API may return an error indicating the video cannot be found or verified.
    • Authentication errors suggest checking the validity and permissions of the access token.
  • Resolution Tips:

    • Ensure the access token credential is correctly set up and has not expired.
    • Verify that the Upload ID corresponds to a previously uploaded video.
    • Check network settings and firewall rules to allow outbound HTTPS requests to openapi.zalo.me.
    • Review API documentation for any changes in endpoint requirements or parameters.

Links and References

Discussion