Zalo Tag icon

Zalo Tag

Quản lý thẻ (tag) trong Zalo

Overview

This node, named "Zalo Tag," is designed to manage tags (labels) within the Zalo platform. It currently supports listing all tags associated with a Zalo account. This functionality is useful for users who want to retrieve and work with their existing Zalo tags, such as for organizing contacts or messages by categories.

A practical example would be a marketing automation workflow where you need to fetch all available tags from Zalo to dynamically assign them to contacts or segment audiences based on these tags.

Properties

Name Meaning
Hành đỘng Action to perform; options: "Danh Sách Thẻ" (List all tags)

Output

The node outputs an array of JSON objects, each containing:

  • success: A boolean indicating if the operation was successful (true).
  • labels: An array of tag objects retrieved from Zalo.

Example output JSON structure:

{
  "success": true,
  "labels": [
    {
      "id": "tag_id_1",
      "name": "Tag Name 1",
      ...
    },
    {
      "id": "tag_id_2",
      "name": "Tag Name 2",
      ...
    }
  ]
}

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential to connect to Zalo's API.
  • Uses the zca-js library to interact with Zalo services.
  • The node expects credentials that include a cookie, IMEI, and user agent string for authentication.
  • Proper configuration of the Zalo API credential in n8n is necessary before using this node.

Troubleshooting

  • Login Initialization Failure: If the node cannot initialize the Zalo API client, it throws an error indicating failure to start the API and suggests checking login information. This usually means the provided credentials are invalid or expired.
  • Login Error Message: Errors during login will include the message "Lỗi đăng nhập Zalo" followed by the specific error detail. To resolve, verify that the cookie, IMEI, and user agent values in the credentials are correct and up to date.
  • Ensure that the Zalo API credentials have not expired and have the necessary permissions to access tag information.

Links and References

Discussion