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 data.

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 result of the user search operation. It typically includes user details returned by the Zalo API for the given phone number. The exact structure depends on the API response but generally includes user identification and profile information.

Example output snippet (conceptual):

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

No binary data output is produced by this operation.

Dependencies

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

Troubleshooting

  • Common issues:

    • Invalid or expired credentials may cause authentication failures.
    • Missing or incorrect phone number input will prevent successful user lookup.
    • Network connectivity problems can interrupt API calls.

  • Error messages:

    • "No API instance found. Please make sure to provide valid credentials."
      Means the node could not authenticate with Zalo API. Verify that the API key and related credentials are correctly configured.
    • Errors containing "error" in the output JSON indicate individual item processing failures; enabling "Continue On Fail" allows the workflow to proceed despite these errors.

  • Resolution tips:

    • Double-check the API credentials and refresh them if needed.
    • Ensure the phone number format matches expected input.
    • Enable "Continue On Fail" during testing to isolate problematic inputs.

Links and References

Discussion