Send adveritising message

API dùng để gửi tin Quảng cáo đến khách hàng. Mỗi request tối thiểu 30 số để được duyệt tin và tối đa 5000 số.

Sending a POST request on this endpoint allows to send bulk advertising SMS (maximum 5000 receivers per request).

Personalized content is ideal for sending marketing campaigns or any mass personalized announcement.

HTTP request

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

• Content Type: application/json

• Response Type: application/json

curl --location 'https://rest.esms.vn/MainService.svc/json/SendMultipleSMSBrandname_json/' \
--header 'Content-Type: application/json' \
--data '{
    "ApiKey": "{{SecretKey}}",
    "SecretKey": "{{SecretKey}}",
    "Brandname": "{{Brandname}}",
    "Content": "{{Content}}",
    "Phones": [
        "{{Phones}}",
        "{{Phones}}",
        "{{Phones}}"
    ],
    "SmsType": "1",
    "SendDate": "{{SendDate}}",
    "CallbackUrl": "{{CallbackUrl}}",
    "Sandbox":"{{Sandbox}}"
}'

• Cấu trúc body của request:

Paramter	Type	Required	Description
ApiKey	string		Your API Key.
SecretKey	string		Your Secret Key.
Content	string		The personized or marketing content.
SmsType	string		Message type: 1: Advertising/marking message.
Brandname	string		The name of the sender is shown in the header of the customer's message. Pre-registration is required.
Phones	array		The phone number of receivers.
SendDate	string		Schedule the time when 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
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.
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.

---

• Response:

100

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

Valid request.

101

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

Invalid credential.

104

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

Invalid brandname.

107

{
    "CodeResult": "107",
    "CountRegenerate": 0,
    "ErrorMessage": "Each request has at least 30 numbers to be approved"
}

At least 30 receivers per request.

124

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

Duplicate request id.

• 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.