Hướng dẫn tích hợp SDK Android cho chăm sóc khách hàng đa kênh

Hướng dẫn chi tiết cách tích hợp SDK Android của Salesmartly để quản lý và chăm sóc khách hàng đa kênh hiệu quả. Bao gồm các bước cài đặt và phương thức khởi tạo.

1. Hướng dẫn tích hợp SDK Android

Lưu ý: Yêu cầu phiên bản Android >= 7.0 và phiên bản Webview >= 53

1.1. Các quyền cần thiết trong Manifest

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

1.2. Địa chỉ tải gói AAR

Truy cập tại đây

1.3. Các phương thức khởi tạo SDK

1.3.1. Khởi tạo SDK

SaleSmartyInit.init(Context context,String scriptUrl);

Giải thích: scriptUrl là đường dẫn js cần chèn, ví dụ: https://assets.salesmartly.com/js/project_xxxxx.js

1.3.2. Khởi tạo trang SaleSmarty

SaleSmartyInit.initSaleSmartyView(Activity activity);

Mẹo: Nên thực hiện khởi tạo trình duyệt càng sớm càng tốt trong Activity

1.3.3. Thêm trình duyệt vào layout cha

SaleSmartyInit.addSaleSmartyView(ViewGroup viewGroup);

Quan trọng: Activity chứa layout cha phải trùng với Activity đã thực hiện khởi tạo trang salesmarty

1.3.4. Tải lên thông tin người dùng

SaleSmartyInit.uploadUserMessage(String user_id,
                               String user_name,
                               String language,
                               String phone,
                               String email,
                               String description,
                               String[] label_names);

Lưu ý: Hiện chưa hỗ trợ callback khi tải thông tin. Các trường user_id và user_name là bắt buộc

1.3.5. Mở cửa sổ chat

SaleSmartyInit.openSaleSmartyView();

1.3.6. Đóng cửa sổ chat

SaleSmartyInit.closeSaleSmartyView();

1.3.7. Lấy số tin nhắn chưa đọc

SaleSmartyInit.setUnReadMessagesListener(c var0);

Giải thích: Interface c sẽ trả về giá trị int - số lượng tin chưa đọc

1.3.8. Callback chọn file

SaleSmartyInit.upLoadFiles(int requestCode,Intent var0);

Hướng dẫn: Gọi phương thức này trong onActivityResult của Activity đã khởi tạo trang salesmarty

1.3.9. Listener hoàn tất tải (từ v1.2.0)

SaleSmartyInit.setOnReadyListener(c var0);

1.3.10. Listener mở cửa sổ

SaleSmartyInit.setOnOpenSaleSmartyViewListener(c var0);
// Từ phiên bản 1.2.0 sẽ tự động mở cửa sổ

1.3.11. Listener đóng cửa sổ

SaleSmartyInit.setOnCloseSaleSmartyViewListener(c var0);

1.4. Ví dụ minh họa

Tải xuống demo SDK Android SaleSmartly tại đây