Nqdev: Tích hợp EsmsVNInstall

Overview

This node integrates with the EsmsVN API to send SMS and OTT messages, specifically supporting operations related to Zalo Official Account (OA) messaging templates. The "Chi tiết ZNS Template" operation under the "OTT Message" resource retrieves detailed information about a specific Zalo Notification Service (ZNS) template.

Typical use cases include:

• Fetching metadata or details of a Zalo ZNS message template before sending messages.
• Managing and verifying templates used for Zalo-based notifications.
• Automating workflows that require dynamic access to Zalo message templates in marketing, customer support, or notification systems.

For example, a user might want to retrieve the content structure and parameters of a Zalo ZNS template to customize messages dynamically before dispatching them.

Properties

Output

The node outputs JSON data containing the detailed information of the requested Zalo ZNS template. This typically includes fields such as template content, parameters, status, and other metadata relevant to the template.

If multiple items are processed, the output is an array of such JSON objects, each corresponding to one input item.

No binary data output is indicated for this operation.

Dependencies

• Requires an API key credential for authenticating with the EsmsVN API.
• Uses EsmsVN's services for managing SMS and OTT messages, including Zalo OA and ZNS templates.
• The node depends on internal helper methods to fetch lists of Zalo OAs and templates dynamically.
• No additional environment variables beyond standard n8n credential configuration are required.

Troubleshooting

• Common Issues:

  • Invalid or missing API credentials will cause authentication failures.
  • Providing an invalid Template ID (non-numeric or non-existent) will result in errors or empty responses.
  • Selecting a ZaloOA that does not exist or is not linked to the account may cause lookup failures.

• Error Messages:

  • "The resource \"ott_message\" is not known!" — indicates an unsupported resource was selected; ensure "OTT Message" is chosen.
  • Validation errors on Template ID input if the format is incorrect (must be numeric).
  • Network or API errors from EsmsVN should be checked by verifying API key validity and network connectivity.

• Resolution Tips:

  • Double-check API credentials and permissions.
  • Use the provided search lists to select valid ZaloOA and Template IDs to avoid manual entry errors.
  • Enable "Continue On Fail" in the node settings to handle partial failures gracefully during batch processing.

Links and References

• EsmsVN API Documentation - Zalo ZNS Templates
• Zalo Official Account Developer Guide
• n8n Documentation on Resource Locators