Actions9
Overview
The Zalo Group node for n8n allows users to manage Zalo chat groups programmatically. The operation "Lấy Tất Cả Nhóm" (Get All Groups) retrieves a list of all Zalo groups associated with the authenticated account. This is useful for automation scenarios such as:
- Listing all groups for reporting or monitoring.
- Syncing group data with other systems.
- Triggering workflows based on group membership or existence.
Example use cases:
- Automatically fetch and display all Zalo groups in a dashboard.
- Periodically back up group information.
- Use group lists to automate invitations or notifications.
Properties
Name | Type | Meaning |
---|---|---|
Giới Hạn | Number | Số lượng nhóm tối đa cần lấy (Maximum number of groups to retrieve). Required field. |
Output
The output will be an array of items, each containing a json
object with the following structure:
{
"response": [ /* Array of group objects as returned by the Zalo API */ ]
}
- response: An array containing details of all Zalo groups retrieved. The exact structure of each group object depends on the Zalo API but typically includes group IDs, names, member counts, etc.
Dependencies
- External Service: Requires access to the Zalo platform via the
zca-js
library. - Credentials: Needs valid Zalo credentials (
zaloApi
) including cookie, IMEI, and user agent. - n8n Configuration: Ensure that the Zalo credential is set up in n8n under the name "Zalo Credential to connect with".
Troubleshooting
Common Issues:
Invalid Credentials: If the provided Zalo credentials (cookie, IMEI, user agent) are incorrect or expired, the node will throw an error:
"No API instance found. Please make sure to provide valid credentials."- Resolution: Double-check and update your Zalo credentials in n8n.
API Limitations: If you request more groups than allowed by the Zalo API, you may receive incomplete results or errors.
- Resolution: Adjust the "Giới Hạn" property to a value within the API's supported range.
Network/Service Errors: Temporary issues with the Zalo service or network connectivity can cause failures.
- Resolution: Retry the operation or check Zalo's service status.
Error Handling: If an error occurs and "Continue On Fail" is enabled, the node will output an item with an
error
field describing the issue.
Links and References
- Zalo Official Website
- n8n Documentation: Custom Nodes
- zca-js GitHub Repository (library used for Zalo API interaction)
Note: The actual content of the response
array depends on the Zalo API and may include fields like group ID, name, members, etc. For detailed field definitions, refer to the Zalo API documentation or the zca-js library documentation.