Zalo OAInstall

Overview

This node interacts with the Zalo Official Account (OA) API to retrieve a list of followers for a given OA. It is useful for scenarios where you want to manage or analyze your audience on Zalo, such as marketing campaigns, customer engagement, or data synchronization.

For example, you can use this node to:

• Fetch batches of followers starting from a specific offset.
• Limit the number of followers retrieved per request (up to 50).
• Process follower data for further automation or reporting within n8n workflows.

Properties

Output

The node outputs JSON data containing the response from the Zalo OA API's follower list endpoint. The main structure includes:

• data: An array of follower objects, each representing a user following the OA.
• Each follower object may include fields like user ID and display information combining tag ID and name.
• Additional metadata such as total count or messages related to the API call.

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 Zalo OA API v3.0 endpoint: https://openapi.zalo.me/v3.0/oa/user/getlist.
• Access token management is handled internally, with fallback to environment variables or database tokens if available.
• Proper permissions must be granted to the API token, specifically the permission to manage and read follower information.

Troubleshooting

• Common Issues:

  • Exceeding the maximum allowed count value (should not exceed 50).
  • Invalid or expired access tokens causing authentication failures.
  • Insufficient permissions on the OA app leading to authorization errors.
  • Network or API endpoint issues resulting in request failures.

• Error Messages:

  • Errors returned from the API will include an error flag and message describing the issue.
  • Typical suggestions include verifying the access token validity, ensuring correct permissions, and checking parameter formats.
  • If the API returns an error about permissions, ensure that the OA has granted the "Manage follower information" permission to the application.

Links and References

• Zalo Official Account API Documentation
• Zalo OA User Get List API Reference
• n8n documentation on Creating Custom Nodes