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

Last updated