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:
- Adding important announcements or reminders as notes in a group.
- Pinning critical information so all group members see it immediately.
- Automating group communication by programmatically creating notes based on external triggers.
Example: Automatically post a meeting agenda as a pinned note in a project group every morning.
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. |
Output
The output JSON contains two main fields:
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 includes metadata about the created note.
No binary data output is produced by this operation.
Example output structure:
{
"status": "Thành công",
"response": {
// Detailed note creation response from Zalo API
}
}
Dependencies
- Requires an API key credential to authenticate with the Zalo API.
- The node uses stored credentials including cookie, IMEI, and user agent strings to establish a session with Zalo.
- The underlying implementation depends on the
zca-jslibrary to interact with the Zalo API.
Troubleshooting
- Invalid Credentials: If the node throws "No API instance found," verify that the provided API credentials (cookie, IMEI, user agent) are valid and not expired.
- Missing Required Fields: Ensure that the "ID Nhóm" and "Nội Dung Ghi Chú" properties are correctly set; these are mandatory.
- API Errors: If the Zalo API returns errors (e.g., permission denied, group not found), check that the authenticated user has appropriate permissions in the target group.
- Pin Flag Issues: If the note does not pin as expected, confirm that the boolean "Pin Ghi Chú" is set correctly.
Links and References
- Zalo Official API Documentation
- n8n Documentation on Creating Custom Nodes
- zca-js GitHub Repository (for the underlying Zalo API client)