Chủ Nhật, 4 tháng 9, 2016

Gửi tin nhắn SMS với hoiio API

Gửi tin nhắn SMS với hoiio API

Tác giả: Nguyễn Quốc Bảo

Mục đích: Bài viết này hướng dẫn về dịch vụ tin nhắn SMS và cách sử dụng hoiio API để áp dụng việc sử dụng trong các ứng dụng hỗ trợ notify, hay cảnh báo, hay truyền thông tin cho người dùng của hệ thống phần mềm. Bài viết này hướng dẫn cách đăng ký và sử dụng dịch vụ, sau đó áp dụng lập trình để nhúng thẳng vào trong ứng dụng

Gửi tin nhắn SMS với hoiio API

Tác giả: Nguyễn Quốc Bảo

Mục đích: Bài viết này hướng dẫn về dịch vụ tin nhắn SMS và cách sử dụng hoiio API để áp dụng việc sử dụng trong các ứng dụng hỗ trợ notify, hay cảnh báo, hay truyền thông tin cho người dùng của hệ thống phần mềm. Bài viết này hướng dẫn cách đăng ký và sử dụng dịch vụ, sau đó áp dụng lập trình để nhúng thẳng vào trong ứng dụng

Yêu cầu

·         Nắm vững kiến thức về OOP, lập trình Java

·         Nắm cách sử dụng tool Netbeans hay Eclipse. Ở đây, chúng tôi sử dụng bằng Eclipse nhưng quí vị có thể viết Netbeans cũng được vì chỉ là code đơn giản để quí vị hiểu rõ. Sau khi hiểu được cách thực hiện, quí vị áp dụng vào trong ứng dụng cụ thể của quí vị

·         Download thư viện hoiio API tại địa chỉ https://github.com/Hoiio/hoiio-java/archive/master.zip

Giới thiệu về Dịch vụ tinh nhắn

·         Dịch vụ tin nhắn ngắn (SMS - Short Message Services) là một giao thức viễn thông cho phép gửi các thông điệp dạng văn bản ngắn (không quá 160 kí tự).

·         Người ta có thể gửi, nhận các tin nhắn thông qua SMS từ điện thoại dễ dàng và nhanh chóng. Nhờ SMS người ta có thể gửi đi thông điệp đến nhiều người khác trong khoảng thời gian ngắn với chi phí thấp.

·         Ngoài cách gửi tin nhắn qua SMS trên điện thoại thông thường, SMS còn có thể sử dụng qua Internet. Điều này rất có ích, ví dụ bạn có danh sách thông tin khách hàng nằm trên file excel và bạn muốn thông báo đến khách hàng của mình 1 tin tức gì đó.

·         Thay vì gửi tin nhắn bằng điện thoại theo cách thủ công tốn khá nhiều thời gian, hôm nay tôi xin hướng dẫn các bạn 1 cách làm hiệu quả hơn đó là gửi tin nhắn SMS từ máy tính.

Giới thiệu về hoiio API

·         Hiện nay có rất nhiều cách để gửi tin nhắn từ máy tính chẳng hạn như sử dụng USB 3G hay các API của các nhà cung cấp dịch vụ viễn thông.

·         Trong bài viết này, chúng tôi sẽ hướng dẫn các bạn sử dụng SMS API của hoiio – một công ty viễn thông của Singapore có chi nhánh tại Việt Nam.

 

·         Để sử dụng được dịch vụ của hoiio, đầu tiên chúng ta cần truy cập vào địa chỉ dưới đây https://secure.hoiio.com/dev/Dev.html?country=VN&locale=en#registrationEnterNumber để đăng kí tài khoản miễn phí theo các bước sau:

o   Bước 1: điền captcha, số điện thoại của bạn (dùng để đăng nhập sau khi đăng kí thành công - không có số 0 ở đầu và tạm thời chỉ hỗ trợ Mobifone, Vinaphone và Viettel) và chọn “Verify My Number”

Màn hình đăng kí tài khoản

o   Bước 2: hoiio sẽ gửi 1 mã xác thực đến số điện thoại bạn cung cấp ở trên, sử dụng mã này để điền vào ô “Verification Code” như bên dưới.

Màn hình xác thực số điện thoại

o    Bước 3: Cung cấp các thông tin cần thiết để hoàn tất quá trình đăng kí.  

Màn hình điền thông tin cá nhân

Kết quả sau khi đăng kí thành công

o    Lưu ý: Sau khi đăng kí thành công bạn sẽ được tặng 8 USD vào tài khoản, số tiền này chỉ cho phép gửi tin nhắn đến số điện thoại bạn đã đăng kí lúc đầu tuy nhiên bạn có thể trả thêm tiền (tối thiểu là 10 USD) để nhắn tin đến các số điện thoại khác (hỗ trợ cả VietnamMobile và Beeline). Phí mỗi tin nhắn là 2.5 cent, với số tiền ban đầu 8 USD thì cũng quá đủ để vọc rồi.

o    Tiếp theo, chúng ta cần đăng kí 1 ứng dụng gửi tin với hoiio.

o    Trong 2 khung URL các bạn điền vào địa chỉ để chuyển tiếp cuộc gọi và tin nhắn (nếu không muốn sử dụng tính năng này thì cứ để trống).

o    Khi tạo thành công, hoiio sẽ cấp cho bạn 1 cặp App ID và Access Token để sử dụng trong ứng dụng của mình. Ngoài ra các bạn có sử dụng thử tính năng gửi tin nhắn bằng click vào đường link bên dưới.

o    Tiếp theo, các bạn vào link sau để download các thư viện cần thiết:

https://github.com/Hoiio/hoiio-java/archive/master.zip

o    Mở Eclipse vào tạo mới 1 Java project (File -> New -> Java Project).

o    Giải nén file đã download ở trên ta được 1 thư mục có tên là “hoiio-java-master”. Add tất cả các file jar trong 2 thư mục “hoiio-java-master/lib” và “hoiio-java-master/third-party” vào project.

o    Sau khi khởi tạo project xong, ta tiếp tục add thêm 1 class vào ứng dụng (File -> New -> Class)

o    Đầu tiên chúng ta hiện thực phương thức gửi tin nhắn như sau:

o    Lưu ý trong phương thức sendSMS():

§  Số điện thoại truyền vào dưới dạng chuỗi theo chuẩn quốc tế. Ví dụ: 84908xxxxxx

§  Tin nhắn là chuỗi không quá 160 kí tự dạng ASCII hoặc không quá 80 kí tự đối với dạng unicode.

o    Chạy thử và xem kết quả:

§  Khi gửi tin nhắn, hoiio sẽ gán cho mỗi tin nhắn 1 ID (trong ví dụ ở đây là AA-S-1939864). Từ ID này chúng ta có thể kiểm tra xem 1 tin nhắn được gửi thành công hay thất bại.

 

§  Để làm được việc này ta cần hiện thực thêm phương thức lấy kết quả gửi tin và chỉnh sửa hàm main lại như sau:

o    Chạy và xem kết quả:

o    Đối với mỗi tin nhắn khi gửi, hoiio sẽ gán cho nó 1 trong 4 trạng thái như sau:

§  Queued: tin nhắn đang trong quá trình gửi đi.

§  Delivered: tin nhắn đã gửi thành công, tức là điện thoại người nhận đã báo nhận được tin nhắn.

§  Failed: không gửi được.

§  Error: lỗi, ví dụ sai số điện thoại.

o    Lưu ý: Đối với trạng thái Delivered, có 1 yêu cầu là số điện thoại người nhận đang sử dụng dịch vụ của nhà mạng có hỗ trợ tính năng “Delivery Report” nếu không trạng thái của tin nhắn mãi là queued dù số điện thoại đó đã nhận được tin nhắn (hiện tại thì tất cả các nhà mạng tại Việt Nam đều hỗ trợ tính năng này).

Chúc mừng các bạn, chúng ta đã hoàn thành xong việc gửi tin nhắn SMS qua hoiio API. Hẹn gặp lại các bạn trong những bài viết tiếp theo.

Không có nhận xét nào:

Đăng nhận xét