Nqdev: Tích hợp EsmsVNInstall

Overview

This node integrates with the EsmsVN API to send OTT messages, specifically Viber messages, as part of its supported operations. It is designed for scenarios where users want to programmatically send Viber messages to customers or contacts using a branded sender name and customized content. Typical use cases include marketing campaigns, customer notifications, appointment reminders, or any communication requiring rich OTT messaging via Viber.

For example, a business can automate sending birthday wishes or promotional offers through Viber by specifying the recipient's phone number, message content, and optionally a brand name to appear as the sender.

Properties

Output

The node outputs an array of JSON objects representing the result of the send operation for each input item. Each output object includes:

• executionId: Unique ID for the execution.
• resource: The resource used ("ott_message").
• operation: The operation performed ("sendViberMessage").
• status: Status of the operation, typically "completed".
• timestamp: ISO string timestamp when the operation was executed.
• Additional response data returned by the EsmsVN API related to the message sending result.

No binary data output is produced by this node.

Dependencies

• Requires an API key credential for authenticating with the EsmsVN service.
• Uses the EsmsVN API endpoints to send messages and retrieve brand names.
• The node depends on internal helper libraries bundled with it for loading options and executing commands.
• Network access to EsmsVN API endpoints must be configured in the environment where n8n runs.

Troubleshooting

• Invalid Phone Number Format: The phone number must match the regex pattern for Vietnamese numbers (^(+84|0)(3|5|7|8|9)[0-9]{8}$). Errors occur if the format is incorrect. Ensure the number includes country code (+84) or starts with 0 followed by valid prefixes.
• Missing or Invalid Brandname: If a brand name is required but not provided or invalid, the API may reject the request. Use the provided list search to select valid brand names or enter a valid one matching the allowed pattern.
• API Authentication Errors: If the API key credential is missing or invalid, requests will fail. Verify that the correct API key is configured in n8n credentials.
• Sandbox Mode Confusion: When sandbox mode is enabled, messages are not actually sent but simulated. Disable sandbox for production sends.
• Unicode Issues: If message content contains special characters or Vietnamese text, enable the Unicode option to avoid garbled text.
• Logging Disabled: If troubleshooting issues, enable logging to capture detailed API request/response information.

Links and References

• EsmsVN API Documentation
• Brandname Registration and Retrieval
• Viber Messaging Guidelines

This summary is based solely on static analysis of the provided source code and property definitions.