Zalo Group icon

Zalo Group

Quản lý nhóm Zalo

Actions16

Overview

This node manages Zalo Groups by interacting with the Zalo API. It supports various group-related operations such as creating groups, retrieving group information, managing members and deputies, changing group details (name, avatar, owner), handling notes within groups, dispersing groups, and fetching all groups associated with the authenticated user.

The specific operation "Lấy Tất Cả Nhóm" ("Get All Groups") retrieves a list of all groups that the authenticated user is part of.

Common scenarios:

  • Automating group management tasks in Zalo for community managers or businesses.
  • Synchronizing group data from Zalo into other systems.
  • Bulk processing or reporting on groups and their members.
  • Creating polls or notes inside groups to engage members.

Practical example:

  • A marketing team wants to fetch all their Zalo groups to analyze member counts and activity.
  • An admin wants to programmatically add or remove users from multiple groups.
  • Automatically update group avatars or names based on external triggers.

Properties

Name Meaning
Giới Hạn (limit) The maximum number of groups to retrieve when fetching all groups. Defaults to 50.

Note: The provided property applies specifically to the "Lấy Tất Cả Nhóm" operation under the Group resource.

Output

The output JSON structure for the "Lấy Tất Cả Nhóm" operation contains:

  • response: An array or object representing all groups retrieved from the Zalo API.

Example output snippet:

{
  "response": [
    {
      "groupId": "12345",
      "groupName": "My Zalo Group",
      "memberCount": 100,
      ...
    },
    ...
  ]
}

The exact fields depend on the Zalo API response but generally include group identifiers, names, and metadata.

No binary data output is produced by this operation.

Dependencies

  • Requires valid Zalo API credentials including an API key credential with cookie, IMEI, and user agent information.
  • Uses the zca-js library to interact with the Zalo API.
  • Node expects these credentials to be configured in n8n prior to execution.
  • No additional environment variables are explicitly required beyond the credential setup.

Troubleshooting

  • Invalid Credentials: If the node throws "No API instance found," it indicates invalid or missing Zalo API credentials. Ensure the API key credential is correctly set up with valid cookie, IMEI, and user agent values.
  • API Rate Limits or Errors: The Zalo API may limit requests or return errors if usage exceeds quotas or parameters are incorrect.
  • Empty Response: If no groups are returned, verify that the authenticated user actually belongs to any groups.
  • Parameter Issues: The "Giới Hạn" (limit) must be a positive number; otherwise, the API call might fail or return unexpected results.
  • Network Issues: Connectivity problems can cause failures; check network access to Zalo API endpoints.

Links and References

Discussion