Actions9
Overview
This node interacts with Zalo Group functionalities, specifically focusing on managing group members. The operation "Thêm Thành Viên Vào Nhóm" (Add User to Group) allows users to add one or multiple members to a specified Zalo group by providing the group ID and a list of user IDs.
Common scenarios where this node is beneficial include:
- Automating the process of adding new members to a community or team group on Zalo.
- Managing membership in marketing or support groups by programmatically updating group participants.
- Integrating with other workflows that require dynamic group member management based on external triggers or data sources.
Practical example:
- A company uses this node to automatically add new customers to a Zalo support group after they register on their website, ensuring timely communication and support.
Properties
| Name | Meaning |
|---|---|
ID Nhóm (groupId) |
The unique identifier of the Zalo group where members will be added. |
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 user IDs to be added to the group. Multiple users can be added at once by separating their IDs with commas. |
Output
The output JSON structure contains the response from the Zalo API regarding the addition of users to the group. It typically includes details about the success or failure of the operation for each user added.
Example output JSON snippet:
{
"response": {
"success": true,
"addedUserIds": ["userId1", "userId2"],
"message": "Thành công"
}
}
If an error occurs during the operation, the output will contain an error field describing the issue.
The node does not output binary data.
Dependencies
- Requires an API key credential for authenticating with the Zalo platform.
- Depends on the Zalo SDK or API client internally to perform group operations.
- Needs proper configuration of credentials within n8n to access Zalo services.
- The node expects valid cookies, IMEI, and user agent strings as part of the authentication process, which are managed via the stored credentials.
Troubleshooting
Common issues:
- Invalid or expired API credentials leading to authentication failures.
- Incorrect group ID or user IDs causing the API to reject requests.
- Network connectivity problems preventing communication with Zalo servers.
- Improperly formatted user ID lists (e.g., missing commas or extra spaces).
Error messages and resolutions:
"Authentication failed": Verify that the API key credential is correctly set up and has not expired."Group not found": Check that the provided group ID exists and is accessible by the authenticated user."Invalid user IDs": Ensure the user IDs are correct and separated by commas without extra spaces."Rate limit exceeded": Wait and retry later or check if your API usage complies with Zalo's rate limits.
If the node is configured to continue on failure, errors for individual items will appear in the output JSON under the
errorfield.
Links and References
- Zalo Official API Documentation
- Zalo Group Management API Reference
- n8n Documentation on Creating Custom Nodes