Baotrixemaybây giờ
482913 là mã xác minh của bạn
POST /SendMessage182ms
CodeResult: "100" ✓
Zalo ZBS1 phút
Đơn hàng #8842 đã giao thành công
Webhook callback200 OK
SendStatus=5 Delivered
Mới Tài liệu API v2: tặng 5.000đ để gửi thử tin thật, code mẫu 7 ngôn ngữ

Tích hợp SMS OTP
chỉ trong 5 phút

Một bộ API cho mọi kênh chăm sóc khách hàng. Copy code, gửi thử tin thật bằng 5.000đ có sẵn trong tài khoản, rồi lên production mà không phải sửa code.

Phổ biến: Gửi SMS OTP Quickstart Bảng mã lỗi Callback URL Test callback
Bắt đầu nhanh

Gửi tin nhắn đầu tiên trong 3 bước

Mỗi tài khoản có sẵn 5.000đ và brandname thử, nên bạn gửi được tin thật tới số của mình ngay, chưa cần đăng ký brandname riêng.

1

Lấy API Key & Secret Key

Đăng nhập account.esms.vn → Quản lý API. Tài khoản mới được tặng 5.000đ.

2

Gửi tin thật tới số của bạn

Dùng brandname thử Baotrixemay. Nhận CodeResult = 100 và tin về điện thoại sau vài giây.

3

Nhận kết quả qua Callback

eSMS gọi về CallbackUrl của bạn khi tin được gửi tới máy người nhận.

Xem hướng dẫn đầy đủ →
Terminal

        
Cách hoạt động

Một request, tin nhắn tới tay khách hàng trong vài giây

eSMS lo phần định tuyến nhà mạng, Zalo và chuyển kênh dự phòng. Bạn chỉ cần gọi API và lắng nghe callback.

Server của bạnPOST JSON
JSON
eSMS APICodeResult 100
SMS
Nhà mạng / ZaloViettel · Mobi · Vina
✓
Khách hàngNhận tin
① 100 · Đã tiếp nhận ② Đang gửi ③ Đã gửi tới máy ④ Callback ↩
0Uptime API
0Thời gian gửi trung bình
0Ngôn ngữ code mẫu
0Hỗ trợ kỹ thuật
Sản phẩm

Chọn kênh bạn muốn tích hợp

Mỗi kênh có hướng dẫn, code mẫu và API reference riêng.

SMS OTP / CSKH Phổ biến

Gửi mã xác thực, thông báo giao dịch bằng brandname. Tự sinh & kiểm tra mã OTP.

Zalo ZBS

Gửi tin theo template qua Zalo OA bằng số điện thoại, hash phone hoặc UID. ZBS là tên mới của ZNS. Kèm tin tư vấn và tin hành trình.

Đa kênh (Fallback)

Ưu tiên Zalo, tự chuyển sang SMS khi gửi thất bại. Một request, tối ưu chi phí.

SMS Quảng cáo

Gửi chiến dịch marketing tới 30–5.000 số mỗi request, hẹn giờ gửi.

Voice OTP & Voice Call

Đọc mã OTP qua cuộc gọi (gửi bằng API SMS CSKH, cần CSKH cấu hình trước), gọi tự động theo template hoặc file ghi âm.

Tra cứu & Báo cáo

Số dư, trạng thái tin, danh sách brandname, template, quota Zalo OA.

Công cụ

Mọi thứ developer cần

 

OpenAPI 3.1Tải spec, generate client
Postman CollectionImport 1 click
Code mẫu 7 ngôn ngữcURL, Node, PHP, Python…
llms.txtCho Claude, Cursor, Copilot
Bắt đầu / Quickstart

Quickstart: Gửi OTP đầu tiên

5 phútTặng 5.000đ để testGửi tin thậtMọi ngôn ngữ

Bài này đi trọn luồng xác thực OTP trên môi trường thật: gửi mã tới chính số điện thoại của bạn, nhận callback về server, rồi lên production. Code bạn viết ở đây chạy được luôn trên production, không phải sửa gì thêm.

1. Lấy keyCó sẵn 5.000đ
2. Gửi tin thậtTới số của bạn
3. CallbackNhận trạng thái
4. Go-liveNạp tiền, brandname riêng

1. Lấy API Key

Đăng nhập và mở trang Quản lý API ↗ (xem hướng dẫn chi tiết). Mỗi tài khoản mới có sẵn 5.000đ để gửi thử tin thật. Hãy lưu key trong biến môi trường, không đưa vào mã nguồn.

Bảo mậtKhông gọi API eSMS từ frontend hay app mobile. SecretKey phải nằm trên server của bạn.

2. Gửi tin thật tới số của bạn

Dùng brandname thử Baotrixemay với nội dung mẫu đã duyệt sẵn, đặt Phone là số điện thoại của bạn. Tin được gửi thật và trừ vào 5.000đ dùng thử, nên bạn kiểm tra được trọn luồng: nhận tin trên điện thoại, nhận callback và xem báo cáo.

Kết quả mong đợiCodeResult = "100" nghĩa là eSMS đã tiếp nhận request. Vài giây sau điện thoại của bạn nhận được tin và server nhận được callback.
Còn Sandbox thì sao?"Sandbox": "1" chỉ dùng để kiểm tra kết nối (key, IP, định dạng request): không gửi tin và không có callback. Đừng dùng nó làm môi trường tích hợp chính.

3. Nhận Callback

Truyền CallbackUrl trong request. eSMS gọi HTTPS GET tới URL này và thử lại 5 lần nếu timeout. Hãy whitelist các IP 103.29.26.39, 103.29.26.80 và 103.29.27.39.

Chưa dựng xong server? Bấm Thử ngay ở trang Gửi SMS OTP/CSKH để gửi một tin và xem chính xác callback eSMS sẽ gửi về, theo từng loại tin.

4. Lên production

Nạp tiền, đăng ký brandname và template CSKH riêng, đổi Brandname/Content trong code, rồi bật whitelist IP để tăng bảo mật. Phần còn lại của code giữ nguyên.

Gửi OTP thật tới số của bạn

              
Đã đăng nhập: API key của bạn được điền sẵn vào code mẫu
Request

            
Response

            
Bắt đầu / Lấy API Key

Lấy API Key & Secret Key

2 phútCó sẵn 5.000đ để testDùng cho mọi API

Mọi API của eSMS xác thực bằng cặp ApiKey + SecretKey, truyền trong body (hoặc query với API dạng GET). Bạn lấy hai giá trị này trong trang Quản lý API của tài khoản eSMS.

Mở trang Quản lý API ↗

account.esms.vn/Account/ApiInfomation

  1. Đăng nhập tài khoản eSMS

    Chưa có tài khoản? Đăng ký tại account.esms.vn ↗. Tài khoản mới có sẵn 5.000đ để gửi thử tin thật.

  2. Mở trang Quản lý API

    Vào Quản lý API ↗, hoặc chọn Quản lý API trên menu tài khoản.

  3. Sao chép ApiKey và SecretKey

    Copy cả hai giá trị. Đây là “mật khẩu” để gọi API thay mặt tài khoản của bạn, nên giữ bí mật như mật khẩu.

  4. Lưu vào biến môi trường trên server

    Không ghi thẳng key vào mã nguồn và không commit lên Git. Đọc key từ biến môi trường như code bên cạnh.

  5. (Khuyến nghị) Bật whitelist IP

    Chỉ cho phép IP server của bạn gọi API. Request từ IP lạ sẽ bị từ chối với mã lỗi 140.

Không dùng key ở frontend hay app mobileMọi lời gọi API eSMS phải đi từ server của bạn. Nếu nghi key bị lộ, hãy liên hệ eSMS để cấp lại key ngay.
Gặp lỗi 101?CodeResult = "101" nghĩa là sai ApiKey/SecretKey. Kiểm tra key có bị thừa khoảng trắng hay copy thiếu ký tự không.

Tiếp theo

.env (trên server)
# Lấy tại account.esms.vn/Account/ApiInfomation
ESMS_API_KEY=YOUR_API_KEY
ESMS_SECRET_KEY=YOUR_SECRET_KEY
Dùng key trong request
// Node.js: đọc key từ biến môi trường
const body = {
  ApiKey: process.env.ESMS_API_KEY,
  SecretKey: process.env.ESMS_SECRET_KEY,
  Phone: "0901888484",
  // ...các tham số khác của API
};
Bắt đầu / Callback / Webhook

Callback / Webhook

HTTPS GETRetry 5 lần khi timeoutTheo từng loại tin

Khi có trạng thái thực tế của tin, eSMS gọi HTTPS GET tới CallbackUrl bạn truyền lúc gửi. Callback được gửi lại 5 lần nếu URL của bạn timeout. Hãy whitelist các IP 103.29.26.39, 103.29.26.80 và 103.29.27.39.

Server của bạn cần làm gì?Trả về HTTP 200 càng nhanh càng tốt (xử lý nặng thì đưa vào hàng đợi). Dùng SMSID hoặc RequestId để đối chiếu với tin đã gửi. Muốn xem callback thật mà không cần dựng server? Bấm Thử ngay ở trang API bất kỳ.

Callback mẫu theo từng loại tin

Bộ tham số khác nhau theo từng loại tin. Mẫu dưới đây lấy nguyên văn từ tài liệu eSMS.

GET Callback

          
Tham khảo / Bảng mã lỗi

Bảng mã lỗi

Mọi API trả về HTTP 200 kèm trường CodeResult. Chỉ 100 là thành công, nghĩa là request đã được tiếp nhận.

Đã copy