Tài liệu

Mobile SDK

Đưa cùng một cuộc hội thoại hỗ trợ AI-cộng-người mà bạn chạy trên web vào bên trong các ứng dụng native Android, iOS và Flutter của bạn. Một hợp đồng backend, một hành vi, ba nền tảng.

Nền tảng#

Ba SDK native chia sẻ một bề mặt API công khai giống hệt nhau. Hãy chọn cái phù hợp với ứng dụng của bạn:

SDKNgăn xếpTối thiểu
AndroidKotlin, Jetpack ComposeminSdk 24, Kotlin 2.x
iOSSwift, SwiftUI (không phụ thuộc)iOS 15+, Swift 5.9+
FlutterDart thuần, không cầu nối nativeDart 3.4+, Flutter 3.16+

Mỗi SDK hiển thị một cuộc hội thoại native thực sự dưới dạng bottom sheet phủ trên ứng dụng của bạn — không phải WebView. Ứng dụng của bạn vẽ điểm vào (một nút, một biểu tượng, một huy hiệu) và mở cuộc hội thoại bằng Respondo.open().

Những gì được bao gồm#

Các SDK di động phản chiếu bộ tính năng của widget web:

  • Lõi trò chuyện: AI agent, bàn giao trực tiếp cho nhân viên hỗ trợ, trạng thái đang gõ và đã đọc, tệp đính kèm.
  • Bảng tin ("Có gì mới") và danh sách kiểm tra onboarding.
  • Khảo sát (NPS, CSAT và nhiều hơn nữa).
  • Biểu ngữ cấp trang và teaser chủ động gắn với màn hình hiện tại. Báo cáo màn hình hiện tại bằng Respondo.setCurrentScreen("screen_name") khi điều hướng — teaser chủ động và nhắm mục tiêu cấp trang khớp với nó.
  • Thông báo đẩy cho phản hồi của nhân viên và chiến dịch, với deep link vào đúng cuộc trò chuyện.
Product tour và tooltip là các bề mặt chỉ dành cho web và không được chuyển sang các SDK di động.

Cách hoạt động#

Mỗi SDK là một client mỏng cho cùng một hợp đồng widget công khai như widget web — backend được tái sử dụng không đổi. Nhắn tin chạy trên REST cộng với một WebSocket, và việc gửi hạ cấp một cách mượt mà (WebSocket, rồi SSE, rồi REST polling) và leo trở lại ngay khi kết nối phục hồi.

Ủy quyền được phân lớp:

  • visitor_id — một id ẩn danh ổn định mà SDK tạo ra và lưu an toàn trên thiết bị: preferences được mã hóa bằng Android Keystore, keychain của iOS, và trên Flutter là một tệp riêng của ứng dụng trong storageDirectory mà bạn truyền vào init.
  • userHash — một chữ ký HMAC từ backend của bạn liên kết một cuộc trò chuyện với một người thật (xác minh danh tính).
  • session-token — được cấp cho mỗi cuộc hội thoại và phát lại trên các lệnh gọi REST và WebSocket.

Bắt đầu#

Hãy đến trang nền tảng phù hợp với ứng dụng của bạn — Android SDK, iOS SDK hoặc Flutter SDK — để cài đặt và có một init hoạt động. Sau đó thiết lập Xác minh danh tính để nhận diện người dùng đã đăng nhập trên nhiều thiết bị, và Thông báo đẩy để gửi khi ngoại tuyến.

Mỗi SDK được cài đặt từ registry của nền tảng: Android từ Maven Central (ai.respondo:respondo-sdk), iOS qua Swift Package Manager từ github.com/respondo-app/sdk-ios, và Flutter từ pub.dev (respondo_sdk). Mã nguồn Android và iOS được công khai trên GitHub.