Zalo Group icon

Zalo Group

Quản lý nhóm Zalo

Actions16

Overview

This node manages Zalo groups, specifically providing operations to create, modify, retrieve information about, and manage members of Zalo chat groups. The "Giải Tán Nhóm" (Disperse Group) operation allows users to disband or dissolve a specified Zalo group by its ID.

Common scenarios for this node include automating group management tasks such as creating new groups, adding or removing members, changing group details, and ultimately dissolving groups that are no longer needed. For example, a community manager could use this node to automatically disperse inactive groups after a certain period or event.

Practical example:

  • Automatically disperse a Zalo group after an event ends by providing the group's ID to the "Giải Tán Nhóm" operation, helping keep group lists clean and relevant.

Properties

Name Meaning
ID Nhóm The unique identifier (ID) of the Zalo group to be dispersed (dissolved). This is a required string input.

Output

The output JSON object contains:

  • status: A string indicating the success status, typically "Thành công" meaning "Success".
  • response: The raw response from the Zalo API related to the disperse group action, which may contain additional details about the operation result.

Example output JSON structure:

{
  "status": "Thành công",
  "response": { /* API response data */ }
}

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.
  • The node uses the external zca-js library to interact with the Zalo API.
  • Proper configuration of the Zalo API credential in n8n is necessary to authenticate requests.

Troubleshooting

  • Common issues:

    • Invalid or expired credentials can cause authentication failures.
    • Providing an incorrect or non-existent group ID will likely result in an error from the API.
    • Network connectivity problems may prevent successful API calls.

  • Error messages:

    • "No API instance found. Please make sure to provide valid credentials."
      Means the node failed to initialize the Zalo API client due to missing or invalid credentials. Solution: Verify and re-enter the Zalo API credentials.
    • Errors returned from the Zalo API when the group ID is invalid or the user does not have permission to disperse the group. Solution: Confirm the group ID is correct and that the authenticated user has sufficient rights.

  • Enabling "Continue On Fail" in the node settings can help handle errors gracefully during batch executions.

Links and References

Discussion