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 whenever a new meeting is scheduled.
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 added to 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 JSON structure:
{
"status": "Thành công",
"response": {
// Detailed note creation response from Zalo API
}
}
Dependencies
- Requires valid Zalo API credentials including an API key/token, cookie, IMEI, and user agent details.
- The node uses an external Zalo API client library (
zca-js) to perform operations. - Proper credential configuration 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 have not expired.
- Group ID Errors: Ensure the provided group ID exists and the authenticated user has permission to create notes in that group.
- Content Validation: The note content should not be empty; otherwise, the API may reject the request.
- Pin Flag Issues: The pin boolean must be true or false; incorrect types might cause errors.
- API Rate Limits: Frequent calls might hit Zalo API rate limits; handle such errors by adding delays or retries.
If the node fails and "Continue On Fail" is enabled, the error message will be included in the output JSON under the error field.