Nqdev: Tích hợp EsmsVN icon

Nqdev: Tích hợp EsmsVN

Send SMS and OTT messages using EsmsVN API.

Actions8

OTT Message → Gửi tin nhắn Viber

AI-generated

Overview

This node integrates with the EsmsVN API to send OTT messages, specifically Viber messages, as part of its supported operations. It is designed to facilitate sending branded Viber messages to specified phone numbers, supporting Unicode content and sandbox testing modes.

Common scenarios where this node is beneficial include:

  • Sending promotional or transactional Viber messages to customers.
  • Automating customer notifications via Viber with brand identity.
  • Testing message delivery in a sandbox environment before going live.

Practical example:

  • A marketing team wants to send birthday greetings with special offers to customers via Viber, using their brand name for recognition.
  • A support system sends real-time alerts or updates to users on Viber.

Properties

Name Meaning
SmsType Type of SMS; for this operation, fixed as "Viber Message".
Brandname Your brand name shown as the sender on Viber messages. Can be selected from a list or entered manually.
PhoneNumber Recipient's phone number in Vietnamese format (e.g., +84912345678 or 0912345678).
Content The text content of the Viber message to be sent.
Options Additional optional settings:
   IsUnicode Send message content as Unicode (supports Vietnamese characters and special symbols).
   Sandbox Send message in sandbox mode for testing without incurring costs.
   Partner Source Numeric identifier for partner source routing if required by EsmsVN.
   Logging Request Enable logging of each API request for debugging and verification purposes.

Output

The node outputs JSON data representing the result of the send operation. This typically includes status information such as success or failure, message IDs, timestamps, and any relevant metadata returned by the EsmsVN API.

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential for authenticating with the EsmsVN REST API.
  • The base URL for API requests is https://rest.esms.vn.
  • Optional configuration may include enabling logging or sandbox mode via input properties.

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 will occur if the format is incorrect. Ensure the number includes country code or starts with zero followed by valid prefixes.
  • Brandname validation: If entering brand name manually, it must match the regex [-_a-zA-Z0-9]+. Invalid characters will cause errors.
  • API authentication failures: Ensure the API key credential is correctly configured and has necessary permissions.
  • Sandbox mode confusion: Messages sent in sandbox mode do not incur charges but are not delivered to actual recipients. Use only for testing.
  • Logging enabled impact: Enabling logging increases request overhead; disable in production unless debugging.

Links and References

Discussion