Zalo User icon

Zalo User

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

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, enriching contact information, or automating friend requests.

Practical examples:

  • Automatically find and add users who register on your platform by their phone number.
  • Retrieve user profile data for customer support or CRM integration.
  • Filter and segment users based on phone number lookups.

Properties

Name Meaning
Phone Number The phone number of the Zalo user to search for. This is a required string input.
Limit The maximum number of results to return. This is a required numeric input (default 50).

Output

The output JSON structure contains the user data returned from the Zalo API's findUser method. It typically includes user profile information matching the searched phone number.

Example output JSON snippet (conceptual):

{
  "id": "user_id",
  "name": "User Name",
  "phoneNumber": "searched_phone_number",
  "avatar": "url_to_avatar",
  "status": "active",
  ...
}

If multiple users are found (depending on API behavior), the output may include an array or multiple entries accordingly.

No binary data output is produced by this operation.

Dependencies

  • Requires valid Zalo API credentials including cookie, IMEI, and user agent information.
  • The node uses an external Zalo API client library (zca-js) to perform operations.
  • Credentials must be configured properly in n8n to authenticate API requests.

Troubleshooting

  • Common issues:

    • Invalid or expired credentials leading to authentication failure.
    • Missing or malformed phone number input causing no results or errors.
    • API rate limits or network connectivity problems.

  • Error messages:

    • "No API instance found. Please make sure to provide valid credentials."
      Means the node could not authenticate with Zalo API. Check credential configuration.
    • Errors containing "error" field in output indicate individual item failures when "Continue On Fail" is enabled.

  • Resolutions:

    • Verify and refresh Zalo API credentials.
    • Ensure phone numbers are correctly formatted.
    • Use "Continue On Fail" option to handle partial failures gracefully.

Links and References

Discussion