Zalo Group icon

Zalo Group

Quản lý nhóm Zalo

Overview

This node manages Zalo groups, specifically enabling operations such as creating notes within a group. The "Tạo Ghi Chú" (Create Note) operation allows users to add a note with specified content to a Zalo group and optionally pin it at the top of the group chat. This is useful for highlighting important messages or announcements in group conversations.

Practical examples:

  • Pinning meeting agendas or reminders in a team chat.
  • Adding important updates or instructions that all group members should see immediately.

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 to pin, false otherwise).

Output

The output JSON contains:

  • status: A string indicating the success status, typically "Thành công" (Success).
  • response: The detailed response object returned from the Zalo API after creating the note, which may include metadata about the note creation.

No binary data is output by this node.

Example output structure:

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

Dependencies

  • Requires an API key credential to authenticate with the Zalo platform.
  • Uses the zca-js library internally to interact with the Zalo API.
  • Requires valid cookie, IMEI, and user agent information either from credentials or input data for authentication.

Troubleshooting

  • Common issues:

    • Invalid or expired credentials leading to authentication failure.
    • Incorrect group ID causing the note creation to fail.
    • Network or API errors from the Zalo service.
  • Error messages:

    • "No API instance found. Please make sure to provide valid credentials."
      Resolution: Verify that the API key credential is correctly configured and valid.
    • Errors related to invalid parameters (e.g., missing group ID or content)
      Resolution: Ensure all required fields are provided and correctly formatted.
    • API response errors due to permission issues or group restrictions
      Resolution: Confirm the authenticated user has permissions to create notes in the specified group.

If the node is set to continue on failure, errors will be returned in the output JSON under an error field instead of stopping execution.

Links and References

Discussion