Zalo User icon

Zalo User

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

Overview

This node manages Zalo user accounts by interacting with the Zalo platform through an API. It supports various operations such as accepting or sending friend requests, blocking/unblocking users, changing account avatars, updating account settings, retrieving user information, listing friends, and finding users by phone number.

The "Thay đổi cài đặt tài khoản" (Change Account Setting) operation specifically allows updating a user's profile details including display name, date of birth, gender, and language preference.

Practical examples:

  • Automatically update user profile information in bulk based on external data sources.
  • Customize user account settings programmatically after onboarding or during profile updates.
  • Integrate Zalo user management into broader CRM or marketing automation workflows.

Properties

Name Meaning
Name Display name of the Zalo user to set.
Date of Birth User's birth date in the format YYYY-MM-DD.
Gender User's gender; options are Male (1), Female (2), Other (3).
Language Optional language code for the user interface, e.g., "vi" for Vietnamese, "en" for English.

Output

The output JSON contains:

  • status: A string indicating success, typically "Thành công" (Success).
  • response: The raw response object returned from the Zalo API after changing the account settings.

Example output structure:

{
  "status": "Thành công",
  "response": {
    // API response details here
  }
}

No binary data is produced by this operation.

Dependencies

  • Requires a valid Zalo API credential with authentication details including cookie, IMEI, and user agent.
  • Uses the external zca-js library to interact with the Zalo API.
  • Node configuration must include these credentials to authenticate API calls successfully.

Troubleshooting

  • Common issues:

    • Invalid or expired credentials leading to failed login attempts.
    • Incorrect date format for the Date of Birth property causing API errors.
    • Missing required fields like Name, Date of Birth, or Gender.
  • 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/credential is correct and active.
    • Errors related to invalid parameters usually indicate incorrect input values; ensure all required fields are provided and formatted correctly.
  • To handle errors gracefully, enable "Continue On Fail" in the node settings to process subsequent items even if one fails.

Links and References

Discussion