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

Practical examples:

  • Automatically find and add users to your Zalo friend list by their phone numbers.
  • Retrieve user profile information for customer support or CRM integration.
  • Filter or segment users based on phone number searches within automated workflows.

Properties

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

Output

The output JSON contains the data returned by the Zalo API's user search method. It typically includes user details matching the searched phone number. The exact structure depends on the API response but generally includes user identifiers and profile information.

If an error occurs during execution, the output will contain an error field with the error message.

No binary data output is produced by this operation.

Example output snippet (simplified):

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

Dependencies

  • Requires valid Zalo API credentials including authentication tokens such as cookies, device IMEI, and user agent strings.
  • The node uses an external Zalo API client library to perform operations.
  • Proper configuration of the Zalo API credential in n8n is necessary before using this node.

Troubleshooting

  • Common issues:

    • Invalid or expired credentials can cause authentication failures.
    • Missing or incorrect phone number input will result in no user found or errors.
    • Network connectivity problems may prevent API calls from succeeding.

  • Error messages:

    • "No API instance found. Please make sure to provide valid credentials."
      Means the node could not authenticate with Zalo API. Check that credentials are correctly set and valid.
    • Errors returned from the API (e.g., user not found) will be shown in the output under the error field if "Continue On Fail" is enabled.

  • Resolution tips:

    • Verify and refresh your Zalo API credentials.
    • Ensure the phone number format matches expected input.
    • Enable "Continue On Fail" to handle individual item errors gracefully in batch executions.

Links and References

Discussion