1. Tổng quan

• Đây là tính năng cho phép quản trị viên thiết lập kết nối API giữa hệ thống Mobio và các nhà cung cấp dịch vụ (Google, Microsoft). Việc cấu hình này là bước đệm kỹ thuật bắt buộc để người dùng có thể tích hợp và sử dụng tính năng Work Email và Calendar trên Mobio.
• Lợi ích/Giá trị:
  • Quản lý và nhắc nhở công việc với Calendar.
  • Quản lý và gửi/nhận email ngay trên Mobio mà không cần mở thêm ứng dụng khác.
• Đối tượng sử dụng: Quản trị viên hệ thống hoặc nhân sự IT của doanh nghiệp.

2. Giải thích Thuật ngữ & Thông số

• Client_ID: Mã định danh công khai cho ứng dụng do Google/Microsoft cấp để Mobio nhận diện ứng dụng của doanh nghiệp.
• Client_Secret: Mã bảo mật (mật khẩu) dùng để xác thực ứng dụng, chỉ có Admin và hệ thống biết.
• Merchant ID: Mã riêng cho từng doanh nghiệp trên Mobio. Liên hệ team CS hoặc kỹ thuật Mobio để nhận thông tin này.

3. Điều kiện tiên quyết (Prerequisite)

• Điều kiện cần:
  • Có tài khoản quản trị trên Google Cloud Console (đối với Google App) hoặc Azure Portal (đối với Outlook App).
  • Xác định được mô hình quản lý App: Do doanh nghiệp tự quản lý hay ủy quyền cho Mobio quản lý.
• Dữ liệu đầu vào: Danh sách các quyền mà Mobio yêu cầu để truy cập Email và Calendar. Liên hệ team CS hoặc kỹ thuật Mobio để nhận thông tin này.

4. Các bước thực hiện

Xác định phương thức quản lý App

Doanh nghiệp lựa chọn 1 trong 2 phương án:

• Phương án 1: Sử dụng App do Mobio quản lý → Chuyển sang Bước 2.
• Phương án 2: Tự xây dựng và quản lý App riêng → Chuyển sang Bước 3.

Phối hợp thực hiện với Mobio (Nếu chọn PA1)

• Hành động: Admin thông báo cho team CS/ kỹ thuật của Mobio về việc sử dụng app của Mobio.
• Kết quả: Mobio sẽ xác định Merchant ID và thực hiện tất cả các bước cấu hình kỹ thuật và báo lại cho doanh nghiệp khi quá trình tích hợp hoàn tất.

Cung cấp thông tin App cho Mobio (Nếu chọn PA2)

• Hành động: Admin thực hiện tạo App trên Google/Outlook, sau đó gửi các thông tin sau cho team CS/ kỹ thuật của Mobio:
  1. Client_ID
  2. Client_Secret
• Kết quả: team CS/kỹ thuật của Mobio nhận thông tin để cấu hình tích hợp.

Cấu hình quyền (Scopes) trên App khách hàng

• Hành động: Admin truy cập vào trang quản lý App của mình và cấu hình thêm các quyền (Permission) theo danh sách yêu cầu từ Mobio.
• Lưu ý: Cấu hình quyền cho App Outlook và Google về cơ bản là thực hiện như nhau.
• Kết quả: App sẵn sàng để người dùng cuối thực hiện kết nối cá nhân.

Lưu ý: Nếu doanh nghiệp đã có App kết nối Work Email từ trước, khi muốn dùng thêm tính năng Calendar, bạn không cần tạo App mới hay xin thêm quyền khác vì hai tính năng này dùng chung 1 App kết nối.

5. Quy tắc vận hành

• Quy tắc “Một cho tất cả”: Hệ thống Mobio được thiết kế để sử dụng chung một App ID cho cả dịch vụ Email cá nhân và Lịch. Điều này giúp tối ưu hóa việc quản lý token và hạn chế việc người dùng phải đăng nhập/cấp quyền nhiều lần.

6. Các câu hỏi thường gặp (FAQ)

• Tại sao tôi phải cung cấp Client_Secret cho MBO?
  • Trả lời: Client_Secret là thành phần bắt buộc trong giao thức OAuth2 để Mobio có thể trao đổi mã xác thực lấy Access Token, giúp duy trì kết nối ổn định cho người dùng.
• Tôi nên tự quản lý app hay dùng app của Mobio?
  • Trả lời: Nếu doanh nghiệp có đội ngũ IT và muốn kiểm soát chặt chẽ các ứng dụng bên thứ ba truy cập vào hệ thống mail nội bộ, nên chọn tự quản lý App. Hoặc nếu doanh nghiệp đang triển khai theo mô hình on-premise/self-hosted, việc tự tạo và quản lý app là hợp lý. Nếu muốn triển khai nhanh và giảm bớt gánh nặng kỹ thuật, hoặc doanh nghiệp đang triển khai theo mô hình cloud-based, nên sử dụng App của Mobio.

7. Bước tiếp theo

Kết nối và Quản lý Work Email cá nhân

Kết nối và Quản lý tài khoản Calendar