Gửi 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"
    }
}'

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

Tham số	Kiểu dữ liệu	Mô tả
username	string	Tài khoản do eTelecom cung cấp
password	string	Mật khẩu do eTelecom cung cấp
phonenumber	string	Số điện thoại nhận tin (Khuyến cáo dạng chuẩn 84)
routerule	string	Route các kênh sẽ đi theo cơ chế trượt kênh thông minh (kênh đầu tiên gửi thất bại sẽ chuyển tiếp qua các kênh tiếp theo): 1: ZNS 2: AutoCall 3: SMS
templatecode	string	Mã template khi đăng ký
list_param	object	Danh sách các biến (tùy thuộc vào template sẽ có các biến khác nhau)

Cấu trúc response trả về:

Status	Response	Description
200	{ "status": "1", "code": "Success", "idOmniMess": "Chuỗi tiền tố ICOMNI và 30 ký tự" }	Success: eTelecom đã nhận được request gửi tin. Trạng thái sẽ được update ở API GetStatus hoặc webhook đã đăng ký với bên eTelecom dựa theo idOmniMess nhận về.
401	Unauthorized	Sai username và password
401	Can't access from this IP	IP của user không nằm trong whitelist hệ thống
200	{ "status": "-1", "code": "PhoneNumber Wrong Format" }	Số điện thoại nhận không đúng định dạng.
200	{ "status": "-2", "code": "Wrong Format Parameter: xxxxxx" }	Biến xxxxxx sai định dạng
200	{ "status": "-3", "code": "You have run out of messages" }	Số lần gửi tin Omni đã hết liên hệ kinh doanh để cấp thêm.
200	{ "status": "-6", "code": "Can't find template with templatecode: xxxxxx " }	Không tìm được template có id như yêu cầu
200	{ "status": "-8", "code": "Can't find any routing for this request" }	Không tìm thấy routerule nào cho template code, liên hệ kỹ thuật để cấu hình lại.
200	{ "status": "-9", "code": "Can't find any information about channel: XXXXX" }	Lỗi Channel XXXXX trong routerule liên hệ kỹ thuật để cấu hình lại.