Nqdev: Tích hợp EsmsVNInstall

Overview

This node integrates with the EsmsVN API to manage SMS and OTT messaging services. Specifically, for the Account resource and the Danh sách Brandname operation, it retrieves a list of brand names associated with the user's account. This is useful for users who want to view or select from their registered SMS sender names (brand names) when sending messages.

Practical examples include:

• Fetching available brand names before sending bulk SMS campaigns.
• Displaying brand name options in a user interface for message customization.
• Validating that a desired brand name is registered before attempting to send messages.

Properties

The SmsType property allows selecting the category of SMS brand names to retrieve, which can correspond to different business or marketing purposes.

Output

The node outputs an array of JSON objects representing the brand names retrieved from the EsmsVN service. Each object contains details about a brand name relevant to the selected SMS type.

The exact structure of each brand name object depends on the EsmsVN API response but typically includes identifiers, display names, and possibly status or registration information.

No binary data output is produced by this operation.

Dependencies

• Requires an active connection to the EsmsVN API endpoint at https://rest.esms.vn.
• Needs an API authentication credential configured within n8n to authorize requests.
• The node relies on bundled helper libraries (esmsvn, EsmsLoadFunctions, EsmsSearchFunctions) for API interaction and data retrieval.

Troubleshooting

• Unknown Resource Error: If the resource parameter is not set to "Account" (or other supported resources), the node will throw an error indicating the resource is unknown. Ensure the resource is correctly specified.
• API Authentication Failures: Missing or invalid API credentials will cause request failures. Verify that the API key or token is correctly configured in n8n credentials.
• Empty or Unexpected Response: If no brand names are returned, confirm that the account has registered brand names for the selected SMS type.
• Continue On Fail Behavior: When enabled, the node continues processing subsequent items even if one fails, appending error details to the output. Otherwise, execution stops on the first error.

Links and References

• EsmsVN Official API Documentation (for detailed API endpoints and parameters)
• n8n Documentation - Creating Custom Nodes
• SMS Messaging Best Practices (general guidance on SMS sender names and compliance)