위젯 API를 사용하여 헬프 위젯의 기능을 수정할 수 있습니다. 이 문서는 유용할 수 있는 특정 사용 사례를 설명합니다.
이 문서는 Freshdesk 헬프 위젯에 대한 3부 중 2부입니다:
이 문서에는 다음이 포함됩니다: |
위젯 가시성 제어
헬프 위젯을 숨기고 특정 상황에서만 표시하는 사용 사례를 고려해 보세요. 예를 들어, 사용자가 버튼이나 링크를 클릭할 때 위젯이 특정 솔루션 문서나 연락처 양식을 표시합니다. 이를 설정하려면:
- Hide API 를 사용하여 모든 페이지에서 위젯 런처를 숨깁니다.
- 특정 페이지에 버튼을 만들고 JavaScript 함수를 매핑합니다.
- JavaScript 함수에서 Open API 를 사용하여 연락처 양식이나 솔루션 문서를 엽니다.
런처 매개변수가 있는 Hide API 를 사용하여 위젯 런처를 숨길 수 있습니다. 이 예에서는 페이지의 HTML 본문이 로드될 때 API 호출이 이루어집니다.
<body onload="FreshworksWidget('hide', 'launcher');">위젯을 숨기든 숨기지 않든, Open API 를 사용하여 연락처 양식이나 솔루션 문서를 표시할 수 있습니다. 위젯 임베드 코드 위에 함수를 배치해야 합니다.
<button onclick="openWidget()" type="button">위젯 열기</button>
<button onclick="openWidgetForm()" type="button">양식 열기</button>
<button onclick="openWidgetArticle()" type="button">문서 열기</button>
<script>
/* 이 함수는 기본 상태에서 위젯을 엽니다. */
function openWidget() {
FreshworksWidget('open');
}
/* 이 함수는 연락처 양식을 직접 엽니다. */
function openWidgetForm() {
FreshworksWidget('open', 'ticketForm');
}
/* 이 함수는 ID 123의 솔루션 문서를 직접 엽니다. */
function openWidgetArticle() {
FreshworksWidget('open', 'article', { id: 123 });
}
/* 위젯 임베드 코드를 끝에 배치하세요. */
...
</script>양식 제어
연락처 양식에 많은 필드가 있는 경우 웹사이트 경험에 따라 이를 큐레이션하고 싶을 수 있습니다. 예를 들어, 일부 필드를 숨기거나 비활성화하고 다른 필드를 미리 채우고 싶을 수 있습니다.
고객이 이미 웹사이트에 로그인한 경우 Identify API 가 이름과 이메일 주소를 가져와 연락처 양식을 채웁니다. 이름과 이메일을 저장하는 데 사용하는 변수를 사용하세요.
Prefill API 를 사용하여 모든 필드를 채울 수 있습니다. Disable ticket fields API 와 함께 사용하여 양식의 필드를 회색으로 표시하거나 Hide ticket fields API 를 사용하여 고객에게 표시되지 않도록 할 수 있습니다. 필수 필드는 비활성화하거나 숨기는 경우 미리 채워야 합니다.
/* Identify API는 고객에 대한 세부 정보를 사용하여 연락처 양식을 미리 채웁니다 */
FreshworksWidget('identify', 'ticketForm', {
name: variableName,
email: VariableEmail,
});
/* Prefill API를 사용하여 양식의 모든 필드에 값을 설정할 수 있습니다 */
FreshworksWidget('prefill', 'ticketForm', {
subject: '백설공주 티셔츠 문의'
});
/* Hide ticket fields API는 연락처 양식에서 필드를 제거합니다 */
FreshworksWidget('hide', 'ticketForm', ['subject'])
/* Disable ticket fields API는 연락처 양식에서 필드 편집을 방지합니다 */
FreshworksWidget('disable', 'ticketForm', ['subject'])추가 도움이 필요하면 위젯 API 문서를 읽거나 support@freshdesk.com으로 문의하세요.