Send SMS

Request:

curl --location 'https://sms.etelecom.vn/api/OmniMessage/SendMessage' \
--header 'Content-Type: application/json' \
--data '{
    "username": "string",
    "password": "string",
    "phonenumber":"string",
    "routerule": ["3"],
    "templatecode":"string",
    "list_param":{
        "property1":"string",
        "property2": "string"
    }
}'

Request body structure:

Parameters	Data type	Describe
username	string	Account provided by eTelecom
password	string	Password provided by eTelecom
phonenumber	string	Phone number to receive message (Recommended standard format 84)
routerule	string	The channel routing will follow the smart channel sliding mechanism (the first channel that fails will be forwarded to the next channels): 1: ZNS 2: AutoCall 3: SMS
templatecode	string	Template code when registering
list_param	object	List of variables (depending on the template there will be different variables)

The returned response structure:

Status	Response	Description
200	{ "status": "1", "code": "Success", " idOmniMess ": "ICOMNI prefix string and 30 characters" }	Success: eTelecom has received the message request. The status will be updated in the GetStatus API or the webhook registered with eTelecom based on the received idOmniMess.
401	Unauthorized	Wrong username and password
401	Can't access from this IP	User's IP is not in the system whitelist
200	{ "status": "-1", "code": "PhoneNumber Wrong Format" }	The phone number received is not in the correct format.
200	{ "status": "-2", "code": "Wrong Format Parameter: xxxxxx" }	Variable xxxxxx is in wrong format
200	{ "status": "-3", "code": "You have run out of messages" }	Omni message sent number has run out of business contacts to issue more.
200	{ "status": "-6", "code": "Can't find template with templatecode: xxxxxx " }	Cannot find template with requested id
200	{ "status": "-8", "code": "Can't find any routing for this request" }	No routerule found for template code, contact engineering for reconfiguration.
200	{ "status": "-9", "code": "Can't find any information about channel: XXXXX" }	Error Channel XXXXX in routerule contact technical for reconfiguration.