# Deep Links App to App

&#x20;Tài liệu hướng dẫn mở Deep Links App to App

### 1.  Yêu Cầu&#x20;

#### **a. Thiết bị đã cài đặt ứng dụng OMICALL cho cả  lẫn  android và ios**

&#x20; \- Link cài đặt iOS: [https://apps.apple.com/app/omicall](https://apps.apple.com/app/id1588489273)

&#x20;  \- 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

<figure><img src="/files/LrvNT38iurpt6aN1c9q9" alt=""><figcaption></figcaption></figure>

\- 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]\&param1=\[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 ý:*  &#x20;

*- Đị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, \&param1, \&param2 đều là các gía trị không bắt buộc, định dạng String.*

\- Ví dụ minh hoạ:

<figure><img src="/files/x35zEzbZRMQAUv6qeHHj" alt=""><figcaption></figcaption></figure>

\-       Định dạng deepLink OmiCall mở lại app của bạn:

**\[yourDeepLink]://?callomiId=\[callId]**

&#x20;    \-   Trong đó: giá trị callomiId là chuỗi string call id của cuộc gọi.\
&#x20;    \- *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:*

<figure><img src="/files/7mgFx9t6pyknXWiIv8Nq" alt=""><figcaption></figcaption></figure>

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.

&#x20;\- *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

<figure><img src="/files/6rXNgnEzPjJgMTctw8gT" alt=""><figcaption></figcaption></figure>

*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

&#x20;*Cấu hình cho phép nhân viên thực hiện cuộc gọi*&#x20;

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.

![](/files/Io1pyHGhUPuYWGGryZyJ)&#x20;

### &#x20; 3. Demo

* Link video demo tại:

<https://drive.google.com/file/d/17LJdpvcKz9rVHCAqADcbuWwkW1QKUHnj/view?usp=sharing>

\- Hình ảnh demo:

<figure><img src="/files/cVOPqBVQT9whcdHQZKP6" alt=""><figcaption></figcaption></figure>

\- 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://api.omicall.com/sdk/deep-links-app-to-app.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
