Zalo User icon

Zalo User

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

Actions10

Overview

The node "Zalo User" provides various operations to manage and interact with Zalo users 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. This is useful in scenarios where you want to identify or retrieve information about a user based on their phone contact.

Practical examples include:

  • Verifying if a phone number corresponds to a registered Zalo user.
  • Fetching user details for contact enrichment or CRM integration.
  • Automating friend requests or messaging workflows after identifying users.

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 contains the data returned by the Zalo API's user search method. It typically includes user information matching the searched phone number. The exact fields depend on the API response but generally represent user profile details.

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, IMEI, and user agent strings to establish a session.
  • The external dependency is the zca-js library which handles the Zalo API interactions.
  • Proper configuration of the Zalo API credential in n8n is necessary before using this node.

Troubleshooting

  • Common issues:

    • Invalid or expired credentials may cause login failure.
    • Missing or incorrect phone number input will prevent successful user search.
    • Network or API rate limiting errors can occur if too many requests are made.

  • Error messages:

    • "No API instance found. Please make sure to provide valid credentials."
      Means the node failed to authenticate with Zalo API. Check your API credentials and ensure they are valid.
    • Errors related to invalid parameters usually indicate missing required inputs like phone number.
    • If the node throws errors during execution, enabling "Continue On Fail" can help process other items without stopping the workflow.

Links and References

Discussion