Zalo Group icon

Zalo Group

Quản lý nhóm Zalo

Actions9

Overview

This node operation allows you to add one or more users to a specified group in the Zalo platform. It is useful for automating group management tasks such as onboarding new members into existing groups without manual intervention. For example, if you manage a community or team on Zalo and want to programmatically add multiple users to a group based on external triggers or workflows, this node operation facilitates that.

Properties

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

Output

The output JSON contains the response from the Zalo API after attempting to add the specified users to the group. This typically includes status information about the operation's success or failure and any relevant details returned by the API.

Example output structure (conceptual):

{
  "json": {
    "response": {
      // API response details about adding users to the group
    }
  },
  "pairedItem": {
    "item": <index_of_input_item>
  }
}

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Zalo platform.
  • Uses a shared Zalo API client internally which requires proper configuration of authentication tokens (cookie, IMEI, user agent).
  • The node depends on the Zalo API service being available and accessible.

Troubleshooting

  • Common issues:

    • Invalid or expired API credentials may cause authentication failures.
    • Incorrect group ID or user IDs can result in errors or no changes.
    • Network connectivity problems can prevent communication with the Zalo API.

  • Error messages:

    • Authentication errors usually indicate invalid or missing API keys; ensure credentials are correctly set up.
    • API response errors related to group or user IDs suggest verifying these values for correctness.
    • If the node throws an error referencing inability to create the API client instance, check that all required parameters (cookie, IMEI, user agent) are properly configured.

  • Resolution tips:

    • Double-check input property values for accuracy.
    • Verify that the API key credential is valid and has necessary permissions.
    • Ensure network access to the Zalo API endpoint.
    • Enable error handling in the workflow to capture and log detailed error messages.

Links and References

Discussion