# Tích hợp gọi ra sử dụng Click to call trên web Trên CRM/ERP khi phát sinh nhu cầu cần gọi điện cho khách hàng qua tổng đài CareSoft. Giúp giảm thiểu rủi ro do thao thác nhập liệu giữa các ứng dụng. Lập trình viên có thể sử dụng Click to call của CareSoft để thực hiện nghiệp vụ này. ## Các bước chuẩn bị 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. Tại menu Admin --> Api --> Api Token.
2. Ở 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}}` {% 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 %} 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/) 4. Liên kết để mở ra khi thực hiện cuộc gọi \ `https://c2c.caresoft.vn/{{domain}}/c2call?token={{token}}&number={{phoneNo}}&device={{deviceId}}`\ Trong đó `deviceId` là Id của thiết bị để gọi ra `1`: web, `2`: IPPhone ## Cách thức thực hiện. 1. Chuẩn bị payload để tạo mã token cuộc gọi 
{
    "ipphone": "{{agent_id}}",
    "expired": "2017-07-30 00:00:00",
    "callout_id":"{{callOutId}}"
  }
**Trong đó:** * `IpPhone` Là số Iphone của Chuyên viên tương ứng (Xem thêm thông tin chuyên viên ở [chuyen-vien](https://docs.caresoft.vn/danh-muc/restful-api-cua-caresoft/chuyen-vien "mention")) * `expired` Thời hạn hết hạn của token * `callout_id` ID của đầu số muốn gọi ra, nếu không truyền vào sẽ lấy đầu số default được gán cho agent để gọi ra. (Liên hệ với bộ phận hỗ trợ của CareSoft để có danh sách ID đầu số gọi ra đã tích hợp vào hệ thống) 2. 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ụ minh họa: Sử dụng giao diện web jwt.io để gen token*
Copy chuỗi token JWT lưu thành biến {{token}} \ Ví dụ ở trường hợp trên sẽ là `"eyJhbGciOiJIUzI1NiIsInR5cCI6Ik....CI6IjIwMDU3..."` 2. Nhúng link theo từng số điện thoại cần thực hiện gọi\ Lập trình viên thực hiện gép các chuỗi thông tin lại thành 1 liên kết cấu trúc như mục 1.4 và thay thế các biến thông tin thành các chuỗi giá trị liên quan. Ở đây phoneNo là số điện thoại của khách hàng cần thực hiện gọi ra. \ `https://c2c.caresoft.vn/{{domain}}/c2call?token={{token}}&number={{phoneNo}}&device={{deviceId}}`\ \ Sử dụng popup để mở ra cửa sổ mới với link trên. 3. Tham khảo code html {% code title="Code html tham khảo " %} ```html

CRM

``` {% endcode %} Cửa sổ mở ra đường link trên sẽ có dạng
{% hint style="info" %} **GỢI Ý:**\ Lập trình viên có thể bổ sung callback để lưu thông tin cuộc gọi lại phục vụ các nghiệp vụ khác {% endhint %} Mẫu dữ liệu callback CareSoft sẽ trả lại cửa sổ chính sau khi cuộc gọi kết thúc và cửa sổ cuộc gọi bị đóng lại. 
{
  "id": 8,
  "type": "call_ended",
  "data": {
    "customer_phone": "09xxxxxx",
    "call_id": "20230412120428-OUTHJAMC-47"
  },
  "origin": "caresoft",
  "queryString": "?token=eyJhbGciOiJIUz....mLNv54j34jZR7-baoSfEWqzlMxwyrcX_Ec&number=09xxxxxx"
}
[^1]: null hoặc Liên hệ với bộ phận hỗ trợ của CareSoft để có danh sách ID đầu số gọi ra đã tích hợp vào hệ thống [^2]: call\_ended: Kết thúc\ call\_starting: Bắt đầu [^3]: Số điện thoại gọi đến [^4]: ID cuộc gọi