Tích hợp Webpush Notification (optional)
1. Tổng quan
- Webpush Integration là quá trình kết nối website với dịch vụ gửi thông báo của Google (Firebase Cloud Messaging – FCM). Sau khi nhúng SDK Mobio thành công, nếu doanh nghiệp có nhu cầu tương tác với khách hàng ngay cả khi họ đã rời website, cần thực hiện tích hợp kênh Web Push.
- Lợi ích: Tiếp cận khách hàng ngoài phiên truy cập thông qua thông báo đẩy trên trình duyệt.
- Đối tượng sử dụng: Lập trình viên hoặc kỹ thuật viên có quyền quản trị dự án trên Google Firebase và quyền truy cập server website.
2. Giải thích Thuật ngữ & Thông số
- FCM (Firebase Cloud Messaging): Nền tảng trung gian của Google giúp gửi thông báo.
- Service Worker: Tệp JavaScript chạy ngầm để nhận tin ngay cả khi đóng tab web.
- Tính tương thích trình duyệt: Hỗ trợ tất cả các trình duyệt trừ Safari.
3. Điều kiện tiên quyết (Prerequisite)
- Đã hoàn thành bước Tích hợp SDK Mobio vào Website (Dành cho Kỹ thuật)
- Quyền truy cập: Tài khoản Mobio phải được cấp quyền RBAC: Integration, mục Cài đặt > Cài đặt doanh nghiệp > Tích hợp > Web Push để lấy tệp Mobio SDK. Xem hướng dẫn thiết lập quyền RBAC tại đây.
- Tài khoản Firebase: Đã khởi tạo Project trên Firebase Console.
- Quyền quản trị server: Có khả năng tải tệp lên thư mục gốc (Root Directory) của website.
4. Các bước thực hiện
Bước 1: Lấy thông số từ Firebase Console
Bạn cần truy cập vào Project Firebase của doanh nghiệp để lấy 05 thông số quan trọng sau trong phần Project Settings:
- Server Key (Trong tab Cloud Messaging).
- API Key (Trong tab General).
- Project ID.
- Messaging Sender ID.
- App ID.
Bước 2: Khai báo thông số trên Mobio
- Truy cập màn hình Cài đặt → Tích hợp kênh tương tác → Website → Cấu hình tích hợp Web Push
- Chọn tab Thông số tích hợp Firebase.
- Nhấn Sửa cấu hình (biểu tượng chiếc bút).
- Nhập đầy đủ 05 thông số đã lấy ở Bước 1 vào các trường tương ứng.
- Nhấn Lưu.
Bước 3: Cài đặt tệp Service Worker lên Website
Đây là bước bắt buộc để trình duyệt có thể nhận tin nhắn đẩy:
- Tại tab Thông số tích hợp Firebase, tải tệp Mobio Service Worker về máy tính.
- Tải tệp này lên Thư mục gốc (Root Directory) của website (Ví dụ:
https://yourdomain.com/mobio-worker.js).- Lưu ý: Tệp phải nằm ở thư mục gốc, không được nằm trong thư mục con để đảm bảo quyền kiểm soát của trình duyệt.
5. Quy tắc vận hành
- Việc tích hợp Webpush là tùy chọn (Optional). Bạn có thể sử dụng SDK Mobio để tracking mà không cần cấu hình Firebase nếu không có nhu cầu gửi thông báo đẩy.
- Cả 5 trường thông số Firebase (Server Key, API Key, Project ID, Messaging Sender ID, App ID) đều là bắt buộc (Required). Nếu thiếu bất kỳ trường nào, hệ thống sẽ không cho phép lưu cấu hình.
- Hệ thống chỉ có thể gửi Webpush sau khi khách hàng truy cập website và nhấn vào nút “Allow” (Cho phép) trên trình duyệt.
6. Các câu hỏi thường gặp (FAQ)
- Tôi lấy Server Key ở đâu trong Firebase?
- Bạn vào Project Settings -> Cloud Messaging. Nếu chưa thấy Server Key, hãy bật “Cloud Messaging API (Legacy)” trong Google Cloud Console.
- Tại sao tôi đã cấu hình đúng nhưng không nhận được thông báo test?
- Hãy kiểm tra xem tệp Service Worker đã được tải lên đúng thư mục gốc chưa. Bạn có thể kiểm tra bằng cách gõ trực tiếp đường dẫn
yourdomain.com/tên-file-worker.jstrên trình duyệt, nếu hiển thị nội dung code là đúng.
- Hãy kiểm tra xem tệp Service Worker đã được tải lên đúng thư mục gốc chưa. Bạn có thể kiểm tra bằng cách gõ trực tiếp đường dẫn
- Hệ thống có báo lỗi nếu tôi nhập sai thông số Firebase không?
- Mobio sẽ kiểm tra định dạng dữ liệu (không để trống). Tuy nhiên, tính chính xác của Key phụ thuộc vào việc bạn copy từ Firebase. Nếu nhập sai Key, tin nhắn sẽ không được gửi đi thành công từ phía Firebase.
