Zalo User icon

Zalo User

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

Actions12

Overview

This node interacts with Zalo User accounts, providing various user management operations through the Zalo 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 contact number, such as verifying user existence, fetching profile details, or integrating Zalo user data into other workflows.

Practical examples:

  • Automatically find and verify users who register on your platform using their phone numbers.
  • Enrich customer records with Zalo user information for marketing or support purposes.
  • Build automated friend request flows by first finding users via their phone numbers.

Properties

Name Meaning
Phone Number The phone number of the user to search for on Zalo. This is a required string input.
Limit The maximum number of results to return from the search. This is a required numeric input, typically set to 50 by default.

Output

The output JSON contains the result of the user search operation. It includes user data returned by the Zalo API corresponding to the searched phone number. The exact structure depends on the API response but generally includes user profile details.

Example output structure (simplified):

{
  "userId": "string",
  "name": "string",
  "avatar": "string",
  "phoneNumber": "string",
  "otherUserDetails": "..."
}

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the Zalo API via credentials that include authentication tokens such as cookies, device IMEI, and user agent strings.
  • The node depends on the external zca-js library to interact with the Zalo API.
  • Proper configuration of the Zalo API credential within n8n is necessary to authenticate requests.

Troubleshooting

  • Common issues:

    • Invalid or expired credentials may cause authentication failures.
    • Providing an incorrect or malformed phone number can lead to no results or errors.
    • Network connectivity problems can prevent API calls from succeeding.

  • Error messages:

    • "No API instance found. Please make sure to provide valid credentials."
      This indicates missing or invalid Zalo API credentials. Verify and update the credentials in the node settings.
    • Errors related to rate limits or API restrictions should be handled by checking Zalo API usage policies.
    • If the node throws errors during execution, enabling "Continue On Fail" can help process multiple items without stopping the workflow.

Links and References

Discussion