API를 사용하여 Guide 사용자 정의

Guide 은(는) JavaScript(JS) 코드를 사용합니다. Guide 참여를 사용하려는 웹사이트 페이지에 이 코드를 추가해야 합니다. 이 JS 코드에 API API는 CXone 시스템을 조직에서 사용하는 다른 소프트웨어와 연결하여 특정 기능을 자동화할 수 있습니다. 호출을 추가하여 Guide을(를) 사용자 정의할 수 있습니다.

프로덕션 환경에 릴리스하기 전에 테스트 환경에서 Guide 사용자 정의를 설정하십시오. 이렇게 하면 웹사이트 방문자에 대한 방해를 최소화하는 데 도움이 됩니다. 또한 사용자 정의의 목표대로 작동하는지 확인하는 데 도움이 됩니다.

CSS API 호출 사용자 정의

이 섹션의 호출을 통해 Guide 위젯의 CSS 요소를 변경할 수 있습니다. 예:

cxone('guide', 'setCustomCss', '[data-selector="GUIDE_ELEMENT"] {background: red !important;}');

이 스니펫을 사용하려면 GUIDE_ELEMENT를 다음 표의 값으로 바꾸고 중괄호 { } 안의 예시 CSS를 사용자 정의 CSS로 바꾸세요.

Guide 인터페이스	GUIDE_ELEMENT 값
Guide 위젯 및 버튼	GUIDE_CHANNEL_BUTTON GUIDE_CHANNEL_BACK_BUTTON GUIDE_CHANNEL_CLOSE_BUTTON GUIDE_FRAME_CONTENT GUIDE_CHANNEL_ICON GUIDE_CHANNEL_MENU_ICON
포털	PORTAL_HEADER_iCON PORTAL_HEADER PORTAL_TITLE PORTAL_SUBTITLE GUIDE_CHANNEL_BUTTON_1 GUIDE_CHANNEL_BUTTON_2 GUIDE_CHANNEL_BUTTON_3 GUIDE_CHANNEL_BUTTON_4 GUIDE_MENU_BUTTON KB_WIDGET_TITLE KB_WIDGET_SEARCHBAR KB_SEE_MORE_BUTTON PORTAL_BODY KB_WIDGET CHANNELS_WIDGET
문서	KB_HEADER KB_BODY
채팅 및 이메일	PRECONTACT_SURVEY BEGIN_CHAT SEND_EMAIL INPUT TEXTAREA DROPDOWN TREE PRECONTACT_SURVEY_DESCRIPTION PRECONTACT_SURVEY_ICON TREE_POPUP_BACK_BUTTON CLOSE_TREE_POPUP CLOSE
능동적 제안	OFFER_CLOSE_BUTTON OFFER_HEADER OFFER_BODY OFFER_BUTTON_1 OFFER_BUTTON_2 OFFER_BUTTON_3

이 섹션의 호출로 웹 사이트에 나타나는 채널 버튼의 크기와 위치를 조정할 수 있습니다.

채널 버튼에 사용할 크기를 설정합니다. 값을 em 또는 픽셀 단위로 입력하세요. 기본 버튼 크기는 3em입니다.

cxone('guide', 'setButtonSize', '80px');

채널 버튼에 사용할 오프셋 값을 설정합니다. 값을 em 또는 픽셀 단위로 입력하세요.

cxone('guide', 'setOffsetX', '48px');

cxone('guide', 'setOffsetY', '3em');

이 섹션의 호출을 통해 채널 버튼의 가이드 메뉴를 열고 닫을 수 있습니다.

버튼의 Guide 메뉴를 표시합니다.

cxone('guide', 'openMenu');

버튼의 Guide 메뉴를 닫습니다.

cxone('guide', 'closeMenu');

이 섹션의 호출을 통해 Guide 위젯에 사용되는 글꼴 크기를 변경할 수 있습니다.

Guide 위젯에 사용되는 기본 글꼴 크기를 설정합니다. 값을 픽셀 단위로 입력하세요. 기본 글꼴 크기는 13픽셀입니다. 여기에 설정된 값은 Guide 전체에 사용되는 em 크기를 결정합니다.

cxone('guide','setFontSize',12);

이 섹션의 호출을 통해 Guide 위젯의 높이와 너비를 변경할 수 있습니다.

Guide 위젯의 높이를 설정합니다. 값을 em 또는 픽셀 단위로 입력하세요. 기본 높이는 40em입니다. 최대 높이는 40 rem입니다.

cxone('guide','setDesiredGuideHeight','30em');

Guide 위젯의 높이를 설정합니다. 값을 em 또는 픽셀 단위로 입력하세요. 기본 너비는 23.125em입니다.

cxone('guide','setDesiredGuideWidth','608px');

이 섹션의 호출을 사용하면 가이드의 모양을 사용자 지정할 수 있습니다.

가이드를 전체 화면 모드로 표시할 수 있습니다. 가이드 콘텐츠가 가이드 위젯 대신 창에 표시됩니다.

cxone('guide','setFullDisplay');

채널 버튼을 먼저 표시하지 않고 바로 가이드 진입점을 표시할 수 있습니다. 예를 들어 채팅 창, 이메일 양식 또는 지식 베이스 위젯을 표시할 수 있습니다.

이 API를 사용하려면 표시할 진입점의 ID를 전달해야 합니다. 진입점 옆의 편집을 클릭한 다음 페이지 URL의 마지막 부분을 복사하면 진입점 ID를 얻을 수 있습니다.

cxone('guide','openEntrypoint','e1348160-2016-4d91-958e-fd063c669fe6');

이 API를 사용하여 사전 컨택 웹 설문조사를 표시하지 않고 채팅을 시작하도록 가이드에게 지시할 수 있습니다.

cxone('guide','hidePreSurvey');

채팅 API를 사용하여 사전 컨택 웹 설문조사 값을 미리 설정할 수 있습니다. 또는 hidePreSurvey API의 매개변수로 지정할 수도 있습니다. 예:

cxone('guide','hidePreSurvey', 'Dre', 'dre@classics.com');