Actions13
Overview
This node manages Zalo groups, specifically allowing operations such as creating groups, retrieving group info, managing members, and more. The "Add User to Group" operation lets you add one or multiple users to an existing Zalo group by specifying the group ID and a list of user IDs.
Common scenarios include:
- Automating member management in Zalo groups for community or team coordination.
- Adding new participants to discussion groups programmatically.
- Integrating Zalo group membership updates into broader workflows, e.g., onboarding processes.
Example: Automatically add newly registered users to a specific Zalo group by passing their user IDs and the target group ID.
Properties
| Name | Meaning |
|---|---|
| ID Nhóm (groupId) | The unique identifier of the Zalo group where users will be added. |
| Danh Sách ID Thành Viên (userIds) | Comma-separated list of user IDs to add to the group. |
Output
The output JSON contains the response from the Zalo API after attempting to add users to the group. It typically includes details about the operation's success or failure and any relevant data returned by the API.
Example output structure:
{
"json": {
// Response object from the Zalo API indicating result of adding users
},
"pairedItem": {
"item": 0
}
}
No binary data is output by this operation.
Dependencies
- Requires a valid Zalo API credential with authentication details including cookie, IMEI, and user agent.
- Uses the
zca-jslibrary to interact with the Zalo API. - Node configuration must include these credentials to authenticate API requests.
Troubleshooting
- Invalid Credentials: If the node throws "No API instance found," ensure that the provided Zalo API credentials are correct and contain valid cookie, IMEI, and user agent values.
- Malformed User IDs: Ensure the user IDs string is properly formatted as comma-separated values without extra spaces or invalid characters.
- API Errors: Any errors returned by the Zalo API (e.g., user not found, group not found) will be surfaced in the node output. Check the response message for details.
- Continue on Fail: If enabled, the node will continue processing other items even if one fails, returning error details in the output JSON.
Links and References
- Zalo Official API Documentation
- n8n Documentation on Creating Custom Nodes
- zca-js GitHub Repository (for underlying Zalo API client)