Mtai Zalo Group icon

Mtai Zalo Group

Quản lý nhóm Zalo

Actions9

Overview

This node manages Zalo groups by interacting with the Zalo API. It supports various group-related operations such as creating a group, retrieving group information, managing group members and deputies, changing group details like avatar or name, and listing all groups.

The specific operation "Lấy Thông Tin Nhóm" (Get Group Info) retrieves detailed information about a specified Zalo group by its ID. This is useful for scenarios where you need to fetch metadata about a group, such as member lists, admins, or other group attributes, for reporting, monitoring, or automation purposes.

Practical example:
You want to automate sending notifications or updates based on group membership changes. First, you retrieve the group's info to get current members and admins, then use that data in subsequent workflow steps.

Properties

Name Meaning
ID Nhóm The unique identifier of the Zalo group whose information you want to retrieve.

Output

The output JSON contains two main fields:

  • response: The full raw response object returned from the Zalo API containing all group data.
  • groupInfo: A subset of the response focused on the specific group identified by the provided group ID. This includes detailed information such as:
    • Member IDs
    • Admin IDs
    • Current members
    • Updated members
    • Total number of members

Example output structure (simplified):

{
  "response": { /* full API response */ },
  "groupInfo": {
    "memberIds": ["user1", "user2", "..."],
    "adminIds": ["admin1", "admin2", "..."],
    "currentMems": [...],
    "updateMems": [...],
    "totalMember": 123
  }
}

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.
  • Properly configured Zalo API credentials must be set up in n8n before using this node.

Troubleshooting

  • Common issues:

    • Invalid or expired credentials will cause authentication failures.
    • Providing an incorrect or non-existent group ID will result in errors or empty responses.
    • Network connectivity problems can prevent API calls from succeeding.

  • Error messages:

    • "No API instance found. Please make sure to provide valid credentials."
      Means the node could not authenticate with Zalo API. Check your credentials and ensure they are valid and complete.
    • Errors related to missing parameters (e.g., groupId) indicate required inputs were not provided.
    • API errors returned from Zalo may appear in the output under an error field if "Continue On Fail" is enabled.

  • Resolution tips:

    • Verify and refresh your Zalo API credentials.
    • Double-check the group ID input for correctness.
    • Enable "Continue On Fail" to handle partial failures gracefully during batch processing.

Links and References

Discussion