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 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 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 node outputs JSON data representing the found user(s) matching the phone number query. The structure depends on the response from the Zalo API but generally includes user profile details such as user ID, name, avatar, and other relevant metadata.

If multiple users are returned (depending on the API behavior), they will be included in the output JSON accordingly.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential to authenticate with the Zalo API.
  • The node uses stored credentials including cookie, IMEI, and user agent strings to establish a session with Zalo.
  • The zca-js library is used internally to interact with the Zalo API.
  • Proper configuration of the Zalo API credentials in n8n is necessary before using this node.

Troubleshooting

  • Common issues:

    • Invalid or expired credentials may cause authentication failures.
    • Providing an incorrect phone number format might result in no users found.
    • Network connectivity problems can 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. Check that the API key and related credentials are correctly configured.
    • Errors returned from the Zalo API will be shown in the output if "Continue On Fail" is enabled; otherwise, they will stop execution. Review error messages for hints on invalid parameters or rate limits.

Links and References

Discussion