Quickstart: Gửi OTP đầu tiên
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 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.
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.
CodeResult = "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."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.