Nqdev: Tích hợp EsmsVNInstall

Overview

This node integrates with the EsmsVN API to send SMS and OTT messages, including Zalo ZNS templates. It supports multiple resources such as accounts, SMS messages, and OTT messages, allowing users to perform various operations like sending messages or retrieving template details.

Specifically, for the OTT Message resource and the Chi tiết ZNS Template operation, the node fetches detailed information about a Zalo ZNS message template. This is useful when you want to retrieve metadata or content structure of a specific Zalo notification service (ZNS) template before sending messages based on it.

Practical examples:

• Retrieve details of a Zalo ZNS template to preview its content or validate its parameters.
• Use the template information to dynamically construct personalized notifications in workflows.
• Manage and audit available Zalo ZNS templates linked to your Official Account.

Properties

Output

The node outputs JSON data representing the result of the requested operation. For the "Chi tiết ZNS Template" operation, the output JSON contains detailed information about the specified Zalo ZNS template, such as its ID, name, content structure, and other metadata provided by the EsmsVN API.

If multiple items are processed, the output is an array of such JSON objects.

No binary data output is indicated in the source code.

Dependencies

• Requires an active connection to the EsmsVN API endpoint (https://rest.esms.vn).
• Needs an API key credential configured in n8n to authenticate requests to EsmsVN.
• Uses internal helper libraries bundled with the node for loading options and searching lists (e.g., Zalo OA list, ZNS templates).

Troubleshooting

• Common issues:

  • Invalid or missing API credentials will cause authentication failures.
  • Providing an unknown or invalid Resource or Operation name will throw an error indicating the resource is not known.
  • Incorrect Template ID format (non-numeric) will fail validation.
  • If the selected Zalo Official Account (ZaloOA) is not accessible or does not exist, the node may return empty results or errors.

• Error messages:

  • "The resource \"<resource>\" is not known!": Occurs if the resource parameter is incorrect; verify spelling and casing.
  • Validation errors on Template ID input indicate the ID must be numeric.
  • Network or API errors from EsmsVN will propagate; ensure network connectivity and valid API keys.

• Resolution tips:

  • Double-check all input parameters for correctness.
  • Ensure the API key credential is properly set up and has required permissions.
  • Use the node's built-in search features to select valid ZaloOA and Template IDs to avoid manual entry errors.

Links and References

• EsmsVN Official Website
• Zalo Official Account Documentation
• n8n Documentation on Custom Nodes