Actions10
Overview
This node manages Zalo groups by interacting with the Zalo API. It allows users to create new groups, retrieve group information, manage members and deputies, update group details like name and avatar, and handle group notes. This is useful for automating group management tasks in Zalo, such as setting up new groups with specific members or updating group settings programmatically.
A practical example: Automatically creating a new Zalo group with a list of user IDs after onboarding new team members, or fetching detailed info about existing groups to synchronize with an external system.
Properties
| Name | Meaning |
|---|---|
| Tên Nhóm (groupName) | The name of the new group to be created. |
| Danh Sách ID Thành Viên (nếu nhiều người dùng vui lòng phân cách bằng dấu phẩy) (userIds) | A comma-separated list of member IDs to include in the group. |
Output
The output JSON structure depends on the operation but for the "Tạo Nhóm" (createGroup) operation specifically, the node returns:
json: An object representing the newly created group as returned by the Zalo API. This typically includes group identifiers and metadata confirming creation.
For other operations (not requested here), outputs may include group info objects, status messages, lists of members/admins, or responses from various group-related API calls.
No binary data output is produced by this node.
Dependencies
- Requires valid Zalo API credentials including authentication tokens such as cookies, device IMEI, and user agent strings.
- The node uses an external Zalo API client library (
zca-js) to perform API calls. - Credentials must be configured properly in n8n to allow authenticated access to Zalo services.
Troubleshooting
- Invalid Credentials: If the node throws "No API instance found. Please make sure to provide valid credentials," verify that the Zalo API credentials are correctly set and not expired.
- Malformed User IDs: Ensure the user IDs string is correctly formatted as comma-separated values without extra spaces or invalid characters.
- API Rate Limits or Permissions: Some operations might fail if the authenticated user lacks permissions or if API rate limits are exceeded.
- Continue On Fail: If enabled, the node will continue processing subsequent items even if one fails, returning error messages in the output JSON under
error.
Links and References
- Zalo Official Developer Documentation
- n8n Documentation - Creating Custom Nodes
- zca-js GitHub Repository (Zalo Client API library used internally)