Zalo User icon

Zalo User

Quản lý người dùng Zalo

Actions9

Overview

This node interacts with Zalo User accounts, providing various user management operations. Specifically, the "Tìm kiếm người dùng" (Find User) operation allows searching for a Zalo user by their phone number. This is useful in scenarios where you want to retrieve user details based on a known phone number, such as verifying user identity, syncing contacts, or integrating Zalo user data into other systems.

Practical examples:

  • Searching for a user by phone number to display their profile information.
  • Validating if a phone number corresponds to an existing Zalo user before sending friend requests.
  • Automating contact enrichment workflows by fetching Zalo user details from phone numbers.

Properties

Name Meaning
Phone Number The phone number of the user to search for on Zalo.
Limit The maximum number of results to return from the search operation.

Output

The output JSON structure contains the user data returned by the Zalo API for the searched phone number. It typically includes user profile details such as user ID, name, avatar, and other public information available via the API.

Example output snippet (conceptual):

{
  "userId": "123456789",
  "name": "Nguyen Van A",
  "avatar": "https://example.com/avatar.jpg",
  "phoneNumber": "0123456789",
  ...
}

If multiple users are found (depending on API behavior), the output may include an array or list of user objects up to the specified limit.

No binary data output is produced by this operation.

Dependencies

  • Requires a valid Zalo API credential with authentication details including cookie, IMEI, and user agent.
  • The node uses an external Zalo API client library (zca-js) to perform operations.
  • Proper configuration of the Zalo API credential in n8n is necessary to authenticate requests.

Troubleshooting

  • Common issues:

    • Invalid or expired credentials leading to authentication failures.
    • Network connectivity problems preventing access to the Zalo API.
    • Providing an incorrectly formatted phone number may result in no user found or errors.

  • Error messages:

    • "No API instance found. Please make sure to provide valid credentials."
      Means the node could not authenticate with Zalo API. Check that the API key/credential is correctly set up and valid.
    • Errors related to invalid parameters will indicate which input is problematic; ensure phone numbers are correct and limits are reasonable.
    • If the node throws errors during execution but Continue On Fail is enabled, error details will be included in the output JSON under the error field.

Links and References

Discussion