Nqdev: Tích hợp EsmsVN icon

Nqdev: Tích hợp EsmsVN

Send SMS and OTT messages using EsmsVN API.

Actions8

SMS Message → Danh sách Template

AI-generated

Overview

This node integrates with the EsmsVN API to manage SMS messaging services. Specifically, for the SMS Message resource and the Danh sách Template (List Templates) operation, it retrieves a list of SMS templates associated with a given brand or SMS type.

Common scenarios where this node is useful include:

  • Fetching available SMS templates before sending messages to ensure compliance with predefined formats.
  • Managing and displaying SMS templates in an automation workflow.
  • Automating marketing or customer service SMS campaigns by selecting from existing templates.

For example, a user might want to retrieve all templates under a specific brand name and SMS type to dynamically populate options in a subsequent message-sending step.

Properties

Name Meaning
SmsType Type of SMS to filter templates by. Options: Brandname QC, Brandname CSKH, Cố định giá rẻ
Brandname The brand name associated with the SMS templates. Can be selected from a searchable list or entered manually. Only applicable when SmsType is Brandname QC or Brandname CSKH (values 1 or 2).

Output

The output is a JSON array containing the results of the template listing operation. Each item in the array represents a template or related data returned by the EsmsVN API for the specified SMS type and brand name.

The exact structure depends on the API response but typically includes fields such as template ID, content, status, and other metadata relevant to SMS templates.

No binary data output is indicated for this operation.

Dependencies

  • Requires an API key credential for EsmsVN configured in n8n.
  • Connects to the EsmsVN REST API at https://rest.esms.vn.
  • Uses internal helper functions to fetch brand names and templates (getListBrandname, getListTemplate).

Troubleshooting

  • Unknown Resource Error: If the resource parameter is not set to "sms_message" or another supported value, the node will throw an error indicating the resource is unknown. Ensure the resource is correctly set.
  • Invalid SmsType or Brandname: Selecting an unsupported SMS type or providing an invalid brand name may result in empty responses or API errors. Verify that the SmsType matches one of the allowed options and that the brand name exists.
  • API Authentication Failures: Missing or incorrect API credentials will cause authentication errors. Confirm that the EsmsVN API key is properly configured in n8n credentials.
  • Network Issues: Connectivity problems to https://rest.esms.vn will prevent the node from retrieving templates. Check network access and proxy settings if applicable.

Links and References

Discussion