1. Tổng quan

Đây là bước khởi tạo đầu tiên trong quá trình tích hợp App-push. Việc khai báo này giúp Mobio cấp phát các mã định danh riêng biệt để phân biệt dữ liệu giữa các ứng dụng hoặc các môi trường khác nhau.

Lợi ích/ Giá trị:

• Thiết lập cấu hình dành riêng cho từng ứng dụng.
• Cung cấp bộ thông số kỹ thuật cần thiết để kích hoạt SDK hoạt động trên môi trường app.

Đối tượng thực hiện: Quản trị hệ thống hoặc nghiệp vụ.

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

• App Push (Push Notification) là hình thức gửi thông báo từ hệ thống backend tới ứng dụng mobile thông qua các push notification service (như FCM, APNs). SDK được tích hợp trong app để đăng ký device token, nhận và xử lý thông báo.
• Merchant ID: Mã định danh duy nhất của doanh nghiệp trên hệ thống Mobio.
• Connector ID: Mã định danh của connector dành riêng cho ứng dụng vừa khai báo.
• API URL: Địa chỉ máy chủ của Mobio mà SDK sẽ gửi dữ liệu về.

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

• Quyền hạn: 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 > Kênh thông điệp > App-push. Xem hướng dẫn Cấu hình phân quyền RBAC tại đây.
• Chuẩn bị: Xác định rõ nền tảng ứng dụng cần tích hợp là iOS hay Android và ngôn ngữ lập trình là gì (Nếu có cả hai, phải thực hiện khai báo hai lần để lấy hai Connector ID khác nhau).
• Môi trường:
  • Android: Android Studio, SDK bản 21 trở lên.
  • iOS: Xcode, CocoaPods, hỗ trợ iOS 11.0 trở lên.
• Chứng chỉ Push: Đã có file .p8 (iOS) hoặc Server Key/JSON (Android) để cấu hình trên Mobio.

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

Bước 1: Truy cập khu vực quản lý App-push

• Từ màn hình chính của Mobio, chọn biểu tượng Cài đặt doanh nghiệp.
• Tại cột menu bên trái, tìm đến mục Tích hợp kênh tương tác → Chọn App push.
• Nhấp chọn nút Thêm ứng dụng mới.

Bước 2: Khai báo thông tin ứng dụng

• Tên ứng dụng: Đặt tên gợi nhớ
• Ảnh ứng dụng: tải file lên,
• Danh sách màn hình: tải file lên, định dạng cho phép là .xlsx. Dung lượng tối đa 10 MB/file.
• Chọn ngôn ngữ phát triển cho từng hệ điều hành:
  • iOS: Swift / Objective-C
  • Android: Java / Kotlin.
  • Nếu ngôn ngữ phát triển ứng dụng của bạn không có trong danh sách, liên hệ CS Mobio để được hỗ trợ.

Bước 3: Cấu hình tích hợp app-push (Tùy chọn)

Sau khi Lưu ở Bước 2, pop-up cấu hình sẽ hiện ra. Nếu doanh nghiệp có nhu cầu đẩy tin Push từ Mobio thì thực hiện cấu hình, nếu không có thể đóng pop-up.

• Nhập thông tin cấu hình app-push
  • Android:
    • Service Account JSON: tải lên file định dạng .json
    • Package Name
  • iOS:
    • Authentication Key: tải lên file định dạng .p8
    • Key ID
    • Team ID
    • App Bundle ID
• Bấm Lưu để hoàn tất cấu hình.

Mẹo nhỏ: Bạn có thể quay lại cấu hình/chỉnh sửa bước này bất cứ lúc nào bằng cách bấm vào nút Cấu hình tích hợp app push trên giao diện quản lý app.

Bước 4: Lấy thông tin tích hợp

• Tại danh sách ứng dụng vừa tạo, nhấn vào Tên ứng dụng để mở pop-up chi tiết ứng dụng
• Sao chép các thông số sau và gửi lại cho team kỹ thuật app:
  1. Merchant ID
  2. Connector ID
  3. API URL

Mẹo nhỏ/Tooltips:

• Nên lưu các thông số này vào một file text và gửi cho team kỹ thuật app để tránh nhầm lẫn hoặc thất lạc thông tin.
• Kiểm tra kỹ xem Connector ID bạn lấy có đúng với nền tảng (iOS hay Android) mà team kỹ thuật app đang yêu cầu hay không.

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

• Đối với doanh nghiệp có nhiều ứng dụng: Mỗi ứng dụng (ví dụ: App cho khách hàng và App cho shipper) phải được khai báo thành 2 mục riêng biệt để có 2 Connector ID khác nhau, giúp việc phân loại dữ liệu chính xác.
• Giới hạn hệ thống: Một ứng dụng khi đã khai báo nền tảng là iOS thì không thể đổi trực tiếp sang Android. Nếu nhầm lẫn, bạn phải xóa và khai báo lại từ đầu.

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

• Tôi có cần lấy lại Merchant ID cho mỗi lần thêm App không?
  • Trả lời: Không. Merchant ID là mã định danh chung của cả doanh nghiệp, thông số này sẽ giống nhau cho mọi ứng dụng bạn tích hợp vào cùng một tài khoản Mobio. Chỉ có Connector ID là thay đổi theo từng ứng dụng.

Bước tiếp theo