Actions8
- Account Actions
- SMS Message Actions
- OTT Message Actions
SMS Message → Gửi tin nhắn SMS
AI-generatedOverview
This node integrates with the EsmsVN API to send SMS and OTT messages. Specifically, for the SMS Message resource and the Gửi tin nhắn SMS (Send SMS Message) operation, it allows users to send SMS messages to specified phone numbers using different SMS types and brand names.
Common scenarios where this node is beneficial include:
- Sending promotional or transactional SMS messages to customers.
- Automating customer notifications such as appointment reminders or alerts.
- Testing SMS sending in a sandbox environment before going live.
Practical example:
- A business wants to send a birthday greeting SMS to customers with their brand name displayed as the sender. They configure the node to use the "Brandname CSKH" SMS type, specify their brand name, input the customer's phone number, and compose the message content.
Properties
| Name | Meaning |
|---|---|
| SmsType | Type of SMS to send. Options: - Brandname QC - Brandname CSKH (default) - Cố định giá rẻ (Fixed low price) |
| Brandname | Your brand name shown as the sender. Required only for certain SMS types (Brandname QC, Brandname CSKH). Can be selected from a list or entered manually. |
| PhoneNumber | Recipient's phone number. Must follow Vietnamese phone format, e.g., +84912345678 or 0912345678. |
| Content | The text content of the SMS message. |
| Options | Additional optional settings: - IsUnicode: Send message as Unicode to support Vietnamese characters and special symbols. - Sandbox: Send in sandbox mode for testing without cost. - Partner Source: Numeric partner source ID if required by EsmsVN. - Logging Request: Enable logging of each API request for debugging purposes. |
Output
The node outputs JSON data representing the result of the SMS sending operation. This typically includes status information about the sent message, such as success confirmation or error details.
If multiple items are processed, the output is an array of such JSON objects, one per input item.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for authenticating with the EsmsVN service.
- The node uses the EsmsVN REST API endpoint at
https://rest.esms.vn. - Optional configuration may include enabling sandbox mode for testing.
- The node depends on internal helper libraries bundled with the node implementation for loading options and searching resources like brand names and templates.
Troubleshooting
- Invalid phone number format: If the phone number does not match the expected Vietnamese format, the node will throw a validation error. Ensure the number starts with +84 or 0 followed by a valid operator code and 8 digits.
- Missing or incorrect brand name: For SMS types that require a brand name, omitting or entering an invalid brand name can cause errors. Use the provided list or enter a valid string matching the regex pattern.
- API authentication errors: If the API key credential is missing or invalid, the node will fail to authenticate with EsmsVN. Verify the API key and its permissions.
- 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.
- Unicode issues: If special characters appear garbled, enable the Unicode option to properly encode message content.
Links and References
- EsmsVN Official API Documentation (for detailed API usage and parameters)
- Vietnamese Phone Number Format Reference
- n8n Documentation on Creating Custom Nodes