Zalo CN User icon

Zalo CN User

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

Actions10

Overview

This node integrates with the Zalo platform to manage and interact with Zalo users. Specifically, the "Tìm Kiếm Người Dùng" (Find User) operation allows you to search for Zalo users by their phone number. This is useful in scenarios where you want to identify or retrieve information about a user based on their contact number, such as verifying user identities, syncing contacts, or automating friend requests.

Practical examples:

  • Automatically find and add new users who register with their phone numbers.
  • Validate if a phone number corresponds to an existing Zalo user before sending messages.
  • Enrich your CRM data by linking phone numbers to Zalo user profiles.

Properties

Name Meaning
Phone Number The phone number to search for on Zalo.
Limit Maximum number of results to return from the search. Must be at least 1. Default is 50.

Output

The node outputs JSON data representing the found user(s) matching the provided phone number. The exact structure depends on the response from the Zalo API but generally includes user profile details.

Example output JSON snippet:

{
  "id": "user_id",
  "name": "User Name",
  "phoneNumber": "phone_number",
  "avatar": "url_to_avatar",
  ...
}

If multiple users are found (up to the specified limit), they will be included accordingly.

The node does not output binary data.

Dependencies

  • Requires valid Zalo API credentials including authentication cookies, device IMEI, and user agent strings.
  • Uses the zalo-api-final library to communicate with Zalo's API.
  • The node expects these credentials to be configured in n8n beforehand.
  • No additional environment variables are required beyond the credential setup.

Troubleshooting

  • No API instance found error: Indicates invalid or missing credentials. Ensure that the Zalo API credentials are correctly set up with valid cookie, IMEI, and user agent values.
  • Empty or no results returned: Verify the phone number format and ensure the user exists on Zalo.
  • Rate limiting or API errors: May occur if too many requests are sent in a short time. Implement retry logic or reduce request frequency.
  • Continue On Fail behavior: If enabled, the node will continue processing other items even if one fails, returning error details per item.

Links and References

Discussion