Zalo Tag

Overview

This node integrates with the Zalo platform to manage tags (labels). Its primary function is to list all available tags associated with a Zalo account. This can be useful in scenarios where you want to organize or segment contacts, messages, or other entities on Zalo by tags for targeted communication or analytics.

Practical examples:

• Automatically retrieving and displaying all tags from a Zalo account to allow users to select one for further processing.
• Synchronizing Zalo tags with another system or database.
• Using the list of tags to filter or categorize incoming messages or contacts in an automation workflow.

Properties

The property "Hành đỘng" lets the user choose the action the node will execute. Currently, it supports only one action: listing all tags.

Output

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

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

Example output 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 for authenticating with the Zalo platform.
• Uses an internal Zalo SDK or API client to communicate with Zalo services.
• The node expects stored authentication data including cookies, device identifiers, and user agent strings to establish a session.
• No additional environment variables are explicitly required beyond the configured credentials.

Troubleshooting

Common Issues

• Authentication failure: If the stored cookie or device information is invalid or expired, the node will fail to connect to Zalo and throw an error.
• Network issues: Connectivity problems may prevent the node from retrieving tags.
• Empty tag list: If no tags exist on the Zalo account, the returned labels array will be empty.

Error Messages

• "Zalo login failed": Indicates that the node could not authenticate with Zalo using the provided credentials. To resolve, verify the API key and authentication data are correct and up to date.
• "Failed to get labels": Occurs if the request to fetch tags fails. Check network connectivity and API permissions.
• Other errors include detailed messages concatenated with the original error message to aid debugging.

Links and References

• Zalo Official Developer Documentation
• Zalo API Reference
• n8n documentation on Creating Custom Nodes