1. Tính năng
- Plugin này dùng để tự động gửi SMS Brandname thông qua API Vinaphone khi đơn hàng WooCommerce thay đổi trạng thái;
- Gửi thử tin nhắn (Test);
- Xem nhật ký tin đã gửi.
2. Cài đặt plugin
- Tải file ZIP của plugin về máy.
- Truy cập WordPress Admin → Plugins → Add New → Upload Plugin
- Chọn file ZIP và bấm Install Now.
- Sau đó bấm Activate để kích hoạt plugin.
3. Vị trí menu xuất hiện trong trang quản trị
Sau khi kích hoạt, menu mới sẽ xuất hiện: Vinaphone SMS (nằm trong menu trái WordPress). Bạn bấm vào để mở trang cấu hình cho plugin.
4. Cấu hình API Vinaphone (Các thông số cấu hình ở bước này đều do nhà mạng cung cấp)
Ở giao diện cấu hình, bạn sẽ cần cung cấp các thông số cấu hình sau:
- Vinaphone API URL: Là địa chỉ WebService của Vinaphone;
- User: Tài khoản tích hợp API (sẽ được mã hóa khi lưu);
- Password: Mật khẩu tài khoản API (được mã hóa khi lưu);
- Brandname ID: ID thương hiệu đã đăng ký với Vinaphone;
- Template ID: ID mẫu tin SMS trên hệ thống Vinaphone.
Sau khi nhập xong các thông số trên, bạn bấm Lưu cấu hình.
5. Thiết lập trạng thái đơn hàng cần gửi SMS
Plugin này hỗ trợ gửi SMS khi đơn hàng thay đổi trạng thái. Để chọn đơn trạng thái sẽ gửi SMS bạn check chọn các trạng thái cần gửi trong danh sách các trạng thái sau:
-
Chờ thanh toán
-
Đang xử lý
-
Tạm giữ
-
Hoàn thành
-
Đã hủy
-
Đã hoàn tiền
-
Thất bại
* Tick chọn vào trạng thái nào thì plugin sẽ tự động gửi SMS khi đơn hàng chuyển sang trạng thái đó.
6. Tự động gửi SMS (khi đơn hàng đổi trạng thái)
Khi WooCommerce thay đổi trạng thái đơn hàng, Plugin sẽ tự động:
-
Lấy số điện thoại khách hàng
-
Chuyển định dạng 0xxxxxxxx → 84xxxxxxxx
-
Lấy đầy đủ họ tên khách hàng
-
Sinh nội dung SMS dạng:
Xin chào [HỌ TÊN], đơn hàng #[MÃ ĐƠN] của bạn đã chuyển sang trạng thái: [TRẠNG THÁI]
-
Gửi sang API Vinaphone qua SOAP 1.2
-
Ghi nhật ký để xem lại
7. Gửi thử SMS (Test chức cấu hình SMS)
Trên trang cấu hình có mục Gửi thử SMS, Bạn nhập:
-
Số điện thoại
-
Nội dung tin nhắn
Nhấn Gửi thử
Plugin sẽ gửi SMS ngay và ghi vào nhật ký.
8. Xem danh sách tin nhắn đã gửi
Cuối trang cấu hình sẽ có bảng liệt kê:
-
Số điện thoại
-
Nội dung tin
-
Thời gian gửi
-
Phản hồi từ API
Nhật ký giúp bạn:
✔ Kiểm tra có gửi thành công hay không
✔ Debug nếu API trả lỗi
✔ Theo dõi lịch sử giao dịch SMS
9. Một số lưu ý
-
Số điện thoại khách phải đúng định dạng Việt Nam bắt đầu bằng số 0.
-
Brandname, TemplateID phải được Vinaphone cấp.
-
Tài khoản API cần được kích hoạt dịch vụ SendSMSv2.
-
Nếu không gửi được, hãy kiểm tra phản hồi từ API ở mục nhật ký.
Nosomovo