> For the complete documentation index, see [llms.txt](https://docs.caresoft.vn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.caresoft.vn/danh-muc/tich-hop-thoai/tich-hop-kenh-thoai-tren-ung-dung-mobile.md).
# Tích hợp kênh thoại trên ứng dụng mobile
Giải pháp tích hợp kênh thoại trên ứng dụng mobile
Trong nhiều trường hợp. Doanh nghiệp cần giữ thông suốt thông tin từ ứng dụng riêng biệt của mình trên điện thoại di động (ứng dụng trên nền tảng iOS hoặc Android). CareSoft cung cấp giải pháp tích hợp kênh thoại trên ứng dụng mobile của đối tác, cho phép user có thể nhận cuộc gọi vào và thực hiện cuộc gọi ra ngay trên ứng dụng của đối tác.
> **Yêu cầu:** Thiết bị di động của chuyên viên (điện thoại iPhone hoặc các thiết bị Android) đều cài đặt ứng dụng của doanh nghiệp và ứng dụng Caresoft
### Chuẩn bị thông tin
1. Lấy mã xác thực từ giao diện admin CareSoft. \
Truy cập vào CareSoft bằng tài khoản admin mà CareSoft cấp cho khách hàng.
2. Tại menu Admin --> Api --> Api Token. \
Ở dòng Token voice api hiện tại chọn Tạo token mới nếu chưa có hoặc Copy nếu đã có và lưu lại thành 1 cấu hình {{apiVoiceAccessToken}}
3. Thư viện JWT phù hợp với ngôn ngữ lập trình của bạn để tạo mã token cho mỗi cuộc gọi. Xem thêm ở [ www.jwt.io](https://jwt.io/)
Cách lấy và khởi tạo Voice token trên giao diện Caresoft
{% hint style="info" %}
**LƯU Ý**: Khi bấm nút tạo mới hệ thống sẽ thay thế `apiVoiceAccessToken` cũ bằng `apiVoiceAccessToken` mới khiến các ứng dụng đang tích hợp sẽ mất quyền truy cập. Vui lòng cập nhật token ở các ứng dụng theo token mới nếu bạn bấm "Tạo token mới" để đảm bảo hệ thống hoạt động liền mạch
{% endhint %}
## Cách thức tích hợp
### Chuẩn bị thông tin để tạo mã token cuộc gọi bằng JWT
**Payload:**
```json
{
"ipphone": "{{agent_id}}"
}
```
\- IpPhone Là số Iphone của Chuyên viên tương ứng (Xem thêm thông tin chuyên viên ở[ Chuyên viên](https://docs.caresoft.vn/danh-muc/restful-api-cua-caresoft/chuyen-vien)).
**Secret key** (Sign JWT):
\- Sử dụng giá trị Token voice api đã lấy được từ bước [trên](#chuan-bi-thong-tin).
### Tạo chuỗi token
Lập trình với thư viện JWT để tạo ra chuỗi token trong hình dưới là cách thức gen token sử dụng trực tiếp từ trang web jwt.io. Xem các hướng dẫn và thư viện tương thích trong mục "[Libraries](https://jwt.io/libraries)" của JWT
Ví dụ: Tạo chuỗi token đăng nhập vào hệ thống Caresoft sử dụng giao diện JWT.io
Copy chuỗi token JWT lưu thành biến **`{token}`**
*Ví dụ ở trường hợp trên sẽ là*
`eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpcHBob25lIjoie3thZ2VudF9pZH19In0.lYinFWNM9lIH8XMv5JWBvnxh0-TQbyrb-FWnHkGBNL8`
Token này sẽ lưu lại để thực hiện việc tích hợp click to call với ứng dụng Caresoft.
### Thực hiện đăng nhập vào ứng dụng CareSoft.
Để thực hiện đăng nhập với ứng dụng CareSoft, từ ứng dụng của khách hàng, thực hiện truy cập liên kết sau:
`https://mapi.caresoft.vn/mapi/dangnhap?appDomain={{domain}}&appToken={{token}}`
**Trong đó:**
\- `{{domain}}` : Tên domain của chuyên viên cần đăng nhập
\- `{{token}}` : Token được tạo theo [hướng dẫn](#tao-chuoi-token)
Ví dụ: Với token là `abc123456` và domain là `test`, thì đường dẫn cuối cùng thực hiện gọi sẽ là:
`https://mapi.caresoft.vn/mapi/dangnhap?appDomain=test&appToken=abc123456`
### Tiếp nhận cuộc gọi vào
Khi Agent để chế độ tiếp nhận trên mobile, khi cuộc gọi đến Agent sẽ tiếp nhận cuộc gọi qua ứng dụng của Caresoft, kết thúc cuộc gọi thì quay lại ứng dụng chính để làm việc tiếp.
### **Thực hiện cuộc gọi ra**
Để thực hiện luồng gọi ra, đối tác sẽ tích hợp theo dạng click to call từ ứng dụng của khách hàng bằng cách truy cập liên kết sau:
`https://mapi.caresoft.vn/mapi/call?phone={{phone}}&appToken={{token}}`
**Trong đó:**
\- `{{phone}}` : Số điện thoại cần gọi tới
\- `{{token}}` : Token được tạo theo [hướng dẫn](#tao-chuoi-token)
**Lưu ý**: đường dẫn khi tạo xong phải được encode
Ví dụ: Với token là `abc123456`, số điện thoại gọi ra là `0987654321`, thì đường dẫn cuối cùng thực hiện gọi sẽ là:
`https://mapi.caresoft.vn/mapi/call?phone=0987654321&appToken=abc123456`
### Trạng thái và lịch sử cuộc gọi
Lập trình viên có thể sử dụng API [Cuộc gọi](/danh-muc/restful-api-cua-caresoft/cuoc-goi.md) để lấy về danh sách cuộc gọi đã thực hiện của chuyên viên theo số điện thoại của khách. Xem thêm tại: \
[Cuộc gọi](/danh-muc/restful-api-cua-caresoft/cuoc-goi.md#vi-du-minh-hoa-lay-lich-su-cuoc-goi-theo-so-dien-thoai-cua-khach-cua-1-chuyen-vien)
#### **Thông tin thêm:**
Tải Ứng dụng CareSoft cho Android [tại đây](http://play.google.com/store/apps/details?id=com.csticketapp) hoặc iOS [tại đây](https://apps.apple.com/vn/app/caresoft/id1400102728)
