1. Cấu hình nhận thông tin trả về.
Các tin nhắn sau khi khách hàng đã gửi sang hệ thống Sms có thể kiểm tra trạng thái bằng 2 cách:
1. Sử dụng hàm GetSmsStatus đã mô tả trong API để lấy thông tin.
- Sử dụng SmsGuid để gọi sang hệ thống Sms và kiểm tra trạng thái tin nhắn.
2. Cấu hình PushSmsStatus để cập nhật thông tin – sẽ mô tả trong tài liệu này.
- Cấu hình 1 link website dùng để nhận thông tin trạng thái tin nhắn. Mỗi khi tin nhắn có trạng thái cuối cùng, hệ thống Push Sms Status sẽ tự động gọi link trên và đính kèm các thông tin tin nhắn với phương thức http get.
2 Cách trên đều có những ưu nhược điểm riêng biệt, tuy nhiên sử dụng hàm API GetSmsStatus thường sử dụng cho những hệ thống nhỏ lượng tin nhắn không quá nhiều. Đối với hệ thống lớn chúng tôi khuyến nghị khách hàng nên sử dụng hệ thống PushSmsStatus để cập nhật trạng thái tin nhắn.
2. Cách cấu hình Link nhận thông tin trả về
Các bước cấu hình link website nhận thông tin:
a. Đăng nhập vào trang Client Send Sms. Truy cập vào mục: Management/Website Proccess
b. Chọn AddNew
c. Chọn dịch vụ muốn nhận trạng thái tin nhắn, điền thông tin Url SmsSystem sẽ call mỗi khi tin nhắn có trạng thái cuối. Điền thông tin SecrectSign – Mã bảo mật, hệ thống SmsSystem mỗi khi request Url đã cấu hình sẽ đính kèm thông tin này để xác thực request là của hệ thống gọi qua.
d. Nhấp AddNew
3. Các tham số
Tùy từng dịch vụ sẽ có những tham số tương ứng đi kèm.
Dưới đây là 1 ví dụ để minh họa rõ hơn các tham số SmsSystem đính kèm theo Request:
Giả sử link website đã cấu hình là :
http://callback.smssystem.com/ReceiveSmsStatus
Đối với các dịch vụ Gửi Text Sms link sẽ có dạng như sau:
callback.smssystem.com/ReceiveSmsStatusSMSGUID=XXXX&SMSSTATUS=YYYY&SECRECTSIGN=ZZZZ
Trong đó:
- XXXX: là Smsguid đã gửi sang hệ thống SmsSystem
- YYYY là SmsStatus. SmsStats sẽ có những trạng thái sau:
Các trạng thái trả về:
- Success = 3 //gửi tin thành công
- SentFail = 4 //gửi tin thất bại
- WrongPhoneNumber = 5 // sai số điện thoại
- AccountExpired = 6 // tài khoản đã hết hạn
- AmountZero = 7 // tài khoản đã hết tiền
- NotPrice = 8 //tin nhắn chưa có bảng giá
- CanNotSent = 9 // tin nhắn không thể gửi
- DenyPhoneNumber = 10 //Số Điện thoại nằm trong danh sách từ chối
- WrongSenderName = 13 //BrandName khai báo sai
- ZZZZ là SecrectSign đã nhập ở trên.
Lưu ý về phản hồi kết quả (Response):
- Thành công: Phản hồi XML <Status>2</Status>, JSON {"status":"2"} hoặc Text OK.
- Thất bại: Phản hồi XML <Status>1</Status> hoặc JSON {"status":"1"}.
Nếu nhận được tín hiệu thất bại, hệ thống SmsSystem sẽ tự động thử lại 5 lần để push lại kết quả cho khách hàng.