기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon Connect에서 사용자 지정 가능한 지원되는 위젯 스니펫 필드
<a name="supported-snippet-fields"></a>

다음 테이블에는 사용자 지정할 수 있는 커뮤니케이션 위젯 스니펫 필드가 나열되어 있습니다. 테이블 다음의 예시 코드는 스니펫 필드를 사용하는 방법을 보여 줍니다.


| 스니펫 필드 | Type | 설명 | 추가 설명서 | 
| --- | --- | --- | --- | 
| `snippetId` | 문자열 | 필수, 자동 생성 | 해당 사항 없음 | 
| `styles` | 문자열 | 필수, 자동 생성 | 해당 사항 없음 | 
| `supportedMessagingContentTypes` | 배열 | 필수, 자동 생성 | 해당 사항 없음 | 
| `customLaunchBehavior` | 객체 | 웹사이트가 렌더링되고 호스팅된 위젯 아이콘을 실행하는 방식을 사용자 지정 | 이 주제의 후반부에 나오는 [Amazon Connect에서 호스팅되는 웹 사이트의 위젯 시작 동작 및 버튼 아이콘 사용자 지정](customize-widget-launch.md) | 
| `authenticate` | 함수 | 웹 사이트에서 JWT 보안을 활성화하는 콜백 함수 | 이 섹션의 전반부에 나오는 [2단계: 커뮤니케이션 위젯을 표시할 웹 사이트 도메인 지정](add-chat-to-website.md#chat-widget-domains) | 
| `customerDisplayName` | 함수 | 연락을 초기화할 때 고객 표시 이름 전달 | 이 섹션의 후반부에 나오는 [Amazon Connect 채팅이 시작될 때 고객 표시 이름 전달](pass-display-name-chat.md) | 
| `customStyles` | 객체 | 기본 CSS 스타일 재정의 | 이 섹션의 후반부에 나오는 [Amazon Connect에서 사용자 지정 속성을 전달하여 커뮤니케이션 위젯의 기본값 재정의](pass-custom-styles.md) | 
| `chatDurationInMinutes` | 숫자 | 새로 시작된 채팅 세션의 총 시간 | 기본값: 1,500 - 최소: 60, 최대: 10080 | 
| `enableLogs` | 부울 | 디버깅 로그 활성화 | 기본값: false | 
| `language` | 문자열 |  Amazon Connect는 지원되는 ISO-639 형식 언어 코드에 대한 번역을 수행할 수 있습니다. 자세한 내용은 [https://en.wikipedia.org/wiki/List\$1of\$1ISO\$1639-1\$1codes](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes)를 참조하세요. 이렇게 해도 사용자 지정 텍스트 재정의 및 메시지 콘텐츠(전송 및 수신 모두)는 변환되지 않습니다.  | 기본값: en\$1US. 지원되는 항목: 'cs\$1CZ', 'da\$1DK', 'de\$1DE', 'en\$1AU', 'en\$1CA', 'en\$1GB', 'en\$1US', 'es\$1ES', 'fi\$1FI', 'fr\$1FR', 'hu\$1HU', 'id\$1ID', 'it\$1IT', 'ja\$1JP', 'ko\$1KR', 'nl\$1NL', 'nn\$1NO' 'pt\$1BR', 'pt\$1PT', 'sk\$1SK', 'sv\$1SE', 'zh\$1CN', 'zh\$1TW' | 
| `disableCSM` | 부울 | 커뮤니케이션 위젯에서 클라이언트 측 지표 추적을 비활성화합니다. | 기본값: false | 
| `nonce` | 문자열 | iframe과 고객 웹 사이트 csp 정책 간의 핸드셰이크 값. 예: 고객 csp는 1234 논스 값을 허용합니다. iframe 상위 사이트에서 신뢰할 수 있는 스크립트임을 브라우저가 알 수 있도록 다른 스크립트를 가져오는 iframe의 경우 동일한 1234 논스 값을 가져야 합니다. | 기본값: 미정 | 
| `customizationObject` | 객체 | 위젯 레이아웃 및 트랜스크립트 사용자 지정 | 자세한 내용은 이 섹션 후반부의 [Amazon Connect 채팅 위젯에 대한 추가 사용자 지정](pass-customization-object.md) 섹션을 참조하세요. | 
| `contactAttributes` | 객체 | JWT 설정 없이 스니펫 코드에서 직접 고객 응대 흐름에 속성 전달 | 자세한 내용은 [채팅이 개시될 때 고객 응대 속성 전달](https://docs.aws.amazon.com/connect/latest/adminguide/pass-contact-attributes-chat.html)을 참조하세요. | 
| `customDisplayNames` | 객체 | Amazon Connect 관리 웹 사이트에서 설정된 시스템 또는 봇 표시 이름 및 로고 구성을 재정의합니다. | 자세한 내용은 [재정의 시스템 및 봇 디스플레이 이름과 커뮤니케이션 위젯의 로고를 전달하는 방법](https://docs.aws.amazon.com/connect/latest/adminguide/pass-custom-styles.html#pass-override-system)을 참조하세요. | 
| `contactMetadataHandler` | 함수 | contactId 액세스하기 위한 콜백 함수입니다. 예를 들어 브라우저 탭이 닫힐 때 contactId로 StopContact 함수를 호출하거나 이전 contactId로 채팅 지속성을 유지하는 등의 시나리오를 처리하려면 이벤트 리스너를 추가합니다. |  | 
| `registerCallback` | 객체 | 이렇게 하면 노출된 수명 주기 이벤트에 대한 콜백을 실행할 수 있습니다. 자세한 내용은 [amazon-connect-chatjs](https://github.com/amazon-connect/amazon-connect-chatjs)를 참조하세요. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/supported-snippet-fields.html) | 
| `initialMessage` | 문자열 | 새로 생성된 채팅으로 보낼 메시지입니다. 길이 제한: 최소 길이 1, 최대 길이 1,024 | 초기 메시지를 사용하여 고객 응대 흐름에 구성된 Lex 봇을 호출하려면 **메시지로 봇 초기화** 옵션을 선택하여 [고객 입력 흐름 가져오기 블록](get-customer-input.md)을 수정합니다. 자세한 내용은 [고객 입력 흐름 가져오기 블록 구성 방법](get-customer-input.md#get-customer-input-properties)을 참조하세요. | 
| `authenticationParameters` | 객체 | 이렇게 하면 [고객 인증](authenticate-customer.md) 흐름 블록이 활성화됩니다. | 자세한 내용은 [고객 인증 활성화](enable-connect-managed-auth.md) 단원을 참조하십시오. | 
| `mockLexBotTyping` | 부울 | Lex Bot 메시지에 대한 모의 입력 표시기를 활성화합니다. | 기본값: false | 
| `customStartChat` | 함수 | 백엔드에서 채팅 시작 API를 직접적으로 호출하는 콜백 함수입니다. | 자세한 내용은 [사용자 지정 채팅 시작 API를 사용하는 호스팅 위젯 UI](https://github.com/amazon-connect/amazon-connect-chat-interface#option-3-hosted-widget-ui-with-custom-start-chat-api)를 참조하세요. | 

다음 예시는 웹 사이트에 채팅 위젯을 추가하는 HTML 스크립트에 스니펫 필드를 추가하는 방법을 보여 줍니다.

```
(function(w, d, x, id) {   /* ... */})(window, document, 
'amazon_connect', 'widgetId');
 amazon_connect('snippetId', 'snippetId');
 amazon_connect('styles', /* ... */);
 amazon_connect('registerCallback', {
    // Custom event example
    // WIDGET_FRAME_CLOSED
    /**
     * This event is triggered when user clicks on the chat widget close button, 
     * either widget close button was clicked when error in the chat session or normally by the user. 
     * This event can be used for webview use cases to go back to main app
     * 
     * @param {string} status - The reason for widget closure
     *   - "error_chat": Indicates the user clicked on widget close button due to an error in the chat session
     *   - "close_chat": Indicates the user clicked on widget close button normally by the user
     */
    'WIDGET_FRAME_CLOSED': (eventName, { status }) => {
        // You can implement custom logic based on the status value(error_chat or close_chat)
        if (status == "error_chat") {
            // handle error chat
        } else if (status == "close_chat") {
            // handle close chat  
        } 
    },
    // System event example
    /**
     * chatDetails: { 
     *     contactId: string, 
     *     participantId: string,
     *     participantToken: string,
     * }
     * data: {
     *     AbsoluteTime?: string,
     *     ContentType?: string,
     *     Type?: string,
     *     ParticipantId?: string,
     *     DisplayName?: string,
     *     ParticipantRole?: string,
     *     InitialContactId?: string
     * }
     */
    'PARTICIPANT_JOINED': (eventName, { chatDetails, data }) => {
        alert(`${data.ParticipantRole} joined the chat.`);
    },
    'event_Name_3': callback(function),
    'event_Name_4': callback(function),
    // ...
}); 
amazon_connect('initialMessage', 'Your initial message string');
// ... 
amazon_connect('snippetFieldHere', /* ... */);
<script/>
```