CTI 프레임워크는 사용자가 전화 시스템을 Freshservice와 통합하여 구축할 수 있도록 합니다. 이 통합은 Freshservice 내에서 소프트폰을 구축할 수 있는 소프트폰 프레임워크를 제공합니다.
기본 API 세트는 사용자가 고객의 티켓 기록에 접근하고, 통화 노트를 작성하며, 고객 통화로부터 Freshservice 티켓을 생성할 수 있도록 하여 전체 대화의 맥락을 Freshservice에 유지합니다.
참고 사항:
- 앱을 설치하기 전에 CTI 기능이 계정에 활성화되어 있는지 확인하세요. 활성화되지 않은 경우 support@freshservice.com으로 문의하여 기능을 활성화하세요.
- 이 통합은 소프트폰 기능을 제공하지 않습니다. 그러나 Freshservice 내에서 소프트폰을 구축하는 데 도움이 되는 iframe을 제공합니다.
- 지원되는 매개변수는 agent_id, ticket_id, requester_id 및 requester_number입니다.
소프트폰 IFrame
소프트폰 iframe은 사용자 정의 소프트폰을 렌더링하고 특정 사용자 정의 기능을 활성화하는 데 사용할 수 있습니다. 현재 Freshservice는 iframe 창에서 티켓 ID를 사용하여 특정 티켓을 Freshservice 내에서 열 수 있도록 합니다. 마찬가지로, 사용자는 해당 연락처 ID를 사용하여 요청자 정보를 볼 수 있습니다.
소프트폰 IFrame 구성
Freshservice에 로그인하고 관리자 > 앱으로 이동합니다.
CTI 설정 아이콘을 클릭합니다.
소프트폰 Iframe 활성화 토글을 켭니다.
Iframe URL을 입력합니다. 요청에서 이 매개변수를 수신하기 위해 agent_id를 추가합니다. 아래 예시와 같은 형식을 따르세요:

참고: 현재 agent_id만 지원되는 매개변수입니다.
iframe의 너비와 높이를 입력합니다.
완료되면 저장 버튼을 클릭합니다.
다음 표는 사용 가능한 API를 나열합니다:
목적: | API 사용: |
iframe 열기 | window.parent.postMessage({action: "show_softphone"}, '*'); |
Freshservice 내에서 티켓 열기 | window.parent.postMessage({action: "open_ticket", value:<TICKET_ID>}, '*'); |
Freshservice 내에서 연락처 열기 | window.parent.postMessage({action: "open_contact", value:<CONTACT_ID>}, '*');
|
클릭 투 다이얼 구성
클릭 투 다이얼 설정은 UI에서 해당 필드를 클릭할 때 매개변수(requester_number, agent_id, ticket_id, 및 requester_id)를 전송할 수 있도록 합니다. 클릭 투 다이얼 기능을 구성하려면 다음 단계를 따르세요:
Freshservice에 로그인하고 관리자 > 앱으로 이동합니다.
CTI 설정 아이콘을 클릭합니다.
클릭 투 다이얼 토글을 켭니다.
요청 유형을 선택합니다.
아래 예시와 같이 콜백 URL을 입력합니다: 요청자 번호가 요청과 함께 전송됩니다.
