Nqdev: Tích hợp EsmsVNInstall

Overview

This node integrates with the EsmsVN API to send SMS and OTT messages, as well as manage related resources such as accounts and templates. Specifically, for the Account resource and the Danh sách Zalo OA operation, it retrieves a list of Zalo Official Accounts (OA) associated with the user's EsmsVN account.

Common scenarios where this node is beneficial include:

• Managing and retrieving Zalo OA accounts for marketing or communication purposes.
• Automating workflows that require fetching Zalo OA details before sending messages.
• Integrating EsmsVN messaging capabilities into broader automation pipelines.

For example, a user might use this node to fetch all their Zalo OA accounts and then iterate over them to send targeted messages or analyze account data.

Properties

Note: Although the provided property SmsType applies to multiple resources and operations, it is relevant here as part of the node's configuration options.

Output

The node outputs JSON data representing the result of the executed command. For the Danh sách Zalo OA operation under the Account resource, the output JSON contains an array of objects, each representing a Zalo Official Account retrieved from the EsmsVN API.

Each item in the output includes metadata fields such as:

• executionId: The unique identifier of the current execution.
• resource: The resource name ("account").
• operation: The operation name ("getListZaloOa").
• status: The status of the operation (e.g., "completed").
• Additional fields specific to the Zalo OA details returned by the API.

If multiple items are returned, they are aggregated into an array.

The node does not output binary data.

Dependencies

• Requires an active EsmsVN API credential configured in n8n to authenticate requests.
• Relies on the EsmsVN REST API endpoint at https://rest.esms.vn.
• Uses internal helper libraries bundled with the node for loading options and searching lists.

Troubleshooting

• Unknown Resource Error: If the node throws an error stating that the resource is not known, verify that the "Resource" parameter is correctly set to "account" for this operation.
• API Authentication Failures: Ensure that the EsmsVN API credentials are valid and have sufficient permissions.
• Empty or Unexpected Output: Confirm that the EsmsVN account has linked Zalo OA accounts; otherwise, the list may be empty.
• Continue On Fail Behavior: If enabled, the node will continue processing subsequent items even if one fails, appending error details to the output.

Links and References

• EsmsVN Official Website
• EsmsVN API Documentation (Assumed URL, please verify)