WeChat Enhanced icon

WeChat Enhanced

WeChat Enhanced Node - Suporte completo para Mini Programs, Official Accounts, WeChat Pay e WeChat Work

Actions33

Overview

The "Get User List" operation for the Official Account resource in this WeChat Enhanced node retrieves a list of users who follow the official WeChat account. This operation supports pagination through the use of a "Next Open ID" parameter, allowing you to fetch subsequent batches of users if the total user base is large.

This node is beneficial when managing or analyzing followers of a WeChat Official Account, such as for marketing campaigns, customer engagement, or audience segmentation. For example, you might use it to export follower data for CRM integration or to trigger workflows based on follower activity.

Properties

Name Meaning
Next Open ID The Open ID from which to continue fetching the next batch of users (used for pagination). If empty, fetching starts from the beginning.

Output

The output JSON contains the user list data returned by the WeChat API for the Official Account's followers. Typically, this includes:

  • A list/array of user Open IDs.
  • The total number of followers.
  • The next Open ID for pagination if more users are available.

The exact structure depends on the WeChat API response but generally looks like:

{
  "total": 1234,
  "count": 1000,
  "data": {
    "openid": [
      "OPENID1",
      "OPENID2",
      "... more openids ..."
    ]
  },
  "next_openid": "NEXT_OPENID"
}

No binary data is output by this operation.

Dependencies

  • Requires an active subscription and valid API key credential for the external N8N Tools API service used for validation.
  • Requires proper authentication credentials configured for accessing the WeChat Official Account API.
  • The node internally uses a helper class that wraps WeChat API calls.

Troubleshooting

  • Invalid subscription or API key error: If you receive errors about invalid subscription or API key, verify that your API key credential is correctly set up and has the necessary permissions.
  • Pagination issues: If you do not provide the correct "Next Open ID" for pagination, you may repeatedly get the same first batch of users. Use the next_openid value from the previous response to fetch subsequent pages.
  • API rate limits: Be aware of WeChat API rate limits; excessive requests may result in temporary blocking.
  • Empty user list: If the user list is unexpectedly empty, confirm that your Official Account has followers and that the credentials have access rights.

Links and References

This summary is based solely on static analysis of the provided source code and property definitions.

Discussion