Actions10
Overview
This node manages Zalo groups by interacting with the Zalo API. Specifically, for the Group resource and the Tạo Ghi Chú (Create Note) operation, it allows users to create a note within a specified Zalo group. The note can optionally be pinned to the top of the group chat.
Common scenarios where this node is useful include:
- Automatically posting important announcements or reminders as notes in a group.
- Pinning key information so all group members see it immediately.
- Integrating Zalo group note creation into workflows that manage team communications or project updates.
Example: A project management workflow could use this node to post daily standup notes or meeting summaries directly into the relevant Zalo group, ensuring all members have quick access to the latest updates.
Properties
| Name | Meaning |
|---|---|
| ID Nhóm | The unique identifier of the Zalo group where the note will be created. |
| Nội Dung Ghi Chú | The content/text of the note to be created in the group. |
| Pin Ghi Chú | Boolean flag indicating whether to pin the note at the top of the group chat (true or false). |
Output
The node outputs an array of JSON objects, each corresponding to an input item processed. For the "Tạo Ghi Chú" operation, the output JSON has the following structure:
{
"status": "Thành công",
"response": { /* response data from Zalo API about the created note */ }
}
status: A string confirming the success of the note creation ("Thành công" means "Success").response: Contains detailed information returned by the Zalo API about the newly created note.
The node does not output binary data.
Dependencies
- Requires valid Zalo API credentials including an API authentication token (cookie), device IMEI, and user agent string.
- The node depends on the external
zca-jslibrary to interact with the Zalo API. - Proper configuration of these credentials in n8n is necessary for successful API communication.
Troubleshooting
- Invalid Credentials: If the node throws an error stating no API instance found or invalid credentials, verify that the provided API cookie, IMEI, and user agent are correct and active.
- API Errors: Errors returned from the Zalo API (e.g., invalid group ID, insufficient permissions) will be surfaced as node errors. Check the group ID and ensure the authenticated user has rights to create notes in the group.
- Pin Flag Issues: Ensure the
Pin Ghi Chúproperty is set correctly as a boolean; incorrect types may cause unexpected behavior. - Continue On Fail: If enabled, the node will continue processing subsequent items even if one fails, returning error details in the output JSON.
Links and References
- Zalo Official API Documentation
- n8n Documentation - Creating Custom Nodes
- zca-js GitHub Repository (library used for Zalo API interaction)