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 via the Zalo platform API. Specifically, the "Tìm kiếm người dùng" (Find User) operation allows searching for a Zalo user by their phone number.

Common scenarios where this node is useful include:

  • Automating user lookups in Zalo based on phone numbers collected from other systems.
  • Integrating Zalo user data retrieval into workflows for customer support or marketing.
  • Enriching contact records with Zalo user information.

For example, you can input a phone number and retrieve detailed user information associated with that number on Zalo, enabling personalized communication or verification processes.

Properties

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

Output

The output JSON structure depends on the operation but for the "findUser" operation it returns the user data found by the search. The exact fields depend on the Zalo API response but typically include user profile details such as user ID, name, avatar, and other public information.

Output example 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 authenticate with the Zalo platform.
  • Uses stored cookie, IMEI, and user agent values from credentials or input data to establish the API session.
  • Depends on the external zca-js library for interacting with the Zalo API.

Troubleshooting

  • Invalid Credentials: If the node throws "No API instance found," ensure that valid Zalo API credentials are provided, including correct cookie, IMEI, and user agent values.
  • User Not Found: If no user matches the phone number, the output may be empty or null. Verify the phone number format and existence on Zalo.
  • Rate Limits or API Errors: The Zalo API might limit requests or return errors; handle these by enabling "Continue On Fail" to avoid workflow interruption.
  • Missing Required Parameters: Ensure "Phone Number" and "Limit" are set correctly; missing or invalid inputs will cause errors.

Links and References

Discussion