Zalo Group icon

Zalo Group

Quản lý nhóm Zalo

Actions10

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 reminders in group conversations.

Practical examples:

  • Pinning meeting agendas or announcements in a team chat.
  • Adding quick notes or instructions visible to all group members.
  • Keeping track of important updates by pinning notes in project groups.

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" meaning "Success".
  • response: The detailed response object returned from the Zalo API after creating the note, which may include metadata about the note creation.

Example output structure:

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

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential to authenticate with the Zalo platform.
  • Uses the zca-js library internally to interact with Zalo's API.
  • Requires valid cookie, IMEI, and user agent information for authentication, either provided via credentials or input data.
  • Must have the Zalo API credential configured in n8n with appropriate permissions to manage groups and create notes.

Troubleshooting

  • Common issues:

    • Invalid or expired authentication credentials can cause failures in connecting to the Zalo API.
    • Incorrect group ID or insufficient permissions may result in errors when creating notes.
    • Network connectivity problems can interrupt API calls.

  • Error messages:

    • "No API instance found. Please make sure to provide valid credentials."
      Resolution: Verify that the API key credential is correctly set up and includes valid cookie, IMEI, and user agent values.
    • Errors related to invalid group IDs or unauthorized actions usually indicate permission issues or wrong input parameters. Double-check the group ID and ensure the authenticated user has rights to post notes.
    • If the node throws errors but "Continue On Fail" is enabled, error details will appear in the output JSON under the error field for each failed item.

Links and References

Discussion