Zalo User icon

Zalo User

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

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 fetch user profiles from Zalo by inputting phone numbers collected from other sources.
  • Use the found user data to trigger further workflows like sending friend requests or messaging.

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 contains the user data returned by the Zalo API for the searched phone number. The structure depends on the API response but typically includes user profile details such as user ID, name, avatar, and other public information.

Example output snippet (conceptual):

{
  "userId": "123456789",
  "name": "Nguyen Van A",
  "avatar": "https://...",
  "phoneNumber": "0987654321",
  ...
}

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential to connect to the Zalo API service.
  • The node uses stored credentials including cookie, device IMEI, and user agent strings to authenticate requests.
  • The underlying implementation relies on the zca-js library to interact with Zalo's API.

Troubleshooting

  • Invalid Credentials: If the node throws "No API instance found," it indicates invalid or missing credentials. Ensure that the API key and related authentication details are correctly configured.
  • User Not Found: If no user matches the provided phone number, the output may be empty or contain an error message. Verify the phone number format and existence.
  • Rate Limits or API Errors: The Zalo API might limit request rates or reject malformed requests. Check API usage limits and ensure all parameters are valid.
  • Continue On Fail: If enabled, the node will continue processing subsequent items even if one fails, returning error messages per item.

Links and References

Discussion