Actions10
Overview
This node manages Zalo groups, specifically allowing users to perform various group-related operations via the Zalo API. The "Tạo Ghi Chú" (Create Note) operation lets users add a note to a specified Zalo group, optionally pinning it to the top of the group chat.
Common scenarios for this node include:
- Adding important announcements or reminders as pinned notes in a group.
- Collaborating within a team by sharing key information directly in the group.
- Managing group content dynamically through automation workflows.
Example use case: Automatically post and pin meeting agendas or daily updates as notes in a project group on Zalo.
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 textual content of the note to be added to the group. |
| Pin Ghi Chú | Boolean option to pin the note at the top of the group chat (true = pin, false = no pin). |
Output
The output JSON contains:
status: A string indicating the success status, typically"Thành công"meaning "Success".response: The detailed response object returned from the Zalo API after creating the note. This may include metadata about the created note such as its ID, timestamp, and pin status.
No binary data is output by this node.
Example output JSON structure:
{
"status": "Thành công",
"response": {
"noteId": "123456789",
"content": "Meeting agenda for tomorrow",
"pinAct": true,
"createdAt": "2024-06-01T10:00:00Z"
}
}
Dependencies
- Requires an active connection to the Zalo API using valid credentials that provide cookie, IMEI, and user agent information.
- The node depends on the external
zca-jslibrary to interact with the Zalo API. - Proper configuration of the Zalo API credential in n8n is necessary to authenticate requests.
Troubleshooting
- Invalid Credentials: If the node throws an error about missing or invalid API instance, verify that the Zalo API credentials are correctly set up and contain valid cookie, IMEI, and user agent values.
- Group Not Found: Errors related to invalid group IDs usually mean the provided group ID does not exist or the authenticated user lacks access. Double-check the group ID.
- Permission Issues: If pinning fails or note creation is denied, ensure the authenticated user has sufficient permissions in the target group.
- Network/Timeout Errors: These can occur if the Zalo API is unreachable. Retry later or check network connectivity.
- Use the "Continue On Fail" option to handle errors gracefully in bulk operations.
Links and References
- Zalo Official API Documentation
- n8n Documentation - Creating Custom Nodes
- zca-js GitHub Repository (for the underlying Zalo API client library)