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": "string",
    "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.

Last updated