Zalo Group icon

Zalo Group

Quản lý nhóm Zalo

Actions9

Overview

This node allows you to manage members within a Zalo Group, specifically focusing on the operation "Add User to Group." It enables adding one or multiple users to a specified group by their user IDs. This is useful in scenarios where you want to automate group membership management, such as onboarding new team members into a communication group or managing community memberships programmatically.

Practical examples:

  • Automatically add new employees to a company Zalo group.
  • Add participants to an event group based on registration data.
  • Manage group memberships dynamically from external systems.

Properties

Name Meaning
ID Nhóm (groupId) The unique identifier of the Zalo group where users will be added.
Danh Sách ID Thành Viên (userIds) A comma-separated list of user IDs to be added to the group.

Output

The output is an array of JSON objects, each corresponding to an input item processed. For the "Add User to Group" operation, each output JSON contains the response from the Zalo API after attempting to add the specified users to the group. The structure typically includes success status and any relevant details returned by the API.

Example output JSON structure:

{
  "json": {
    "response": {
      // API response details about the add operation
    }
  },
  "pairedItem": {
    "item": 0
  }
}

No binary data output is produced by this node.

Dependencies

  • Requires valid Zalo API credentials with permissions to manage groups.
  • The node uses an API client internally that requires authentication via cookies, IMEI, and user agent strings obtained from the credentials.
  • Proper configuration of these credentials in n8n is necessary for successful API calls.

Troubleshooting

  • Common issues:

    • Invalid or expired credentials leading to authentication failures.
    • Incorrect group ID or user IDs causing API errors.
    • Network connectivity problems affecting API requests.

  • Error messages:

    • "No API instance found. Please make sure to provide valid credentials."
      Means the node could not initialize the API client due to missing or invalid credentials. Verify your credential setup.
    • API errors returned in the response JSON may indicate issues like invalid user IDs or insufficient permissions.

  • Resolution tips:

    • Double-check the group ID and user IDs format (comma-separated).
    • Ensure the API key or authentication tokens are current and have required scopes.
    • Enable error handling in the workflow to catch and log detailed error information.

Links and References

Discussion