Zalo Group icon

Zalo Group

Quản lý nhóm Zalo

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.

Typical use cases include:

  • Adding important announcements or reminders as notes in a group.
  • Pinning critical information so all group members see it immediately.
  • Automating note creation in group chats based on external triggers or workflows.

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 created in the group.
Pin Ghi Chú Boolean option to pin the note at the top of the group chat (true = pinned, false = not pinned).

Output

The node outputs a JSON object containing:

  • status: A string indicating success, e.g., "Thành công" ("Success").
  • response: The raw response from the Zalo API after creating the note, which may include details about the created note such as its ID, timestamp, or other metadata.

No binary data output is produced by this operation.

Example output JSON structure:

{
  "status": "Thành công",
  "response": {
    /* API response details about the created note */
  }
}

Dependencies

  • Requires valid Zalo API credentials including an API key/token, cookie, IMEI, and user agent string.
  • 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

  • Common issues:
    • Invalid or expired credentials leading to authentication failures.
    • Incorrect group ID causing "group not found" errors.
    • Network connectivity problems preventing API calls.
  • Error messages:
    • "No API instance found. Please make sure to provide valid credentials." — indicates missing or invalid credentials; verify and re-enter credentials.
    • Errors returned from the Zalo API (e.g., permission denied, invalid parameters) will be surfaced; check that the group ID and note content are correct.
  • To handle errors gracefully, enable "Continue On Fail" in the node settings to process subsequent items even if one fails.

Links and References

Discussion