Send OTP/Customer care message

Sending a POST request on this endpoint allows to send SMS individually (1 request per SMS).

It is ideal to send single personalized messages for use-cases like notifications or alerts.

HTTP request

POST https://rest.esms.vn/MainService.svc/json/SendMultipleMessage_V4_post_json/

• Content Type: application/json

• Response Type: application/json

curl --location --request POST 'https://rest.esms.vn/MainService.svc/json/SendMultipleMessage_V4_post_json/' \
--header 'Content-Type: application/json' \
--data-raw '{
   "ApiKey": "{{ApiKey}}",
   "Content": "{{Content}}",
   "Phone": "{{Phone}}",
   "SecretKey": "{{SecretKey}}",
   "Brandname": "{{Brandname}}",
   "SmsType": "2",
   "IsUnicode": "{{IsUnicode}}",
   "Sandbox": "{{Sandbox}}",
   "campaignid": "{{campaignid}}",
   "RequestId": "{{RequestId}}",
   "CallbackUrl": "{{CallbackUrl}}"
}'

• Body request:

Parameter	Type	Required	Description
ApiKey	string		Your API Key.
Content	string		The content of message.
Phone	string		The phone number of receiver.
SecretKey	string		Your Secret Key.
Brandname	string		The name of the sender is shown in the header of the customer's message. Pre-registration is required.
SmsType	string		Message type: 2: Customer care message.
IsUnicode	string		Message charset value (default is 0): 1: Unicode. 0: Non-Unicode.
Sandbox	string		Sandbox option value (default is 0): 1: For testing purpose to verify the validation of the request. Message is not charged and sent to the receiver. 0: Message will be processed to the receiver properly.
RequestId	string		The identification value for the request to prevent the the request from duplicated.
SendDate	string		Scheduler the message to the receiver. If it's empty, the message will be instantly sent to the receiver. Format: yyyy-mm-dd hh:MM:ss
campaignid	string		The campaign name of the request.
CallbackUrl	string		The webhook URL that will receive the status of message after it processed to the operator. It is used for determine whether the SMS is succcessfully delivered to the receiver or failed. See the sample request at here. More detail at here.

---

• Response

100

{
    "CodeResult": "100",
    "CountRegenerate": 0,
    "SMSID": "d533459ee42b2b9525ba9eabf6a8156"
}

Valid request.

104

{
    "CodeResult": "104",
    "CountRegenerate": 0,
    "ErrorMessage": "Brand name code is not exist"
}

Invalid brandname.

101

{
    "CodeResult": "101",
    "CountRegenerate": 0,
    "ErrorMessage": "Authorize Failed"
}

Invalid credential.

124

{
    "CodeResult": "124",
    "CountRegenerate": 0,
    "ErrorMessage": "Request exist 1",
    "SendStatus": "5"
}

Duplicate request.

146

{
  "CodeResult": "146",
  "CountRegenerate": 0,
  "ErrorMessage": "Sai template Brandname CSKH",
  "SMSID": "3f5ec8c71c4a4ccea311f731dfeaa133156"
}

The customer care template is not registered.

99

{
  "error": "Invalid request"
}

Connection is error. Contact the admin for reference.

• Response body

Parameter	Type	Description
CodeResult	string	Response code.
SMSID	string	The message id eSMS system.
ErrorMessage	string	The error message if the request is invalid.

• The detail of error code can refer at Table of error codes .

• Get the sample of code for programing languagues to use in Postman refer at Link of code samples.