Actions9
Overview
This node manages Zalo groups by interacting with the Zalo API. It allows users to create new groups, retrieve group information, add or remove members, change group names or avatars, and list all groups. This is useful for automating group management tasks in Zalo, such as setting up new discussion groups with specific members or updating group details programmatically.
A practical example is creating a new Zalo group with a given name and a list of member IDs, which can be used to quickly organize team chats or customer support groups without manual setup in the Zalo app.
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 be added to the group upon creation. |
Output
The output JSON structure after creating a group contains the response from the Zalo API's createGroup method. This typically includes details about the newly created group such as its ID, name, and member list.
Example output JSON snippet:
{
"id": "123456789",
"name": "My New Group",
"members": ["userId1", "userId2", "userId3"]
}
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential to authenticate with the Zalo API.
- Uses the
zca-jslibrary internally to interact with Zalo services. - The node expects valid credentials including cookie, IMEI, and user agent strings either from the credential or input data.
- Proper configuration of the Zalo API credential in n8n is necessary.
Troubleshooting
- Invalid Credentials: If the node throws "No API instance found," it means the provided credentials are invalid or incomplete. Ensure that the API key credential includes valid cookie, IMEI, and user agent values.
- Malformed User IDs: The user IDs must be provided as a comma-separated string without extra spaces or invalid characters. Incorrect formatting may cause API errors.
- API Rate Limits or Permissions: If the Zalo API rejects requests due to rate limits or insufficient permissions, verify your account's API access rights.
- Continue on Fail: If enabled, the node will continue processing other items even if one fails, returning error messages in the output JSON under the
errorfield.
Links and References
- Zalo Official API Documentation
- n8n Documentation on Creating Custom Nodes
- zca-js GitHub Repository (for internal API client)