Nqdev: Tích hợp EsmsVN icon

Nqdev: Tích hợp EsmsVN

Send SMS and OTT messages using EsmsVN API.

Actions8

OTT Message → Gửi tin nhắn ZNS

AI-generated

Overview

This node integrates with the EsmsVN API to send SMS and OTT messages, specifically supporting operations related to Zalo Official Account (Zalo OA) messaging. The "Gửi tin nhắn ZNS" operation allows sending Zalo Notification Service (ZNS) messages, which are templated notifications sent via Zalo's platform.

Typical use cases include:

  • Sending automated notification messages to customers through Zalo OA.
  • Delivering transactional or promotional messages using predefined Zalo templates.
  • Integrating Zalo messaging into workflows for customer engagement or alerts.

For example, a business can use this node to send order status updates or appointment reminders to customers via Zalo messages using approved templates.

Properties

Name Meaning
SmsType Type of SMS message to send. Options: "Zalo Ưu Tiên" (priority Zalo message), "Zalo Bình Thường" (normal Zalo message).
ZaloOA Select or specify the Zalo Official Account (OA) from which the message will be sent. Can be chosen from a list or entered by name.
Template ID Select or specify the Zalo ZNS template ID to use for the message. Can be selected from a list or entered manually.
PhoneNumber Recipient phone number in international format (e.g., +84912345678) or local format (e.g., 0912345678). Must match Vietnamese mobile number patterns.
Template Parameters Dynamic parameters to fill in the placeholders of the selected Zalo template. Each parameter has a name (loaded dynamically based on the template) and a corresponding value. Multiple parameters can be added.
Options Additional options for sending the message:
- IsUnicode: Send message content as Unicode (supports Vietnamese and special characters).
- Sandbox: Send message in sandbox mode for testing without cost.
- Partner Source: Numeric code identifying partner source for routing.
- Logging Request: Enable logging of each API request for debugging purposes.

Output

The node outputs an array of JSON objects representing the result of each message sending operation. Each output item includes fields such as:

  • executionId: Unique identifier for the execution run.
  • resource: The resource type used ("ott_message" in this case).
  • operation: The operation performed ("sendZnsMessage").
  • status: Status of the operation, typically "completed".
  • timestamp: ISO timestamp when the operation was executed.
  • Other response data returned from the EsmsVN API related to the message sending result.

No binary data output is indicated for this operation.

Dependencies

  • Requires an API key credential for EsmsVN service authentication.
  • Uses EsmsVN API endpoints to fetch lists of Zalo OAs, templates, and to send messages.
  • Node configuration must include valid credentials and network access to EsmsVN API.
  • Relies on internal helper methods to load dynamic options like template parameters and available Zalo OAs.

Troubleshooting

  • Invalid Phone Number Format: The phone number must match Vietnamese mobile formats starting with +84 or 0 followed by specific digits. Errors occur if the format is incorrect. Ensure the phone number matches the regex pattern.
  • Template Parameter Mismatch: If required template parameters are missing or incorrectly named, the API may reject the message. Use the dynamic loading feature to select correct parameter names.
  • API Authentication Errors: Missing or invalid API credentials will cause authentication failures. Verify that the API key credential is correctly configured.
  • Sandbox Mode Confusion: Messages sent in sandbox mode do not incur costs but also do not reach actual recipients. Disable sandbox mode for production sends.
  • Logging Disabled: If troubleshooting issues, enable the "Logging Request" option to capture detailed API request logs.
  • Unknown Resource or Operation: The node throws errors if an unsupported resource or operation is specified. Confirm that "ott_message" resource and "sendZnsMessage" operation are selected.

Links and References

Discussion