Gửi tin nhắn SMS OTP/CSKH

HTTP request

POST http://rest.esms.vn/MainService.svc/json/SendMultipleMessage_V4_post_json/

• Content Type: application/json

• Response Type: application/json

curl --location --request POST 'http://rest.esms.vn/MainService.svc/json/SendMultipleMessage_V4_post_json/' \
--header 'Content-Type: application/json' \
--data-raw '{
   "ApiKey": "{{ApiKey}}",
   "Content": "{{Content}}",
   "Phone": "{{Phone}}",
   "SecretKey": "{{SecretKey}}",
   "Brandname": "{{Brandname}}",
   "SmsType": "2",
   "IsUnicode": 0,
   "Sandbox": 0,
   "campaignid": "{{campaignid}}",
   "RequestId": "{{RequestId}}",
   "CallbackUrl": "{{CallbackUrl}}"
}'

Cấu trúc body của request

Tham số	Kiểu dữ liệu	Tính bắt buộc	Mô tả
ApiKey	string	Bắt buộc	ApiKey eSMS cung cấp
Content	string	Bắt buộc	Nội dung tin nhắn
Phone	number	Bắt buộc	Số điện thoại nhận tin nhắn
SecretKey	string	Bắt buộc	SecretKey eSMS cung cấp
Brandname	string	Bắt buộc	Tên Brandname (tên công ty hay tổ chức khi gửi tin sẽ hiển thị trên tin nhắn). Chú ý: Phải đăng ký trước khi sử dụng.
SmsType	string	Bắt buộc	Loại tin nhắn ID 2 là CSKH
IsUnicode	string	Không bắt buộc	Gửi nội dung có dấu 1: Có dấu 0: Không dấu
Sandbox			1: Tin gửi ở môi trường test, dùng để kiểm tra kết nối và các thông số tích hợp, không về tin nhắn 0: Tin gửi ở môi trường bình thường, có về tin nhắn.
RequestId	string	Không bắt buộc	ID đối tác truyền sang để chặn trùng và đối soát khi cần
SendDate	string	Không bắt buộc	Thời gian hẹn giờ gửi tin. Đề xuất: Không nên truyền tham số này để tin được đi nhanh nhất
campaignid	string	Không bắt buộc	Tên chiến dịch
CallbackUrl	string	Không bắt buộc	URL nhận kết quả gửi tin

Response

100

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

*Request hợp lệ

104

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

*Brandname truyền chưa đúng hoặc chưa được active

101

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

*Sai thông tin ApiKey hoặc SecretKey

99

{
  "error": "Invalid request"
}

*Kiểm tra lại thông tin kết nối hoặc liên hệ bộ phận chăm sóc khách hàng để được hỗ trợ khi gặp lỗi này.

Cấu trúc body của response

Thuộc tính	Kiểu dữ liệu	Mô tả
CodeResult	String	Mã trả về
SMSID	String	ID tin nhắn do esms trả về
ErrorMessage	String	Thông tin lỗi trả về (nếu có lỗi)

*Chi tiết mã lỗi xem ở trang: Mã Lỗi

* Lấy code mẫu các ngôn ngữ trên Postman: link code mẫu

* Hướng dẫn lấy code mẫu: video