Zalo Group icon

Zalo Group

Quản lý nhóm Zalo

Actions10

Overview

This node manages Zalo groups, specifically allowing users to perform various group-related operations via the Zalo API. For the "Group" resource and the "Tạo Ghi Chú" (Create Note) operation, it enables creating a note within a specified Zalo group. This is useful for adding important messages or reminders pinned at the top of the group chat.

Practical examples:

  • Pinning an announcement or event reminder in a team’s Zalo group.
  • Adding a note with instructions or guidelines for group members.
  • Highlighting urgent information that should stay visible in the group.

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/false).

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 may include metadata about the created note.

No binary data output is produced by this operation.

Example output structure:

{
  "status": "Thành công",
  "response": {
    // Details about the created note from Zalo API
  }
}

Dependencies

  • Requires a valid Zalo API credential with authentication details such as cookie, IMEI, and user agent.
  • Uses the external zca-js library to interact with the Zalo API.
  • The node expects these credentials to be configured properly in n8n before execution.

Troubleshooting

  • Common issues:

    • Invalid or expired credentials can cause authentication failures.
    • Incorrect group ID or insufficient permissions may result in errors when creating notes.
    • Network or API downtime could lead to request failures.

  • Error messages:

    • "No API instance found. Please make sure to provide valid credentials."
      Means the node failed to authenticate with Zalo API. Check your API credentials and ensure they are correct and active.
    • Errors related to invalid parameters (e.g., missing group ID or content) will be thrown if required inputs are not provided.
    • If the node is set to continue on fail, errors will be returned in the output JSON under an error field for each failed item.

Links and References

Discussion