# Deep Links App to App Tài liệu hướng dẫn mở Deep Links App to App ### 1. Yêu Cầu #### **a. Thiết bị đã cài đặt ứng dụng OMICALL cho cả lẫn android và ios** \- Link cài đặt iOS: [https://apps.apple.com/app/omicall](https://apps.apple.com/app/id1588489273) \- Link cài đặt Android: [https://play.google.com/store/apps/omicall](https://play.google.com/store/apps/details?id=vn.vihat.omicall) #### b. Yêu cầu người dùng đã đăng nhập sẵn vào ứng dụng OMICALL và luôn bật trạng thái kết nối tổng đài

\- Hình ảnh mô tả trường hợp người dùng tắt kết nối tổng đài ### 2. Hướng dẫn #### a. Hướng dẫn thực hiện hiện cuộc gọi từ app khách hàng sang app OMICAL * Từ App của khách hành thực hiện cuộc gọi sang App OMICALL trên nền tảng iOS/Android theo cú pháp: **omicall-call:\[phoneNumber]\&deeplink=\[yourDeepLink]\¶m1=\[yourContent1]& param2=yourContent2]** *Trong đó :* * “**omicall-call**” là cú pháp của OMI * “**\[phoneNumber]**” là chuỗi string số điện thoại khách hàng cần gọi đến *(lưu ý: quý khách hàng tự validate số điện thoại của mình hợp lệ trước khi gọi sang OMI).* * “**\[yourDeepLink]**” là deeplink ứng dụng khách hàng cần callback mở lại app của mình sau khi KH bấm nút SaveCall trên app OMI. * **\[yourContent1]** là nội dung khách hàng cần lưu vào cuộc gọi khi truyền sang app OMI. * **\[yourContent2]** là nội dung khách hàng cần lưu vào cuộc gọi khi truyền sang app OMI. *Lưu ý:* *- Định dạng khi lưu sẽ là: **yourContent1-yourContent2*** *- DeepLink khách hàng truyền sang OMI là định dạng **https**.* *- Các giá trị \&deeplink, \¶m1, \¶m2 đều là các gía trị không bắt buộc, định dạng String.* \- Ví dụ minh hoạ:

\- Định dạng deepLink OmiCall mở lại app của bạn: **\[yourDeepLink]://?callomiId=\[callId]** \- Trong đó: giá trị callomiId là chuỗi string call id của cuộc gọi.\ \- *Khai báo cấu hình deeplink của OMI cho ios: Trong file Info.plit của ios KH cần khai báo thêm key sau:*

b. **Hướng dẫn cấu hình phân quyền nâng cao** Trước tiên, khách hàng cần truy cập vào mục *Cấu hình* tại Web OMI (sso.omicrm.io) với tài khoản quản trị của mình. \- Tiếp theo chọn mục *Doanh Nghiệp* -> *Phân Quyền*. Chọn bộ phân quyền cần cập nhật của khách hàng. \- *Bật/tắt tính năng ẩn/hiện số điện thoại khách hàng gọi đến/ra.* o Khách hàng chọn *Menu Tính Năng* -> *Khách hàng* -> Bảo mật dữ liệu

*Cho phép xem Số điện thoại*: Tích chọn, cho phép nhân viên xem được số điện thoại trên ứng dụng *Cấu hình cho phép nhân viên thực hiện cuộc gọi* Khách hàng chọn mục *Nâng Cao*. * *Nhập thủ công*: Tích chọn là cho phép nhân viên nhập số điện thoại gọi ra ở màn hình bàn phím. * *Khách hàng*: Tích chọn là cho phép nhân viên thực hiện cuộc gọi ra *thuộc tab OMI và thiết bị* ở màn hình *Danh bạ* trên App OMICALL. * *Nhân viên*: Tích chọn là cho phép nhân viên thực hiện cuộc gọi ở *tab Nhân viên* thuộc màn hình *Danh bạ* trên app OMICALL. * *Lịch sử cuộc gọi*: Tích chọn là cho phép nhân viên thực hiện cuộc gọi ở màn hình *lịch sử cuộc gọi* trên app OMICALL. ![](https://3454047468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LukDt3aTxo8xMLonIwO%2Fuploads%2FBqYtp16nemzIxyQilXyH%2FCleanShot%202024-08-27%20at%2011.24.44.png?alt=media\&token=a9afe610-9d52-40fd-a4dd-c45c7a4bae00) ### 3. Demo * Link video demo tại: \- Hình ảnh demo:

\- Giao diện cuộc gọi trong ứng dụng OMICALL khi quý khách hàng đẩy số điện thoại sang và giao diện CallKit của hệ thống iOS khi thực hiện cuộc gọi