Zalo OA

Overview

This node integrates with the Zalo Official Account (OA) API, enabling users to interact programmatically with their Zalo OA. Specifically, the "Lấy Danh Sách Người Theo Dõi" (Get Followers List) operation retrieves a paginated list of followers of the Zalo OA.

Common scenarios for this node include:

• Fetching follower data for marketing or customer engagement analysis.
• Synchronizing follower lists with external CRM or database systems.
• Automating communication workflows based on follower information.

Practical example:

• A business wants to retrieve the first 20 followers of their Zalo OA to send personalized messages or analyze follower demographics.

Properties

Output

The output is a JSON object containing the response from the Zalo OA API's /getfollowers endpoint. It typically includes:

• A list/array of follower objects with details such as user IDs and other metadata.
• Pagination information indicating if more followers can be fetched.
• In case of errors, an error object with fields like error, message, and possibly note or suggestion.

No binary data is output by this operation.

Example output structure (simplified):

{
  "data": {
    "followers": [
      {
        "user_id": "123456789",
        "name": "Follower Name",
        ...
      },
      ...
    ],
    "paging": {
      "offset": 0,
      "count": 10,
      "total": 100
    }
  },
  "error": false
}

If an error occurs, the output JSON will contain an error: true field along with descriptive messages.

Dependencies

• Requires an active Zalo Official Account API access token credential configured in n8n.
• Uses the Zalo OA REST API v2.0 endpoints at https://openapi.zalo.me/v2.0/oa.
• HTTP requests are made using the Axios library.
• Proper permissions must be granted to the access token to fetch follower data.

Troubleshooting

Common Issues

• Invalid or expired access token: The API call will fail if the access token is missing, invalid, or expired.
• Exceeded count limit: The API restricts the maximum number of followers fetched per request to 50.
• API changes: The node logs mention that Zalo changed the getfollowers API to a new endpoint in version 3.0; ensure your OA configuration and permissions are up to date.
• Network or connectivity issues: Failures in reaching the Zalo API endpoint.

Error Messages and Resolutions

• "Lỗi khi gọi API lấy danh sách người theo dõi: <message>": Indicates failure calling the followers API. Check the access token validity and permissions.
• Note about API change: "Zalo đã thay đổi API getfollowers sang API user/getlist trong v3.0...". If you see this, verify your OA app settings and update tokens accordingly.
• Suggestions often recommend ensuring full access rights and valid tokens.

Links and References

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

This summary focuses exclusively on the "Lấy Danh Sách Người Theo Dõi" operation under the Zalo OA resource, as requested.