일부 제품과 기능의 이름이 변경되고 있습니다. 생성형 플레이북 및 흐름 기능도 단일 통합 콘솔로 마이그레이션되고 있습니다. 세부정보를 참조하세요.

주문 교환 사전 빌드 구성요소

주문 교환 사전 빌드 구성요소는 사용자의 인증 수준을 확인합니다. 사용자가 인증되면 구성요소는 사용자의 최근 또는 과거 주문에 대한 정보를 제공합니다. 그러면 사용자는 한 주문의 여러 상품을 교환하도록 선택하고 환불 및 배송 방법을 포함한 옵션을 선택할 수 있습니다. 이 구성요소는 소매 인증 사전 빌드 구성요소를 사용하여 사용자를 인증합니다. 이 구성요소는 또한 통화 후 요약 및 FAQ를 위해 생성기를 사용합니다.

제한사항

사전 빌드 구성요소에는 일반적인 사전 빌드 구성요소 제한사항 외에도 다음과 같은 제한사항이 있습니다.

이 구성요소는 데이터를 암호화하지 않습니다.

샘플 대화상자

다음 샘플 대화상자에서는 사전 빌드된 구성요소에서 처리하는 일반적인 시나리오를 보여줍니다. 샘플 대화상자는 전화를 사용하여 구성요소가 호출될 때 기본 시작 인텐트와 대화 시작 시 첫 번째 에이전트 응답을 트리거하는 동작을 보여줍니다.

결함이 있는 상품 매장 교환

최종 사용자가 이전에 인증되었습니다. 에이전트는 가장 최근 주문에서 교환해야 하는 상품을 확인하고 교환 이유를 수집합니다. 사용자가 매장에서 상품을 교환하도록 선택하면 에이전트가 가장 가까운 매장 목록을 제공합니다. 사용자가 매장을 선택하면 에이전트는 사용자의 등록된 채널로 전송되는 배송물 라벨을 생성합니다.

사용자 입력	에이전트 응답
	2023년 11월 10일에 접수된 전등 2개, Pixel 2개, 기타 제품 10개를 포함한 12375로 끝나는 최근 주문 번호에 대해 문의하시는 건가요?
예
	주문에서 해당되는 제품이 몇 개 발견되었습니다. 교환하려는 제품을 알려주세요. 제품 1: Google 전등, 제품 2: Google Pixel, 제품 3: Google LED 조명. 선택하려는 상품의 제품 번호를 말하거나 입력하고, 더 많은 제품을 표시하려면 다음이라고 말해 주세요.
1
	Google 전등을 교환하고 싶다고 하셨습니다. 이 정보가 맞나요?
예
	선택한 제품의 가용 수량이 2인 것을 파악했습니다. 교환할 제품의 수량을 지정해 주세요.
2
	교환 이유를 알려주세요. 상품에 결함이 있거나 상품이 작동하지 않음, 사이즈 또는 핏 문제, 불완전한 주문 문제, 스타일 문제, 잘못된 색상이라고 말하거나 기타라고 말하면 됩니다.
상품 결함
	알려주셔서 감사합니다. 마지막 단계입니다. 제품을 어떻게 교환하시겠습니까? 매장에서 교환이나 회수 예약과 같이 말하면 됩니다.
매장에서 교환하고 싶습니다.
	가까운 매장을 찾아보세요.
	에이전트가 우편 번호 수집 사전 빌드 구성요소를 사용해서 우편 번호를 수집합니다.
	입력한 우편번호 근처의 위치 목록입니다. 주소 1: Google Texas, 500 W 2nd St, Suite 2900 Austin, Texas 78701, US. 주소 2: Google California, 19510 Jamboree Road, Irvine, California 92612, US. 선택하려는 주소 번호를 말하거나 입력합니다. 또는 '다음'이라고 말하면 더 많은 매장 주소가 표시됩니다.
첫 번째 매장
	선택하신 주소는 Google Texas, 500 W 2nd St, Suite 2900 Austin, Texas 78701, US입니다. 맞나요?
예
	감사합니다. 등록된 전화번호와 이메일로 배송물 라벨과 티켓 번호를 보냈습니다. 이를 인쇄한 후 패키지에 부착한 다음 30일 이내에 교환하세요. Google 창고에 상품이 도착한 후 교환 차액(있는 경우)이 계좌에 입금되기까지 영업일 기준 3~5일이 걸립니다. 참고: 환불 금액은 배송 및 취급 수수료를 제외한 금액입니다. 교환 제품의 가격이 더 높습니다. 가격 차이는 20달러입니다. 등록된 휴대전화 번호로 곧 결제 링크가 전송됩니다. 교환을 접수하려면 24시간 이내에 결제해 주세요. 다른 주문을 교환하시겠어요?
아니요, 다 됐어요.
	전화해 주셔서 감사합니다.

가격 차이로 인한 환불

최종 사용자가 이전에 인증되었습니다. 에이전트가 주문 번호, 교환할 제품, 교환 이유를 수집합니다. 사용자가 상품을 다른 사이즈로 교환하기로 선택하고 회수를 예약합니다. 에이전트가 교환된 상품의 가격이 새 상품보다 낮다는 것을 확인하고 사용자에게 환불을 위한 결제 수단을 확인합니다.

사용자 입력	에이전트 응답
	2023년 11월 10일에 접수된 전등 2개를 포함한 12345로 끝나는 최근 주문 번호에 대해 문의하시는 건가요?
아니요
	다른 주문을 교환하시겠어요?
예
	교환하려는 주문 ID의 마지막 5자리를 알려주세요.
12346
	해당 주문 ID의 마지막 5자리가 12346입니다. 맞습니까?
예
	좋습니다. 주문 ID 수집이 완료되었습니다. 주문에서 요건을 충족하는 제품을 찾았습니다. 교환하려는 제품을 알려주세요. 제품 1: Google 물병, 제품 2: Google 티셔츠. 원하는 상품의 제품 번호를 말하거나 입력하세요. 또는 더 많은 제품을 표시하려면 다음이라고 말하세요.
2
	Google 티셔츠를 교환하려고 한다고 하셨습니다. 이 정보가 맞나요?
예
	교환 이유를 알려주세요. 상품에 결함이 있거나 상품이 작동하지 않음, 사이즈 또는 핏 문제, 불완전한 주문 문제, 스타일 문제, 잘못된 색상이라고 말하거나 기타라고 말하면 됩니다.
사이즈 또는 핏 문제
	교환 이유를 알려주셔서 감사합니다. 교환하고 싶은 사이즈를 알려주시겠어요? 교환 가능한 사이즈는 다음과 같습니다. Small인 경우 1이라고 말하세요. Medium인 경우 2라고 말하세요. Large인 경우 3이라고 말하세요. XL인 경우 4라고 말하세요. XXL인 경우 5라고 말하세요.
1
	마지막 단계입니다. 제품을 어떻게 교환하고 싶으신가요? 매장에서 교환이나 회수 예약과 같이 말하면 됩니다.
회수 예약
	감사합니다. 등록된 전화번호와 이메일로 배송물 라벨을 보냈습니다. 이를 인쇄한 후 패키지에 부착하세요. Google팀에서 수거 일정을 예약하기 위해 24~48시간 이내에 연락을 드립니다. Google 창고에 상품이 도착한 후 교환 환불액이 계좌에 입금되기까지 영업일 기준 3~5일이 걸립니다. 교환 제품의 가격이 더 낮으며 5달러를 환불받을 수 있습니다. 환불을 받고자 하는 위치를 알려주세요. 스토어 크레딧 또는 원본 계정과 같이 말하면 됩니다.
스토어 크레딧
	월렛으로 환불받기를 원한다는 것을 확인해 주셔서 감사합니다. 다른 주문을 교환하시겠어요?
아니요
	전화해 주셔서 감사합니다.

요건 미충족 주문

최종 사용자가 이전에 인증되었습니다. 에이전트가 최신 주문을 확인하여 교환 가능한 제품이 없음을 확인합니다. 에이전트가 사용자로부터 주문 번호를 수집하고 제공된 주문에 적합한 제품이 없는지 확인합니다.

사용자 입력	에이전트 응답
	최근 주문에서 교환 가능한 제품을 찾을 수 없습니다. 다른 주문을 교환하시겠어요?
예
	교환하려는 주문 ID의 마지막 5자리를 알려주세요.
23487
	해당 주문 ID의 마지막 5자리가 23487입니다. 맞습니까?
예
	좋습니다. 주문 ID 수집이 완료되었습니다.
	죄송하지만 Google 정책에 따라 교환 요건을 충족하는 제품이 주문에 없습니다. 교환 정책에 관한 자세한 내용은 Google 웹사이트에서 확인할 수 있습니다. 다른 주문을 교환하시겠어요?
아니요
	전화해 주셔서 감사합니다.

이름 지정 규칙

이 사전 빌드 구성요소는 다음 이름 지정 규칙을 사용합니다.

기능	형식	예
흐름	[구성요소 이름]	주문 상태
항목 유형	prebuilt_components_[component_name]_[entity_type]	prebuilt_components_exchange_order_location
웹훅	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_exchange_order:get_product_exchange_availability

입력 매개변수

입력 매개변수는 구성요소의 특정 동작을 구성하는 데 사용되는 매개변수입니다. 매개변수는 흐름 내 하나 이상의 조건에서 구성요소 작동 방식을 결정하는 데 사용됩니다. 흐름 범위 매개변수는 구성요소의 시작 페이지에서 설정해야 합니다. 세션 범위 매개변수는 호출 흐름 또는 이 구성요소의 시작 페이지에서 설정할 수 있습니다.

이 사전 빌드 구성요소는 다음 입력 매개변수를 허용합니다.

매개변수 이름	설명	입력 형식
$session.params.phone_number	(선택사항) 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다.	문자열
$session.params.all_recent_order_id	(선택사항) 이 매개변수는 인증된 사용자와 연관된 주문 ID를 주문 배치 날짜 기준 내림차순으로 나열합니다. 배열의 첫 번째 요소는 가장 최근의 주문을 나타냅니다. 사용자에게 주문이 없는 경우 이 매개변수의 값은 `null`입니다.	목록(문자열)
$session.params.email	(선택사항) 계정에 등록된 이메일입니다.	문자열
$session.params.user_first_name	(선택사항) 사용자의 이름으로, 인사를 하고 계정 소유권을 확인하는 데 사용됩니다.	문자열

이 사전 빌드 구성요소를 사용하면 다음과 같은 선택적 매개변수를 사용하여 재시도를 포함한 구성요소 동작을 구성할 수 있습니다.

매개변수 이름	설명	형식
$flow.max_retry_another_account	대체 계정으로 계속할지 여부를 선택할 때 허용되는 재시도 횟수를 지정합니다. 기본값은 `3`입니다.	정수
$flow.max_retry_order_number	주문 번호의 마지막 5자리를 입력할 때 허용되는 재시도 횟수를 지정합니다. 기본값은 `3`입니다.	정수
$flow.max_retry_another_order	주문 ID를 찾을 수 없거나 주문을 반품할 수 없는 경우 교환할 다른 주문을 선택할 때 허용되는 재시도 횟수를 지정합니다. 기본값은 `2`입니다.	정수
$flow.max_retry_select_order_number	2개 이상의 주문이 마지막 5자리를 공유하는 경우 전체 주문 번호를 제공할 때 허용되는 재시도 횟수를 지정합니다. 기본값은 `2`입니다.	정수
$flow.max_retry_exchange_reason	교환 이유를 제공할 때 허용되는 재시도 횟수를 지정합니다. 기본값은 `3`입니다.	정수
$flow.max_retry_exchange_reason_counter	교환 이유를 확인할 때 허용되는 재시도 횟수를 지정합니다. 기본값은 `2`입니다.	정수
$flow.order_product_exchange_reason_others	사용자가 '기타' 교환 사유를 선택했음을 나타내는 `prebuilt_components_exchange_order_reason` 항목 값을 지정합니다. 기본값은 `"others"`입니다.	문자열
$flow.max_product_display_counter	한 번에 표시할 최대 제품 수를 지정합니다. 기본값은 `2`입니다.	정수
$flow.max_product_display	전체 대화에 표시할 최대 제품 수를 지정합니다. 기본값은 `9`입니다.	정수
$flow.max_product_exchange_confirm	선택한 제품을 확인할 때 허용되는 최대 재시도 횟수를 지정합니다. 기본값은 `2`입니다.	정수
$flow.max_retry_product_number_counter	교환할 제품을 선택할 때 허용되는 최대 재시도 횟수를 지정합니다. 기본값은 `3`입니다.	정수
$flow.max_retry_select_quantity	교환할 제품 수량을 선택할 때 허용되는 최대 재시도 횟수를 지정합니다. 기본값은 `2`입니다.	정수
$flow.max_retry_size_number_counter	교환할 사이즈를 선택할 때 허용되는 최대 재시도 횟수를 지정합니다. 기본값은 `2`입니다.	정수
$flow.max_retry_another_zip_code	우편번호를 제공할 때 허용되는 최대 재시도 횟수를 지정합니다. 기본값은 `2`입니다.	정수
$flow.max_store_display_counter	한 번에 표시할 최대 매장 수를 지정합니다. 기본값은 `1`입니다.	정수
$flow.max_store_display	전체 대화에 표시할 최대 매장 수를 지정합니다. 기본값은 `10`입니다.	정수
$flow.max_retry_store_number_counter	매장을 선택할 때 허용되는 최대 재시도 횟수를 지정합니다. 기본값은 `2`입니다.	정수
$flow.max_retry_store_selection	매장 선택을 확인할 때 허용되는 재시도 횟수를 지정합니다. 기본값은 `3`입니다.	정수
$flow.max_available_address_reselection_counter	사용자가 다른 매장 주소를 선택할지 확인할 때 허용되는 재시도 횟수를 지정합니다. 기본값은 `2`입니다.	정수
$flow.order_payment_mode_COD	상품 인도 결제(COD) 결제 수단을 나타내는 `get_order_details` 웹훅으로 반환된 `order_payment_mode` 필드 값을 지정합니다. 기본값은 `"COD"`입니다.	문자열
$flow.order_payment_mode_store_credit	스토어 크레딧 결제 수단을 나타내는 `get_order_details` 웹훅으로 반환된 `order_payment_mode` 필드 값을 지정합니다. 기본값은 `"store_credit"`입니다.	문자열
$flow.order_refund_mode_source_account	사용자가 원본 계정으로 환불하도록 선택했음을 나타내는 `prebuilt_components_exchange_order_refund_mode` 항목의 값을 지정합니다. 기본값은 `source_account`입니다.	문자열
$flow.order_exchange_location_scheduled_for_pickup	사용자가 교환 회수를 예약하도록 선택했음을 나타내는 `prebuilt_components_exchange_order_location` 항목의 값을 지정합니다. 기본값은 `scheduled_for_pickup`입니다.	문자열

이 구성요소의 입력 매개변수를 구성하려면 안내를 펼칩니다.

Dialogflow CX 콘솔을 엽니다.
Google Cloud 프로젝트를 선택합니다.
에이전트를 선택합니다.
빌드 탭을 선택합니다.
흐름 섹션에서 가져온 구성요소를 클릭합니다.
페이지 섹션에서 시작 페이지를 클릭합니다.
시작 페이지에서 true 경로를 클릭합니다.
경로 창에서 필요에 따라 매개변수 사전 설정 값을 수정합니다.
저장을 클릭합니다.

출력 매개변수

출력 매개변수는 구성요소를 종료한 후에도 활성 상태로 유지되는 세션 매개변수입니다. 이러한 매개변수에는 구성요소에 의해 수집된 중요한 정보가 포함됩니다. 이 사전 빌드 구성요소는 다음 출력 매개변수의 값을 제공합니다.

매개변수 이름	설명	출력 형식
phone_number	사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다.	문자열
all_recent_order_id	이 매개변수는 인증된 사용자와 연관된 주문 ID를 주문 배치 날짜 기준 내림차순으로 나열합니다. 배열의 첫 번째 요소는 가장 최근의 주문을 나타냅니다. 사용자에게 주문이 없는 경우 이 매개변수의 값은 `null`입니다.	목록(문자열)
이메일	계정에 등록된 이메일입니다.	문자열
user_first_name	사용자의 이름으로, 인사를 하고 계정 소유권을 확인하는 데 사용됩니다.	문자열
transfer_reason	이 매개변수는 성공하지 않은 경우 흐름이 종료된 이유를 나타냅니다. 반환된 값은 다음 중 하나입니다. `agent`: 최종 사용자가 대화 중 특정 시점에서 에이전트를 요청했습니다. `denial_of_information`: 최종 사용자가 구성 요소에서 요청한 정보 공유를 거부했습니다. `max_no_input`: 대화가 입력되지 않은 이벤트에 대한 최대 재시도 횟수에 도달했습니다. no-input 기본 제공 이벤트를 참조하세요. `max_no_match`: 대화가 일치하지 않는 이벤트의 최대 재시도 횟수에 도달했습니다. no-match 기본 제공 이벤트를 참조하세요. `webhook_error`: 웹훅 오류가 발생했습니다. webhook.error 기본 제공 이벤트를 참조하세요. `webhook_not_found`: 웹훅 URL에 연결할 수 없습니다. webhook.error.not-found 기본 제공 이벤트를 참조하세요.	문자열

생성기

이 구성요소는 생성기를 사용하여 대화의 특정 부분을 사용 설정합니다.

FAQ

FAQ 생성기는 다음과 같이 반품 및 교환과 관련하여 자주 묻는 질문(FAQ)을 처리하는 데 사용됩니다.

반품 절차에 기한이 있나요?
선물 상품을 교환할 수 있나요?
제품 가격과 환불 금액이 다릅니다. 그 이유는 무엇인가요?

요약

Summarization 생성기는 구성요소에서 처리한 대화를 설명하는 통화 후 요약을 생성하는 데 사용됩니다.

기본 설정

이 사전 빌드 구성요소를 설정하려면 다음 안내를 따르세요.

사전 빌드된 구성요소를 가져옵니다.
외부 서비스를 설명하는 구성으로 제공된 가변형 웹훅을 구성합니다. 웹훅 설정을 참조하세요.

웹훅 설정

이 구성요소를 사용하려면 포함된 유연한 웹훅을 구성하여 외부 서비스에서 필요한 정보를 검색해야 합니다.

인증

인증에 필요한 외부 서비스를 이전에 구성하지 않았으면 이 구성요소에 대해 사용자 인증을 사용 설정하기 위해 이를 구성해야 합니다. 자세한 내용은 소매 인증 웹훅 설정을 참조하세요.

주문 세부정보 확인

prebuilt_components_exchange_order:get_order_details 웹훅은 구성요소에서 지정된 주문의 주문 세부정보를 검색하는 데 사용됩니다.

API 요청 매개변수

다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.

매개변수 이름	설명	입력 형식
$flow.order_id	세부정보를 검색할 주문 ID입니다.	문자열

API 응답 매개변수

다음 매개변수는 구성요소에서 사용할 API 응답에서 가져옵니다.

매개변수 이름	설명	출력 형식
order_date	주문이 접수된 날짜입니다(`YYYY-MM-DD` 형식).	문자열
order_product_count	주문 내 고유 제품 수입니다.	정수
order_payment_mode	주문 시 사용된 결제 모드를 나타냅니다.	문자열
exchangeable_product_id	주문 내 교환 가능한 제품의 제품 ID 목록입니다.	목록(문자열)
exchangeable_product_name	주문 내 교환 가능한 제품의 제품 이름 목록입니다.	목록(문자열)
exchangeable_product_brand_name	주문 내 교환 가능한 제품의 브랜드 이름 목록입니다.	목록(문자열)
exchangeable_product_quantity	주문 내 교환 가능한 제품의 수량 목록입니다.	목록(문자열)
exchangeable_product_price	주문 내 교환 가능한 제품의 가격 목록입니다.	목록(문자열)

이 구성요소에 주문 세부정보 확인 웹훅을 구성하려면 안내를 펼칩니다.

Dialogflow CX 콘솔을 엽니다.
Google Cloud 프로젝트를 선택합니다.
에이전트를 선택합니다.
관리 탭을 선택합니다.
웹훅을 클릭합니다.
prebuilt_components_exchange_order:get_order_details 웹훅을 선택합니다.
대화형 에이전트(Dialogflow CX) 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
필요에 따라 인증 설정을 검토하고 업데이트합니다.
저장을 클릭합니다.

중복 주문 세부정보 확인

prebuilt_components_retail_services:get_duplicate_order_details 웹훅은 여러 주문 번호의 마지막 5자리가 동일한 경우 구성요소가 주문을 구별하기 위해 자세한 정보를 검색하는 데 사용됩니다.

API 요청 매개변수

다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.

매개변수 이름	설명	입력 형식
$flow.duplicate_order_id	사용자의 하나 이상의 주문 간에 공유되는 주문 번호의 마지막 5자리가 포함된 목록입니다.	목록(문자열)

API 응답 매개변수

다음 매개변수는 구성요소에서 사용할 API 응답에서 가져옵니다.

매개변수 이름	설명	출력 형식
all_order_date	마지막 5자리가 `YYYY-MM-DD` 형식으로 지정된 중복 주문의 주문 날짜 목록입니다. 이 배열의 각 요소는 `all_order_time` 배열의 동일한 요소에 해당합니다.	목록(문자열)
all_order_time	마지막 5자리가 `HH:MM` 형식으로 지정된 중복 주문의 주문 시간 목록입니다. 이 배열의 각 요소는 `all_order_date` 배열의 동일한 요소에 해당합니다.	목록(문자열)

이 구성요소에 중복 주문 세부정보 확인 웹훅을 구성하려면 안내를 펼칩니다.

Dialogflow CX 콘솔을 엽니다.
Google Cloud 프로젝트를 선택합니다.
에이전트를 선택합니다.
관리 탭을 선택합니다.
웹훅을 클릭합니다.
prebuilt_components_retail_services:get_duplicate_order_details 웹훅을 선택합니다.
대화형 에이전트(Dialogflow CX) 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
필요에 따라 인증 설정을 검토하고 업데이트합니다.
저장을 클릭합니다.

사용 가능한 교환 사이즈 확인

prebuilt_components_exchange_order:get_available_exchange_size 웹훅은 사이즈 또는 핏 문제로 인해 사용자가 상품을 교환하려는 경우 구성요소가 교환할 수 있는 사이즈를 검색하는 데 사용됩니다.

API 요청 매개변수

다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.

매개변수 이름	설명	입력 형식
$flow.selected_order_product_id	사용자가 교환하려는 제품의 제품 ID입니다.	문자열

API 응답 매개변수

다음 매개변수는 구성요소에서 사용할 API 응답에서 가져옵니다.

매개변수 이름	설명	출력 형식
product_available_sizes	선택한 제품에 사용할 수 있는 사이즈 목록입니다.	목록(문자열)

이 구성요소에 사용 가능한 교환 사이즈 확인 웹훅을 구성하려면 안내를 펼칩니다.

Dialogflow CX 콘솔을 엽니다.
Google Cloud 프로젝트를 선택합니다.
에이전트를 선택합니다.
관리 탭을 선택합니다.
웹훅을 클릭합니다.
prebuilt_components_exchange_order:get_available_exchange_size 웹훅을 선택합니다.
대화형 에이전트(Dialogflow CX) 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
필요에 따라 인증 설정을 검토하고 업데이트합니다.
저장을 클릭합니다.

제품 교환 가능 여부 확인

prebuilt_components_exchange_order:get_product_exchange_availability 웹훅은 구성요소에서 사용자가 선택한 제품, 수량, 선택적 사이즈를 교환할 수 있는지 확인하는 데 사용됩니다.

API 요청 매개변수

다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.

매개변수 이름	설명	입력 형식
$flow.order_id	세부정보를 검색할 주문 ID입니다.	문자열
$flow.selected_order_product_id	사용자가 교환하려는 제품의 제품 ID입니다.	문자열
$flow.order_product_quantity_exchange_count	사용자가 교환하려는 제품의 수량입니다.	정수
$flow.product_selected_size	사용자가 교환하려는 제품의 사이즈입니다.	문자열

API 응답 매개변수

다음 매개변수는 구성요소에서 사용할 API 응답에서 가져옵니다.

매개변수 이름	설명	출력 형식
product_exchange_availability	선택한 제품, 수량, 사이즈를 교환할 수 있는지 여부를 나타냅니다.	부울
product_exchange_price	선택한 제품 및 사이즈로 구성된 단일 상품의 교환 가격을 나타냅니다.	숫자

이 구성요소에 제품 교환 가능 여부 확인 웹훅을 구성하려면 안내를 펼칩니다.

Dialogflow CX 콘솔을 엽니다.
Google Cloud 프로젝트를 선택합니다.
에이전트를 선택합니다.
관리 탭을 선택합니다.
웹훅을 클릭합니다.
prebuilt_components_exchange_order:get_product_exchange_availability 웹훅을 선택합니다.
대화형 에이전트(Dialogflow CX) 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
필요에 따라 인증 설정을 검토하고 업데이트합니다.
저장을 클릭합니다.

미완료 주문 티켓 제출

prebuilt_components_exchange_order:raise_incomplete_order_ticket 웹훅은 주문이 불완전하여 사용자가 주문 내에서 제품을 교환하려고 할 때 구성요소가 티켓을 지출하는 데 사용됩니다.

API 요청 매개변수

다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.

매개변수 이름	설명	입력 형식
$session.params.phone_number	사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다.	문자열
$flow.order_id	티켓을 제출할 주문 ID입니다.	문자열
$flow.selected_order_product_id	사용자가 교환하려는 제품의 제품 ID입니다.	문자열
$flow.order_product_quantity_exchange_count	사용자가 교환하려는 제품의 수량입니다.	정수
$flow.order_product_exchange_reason	사용자가 제품을 교환하려는 이유입니다.	문자열

이 구성요소에 미완료 주문 티켓 제출 웹훅을 구성하려면 안내를 펼칩니다.

Dialogflow CX 콘솔을 엽니다.
Google Cloud 프로젝트를 선택합니다.
에이전트를 선택합니다.
관리 탭을 선택합니다.
웹훅을 클릭합니다.
prebuilt_components_exchange_order:raise_incomplete_order_ticket 웹훅을 선택합니다.
대화형 에이전트(Dialogflow CX) 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
필요에 따라 인증 설정을 검토하고 업데이트합니다.
저장을 클릭합니다.

매장 세부정보 확인

prebuilt_components_exchange_order:get_store_details 웹훅은 구성요소에서 사용자가 제공한 우편번호 근처의 매장 목록을 검색하는 데 사용됩니다.

API 요청 매개변수

다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.

매개변수 이름	설명	입력 형식
$flow.zip_code	주변 상점을 검색하기 위한 우편번호입니다.	문자열

API 응답 매개변수

다음 매개변수는 구성요소에서 사용할 API 응답에서 가져옵니다.

매개변수 이름	설명	출력 형식
store_id	매장 ID 목록입니다.	목록(문자열)
store_address	`store_id`의 각 요소에 해당하는 매장 주소의 목록입니다.	목록(문자열)

이 구성요소에 매장 세부정보 확인 웹훅을 구성하려면 안내를 펼칩니다.

Dialogflow CX 콘솔을 엽니다.
Google Cloud 프로젝트를 선택합니다.
에이전트를 선택합니다.
관리 탭을 선택합니다.
웹훅을 클릭합니다.
prebuilt_components_exchange_order:get_store_details 웹훅을 선택합니다.
대화형 에이전트(Dialogflow CX) 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
필요에 따라 인증 설정을 검토하고 업데이트합니다.
저장을 클릭합니다.

교환 세부정보 게시

prebuilt_components_exchange_order:post_exchange_details 웹훅은 구성요소가 교환을 제출하는 데 사용됩니다.

API 요청 매개변수

다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.

매개변수 이름	설명	입력 형식
$session.params.phone_number	사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다.	문자열
$flow.order_id	티켓을 제출할 주문 ID입니다.	문자열
$flow.selected_order_product_id	사용자가 교환하려는 제품의 제품 ID입니다.	문자열
$flow.order_product_quantity_exchange_count	사용자가 교환하려는 제품의 수량입니다.	정수
$flow.product_selected_size	사용자가 교환하려는 제품의 사이즈입니다.	문자열
$flow.order_product_exchange_reason	사용자가 제품을 교환하려는 이유입니다.	문자열
$flow.order_exchange_location	교환에 선택된 모드입니다. 유효한 값은 `prebuilt_components_exchange_order_location` 항목으로 정의됩니다.	문자열
$flow.order_exchange_store_id	사용자가 매장 교환을 위해 선택한 매장의 매장 ID입니다.	문자열
$flow.order_refund_mode	환불 결제 모드입니다(해당하는 경우). 유효한 값은 `prebuilt_components_exchange_order_refund_mode` 항목으로 정의됩니다. 환불이 필요하지 않은 경우 이 값은 `null`입니다.	문자열
$flow.total_refund_amount	교환 가능한 제품 가격이 새 제품보다 높은 경우 환불되는 금액입니다. 환불이 필요하지 않은 경우 이 값은 `null`입니다.	정수

API 응답 매개변수

다음 매개변수는 구성요소에서 사용할 API 응답에서 가져옵니다.

매개변수 이름	설명	출력 형식
order_exchange_ticket_id	제출된 교환의 티켓 ID입니다.	문자열

이 구성요소에 교환 세부정보 게시 웹훅을 구성하려면 안내를 펼칩니다.

Dialogflow CX 콘솔을 엽니다.
Google Cloud 프로젝트를 선택합니다.
에이전트를 선택합니다.
관리 탭을 선택합니다.
웹훅을 클릭합니다.
prebuilt_components_exchange_order:post_exchange_details 웹훅을 선택합니다.
대화형 에이전트(Dialogflow CX) 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
필요에 따라 인증 설정을 검토하고 업데이트합니다.
저장을 클릭합니다.

COD 환불 정보 전송

prebuilt_components_exchange_order:send_COD_refund_information 웹훅은 구성요소에서 사용자에게 교환 관련 결제 정보를 전송하는 데 사용됩니다.

API 요청 매개변수

다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.

매개변수 이름	설명	입력 형식
$session.params.phone_number	사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다.	문자열
$flow.order_id	티켓을 제출할 주문 ID입니다.	문자열
$flow.channel	정보를 전송할 특정 채널입니다. 유효한 값은 `prebuilt_components_channel_email_phone` 항목으로 정의됩니다. 기본적으로 `phone` 및 `email`이 지원됩니다.	문자열

이 구성요소에 COD 환불 정보 전송 웹훅을 구성하려면 안내를 펼칩니다.

Dialogflow CX 콘솔을 엽니다.
Google Cloud 프로젝트를 선택합니다.
에이전트를 선택합니다.
관리 탭을 선택합니다.
웹훅을 클릭합니다.
prebuilt_components_exchange_order:send_COD_refund_information 웹훅을 선택합니다.
대화형 에이전트(Dialogflow CX) 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
필요에 따라 인증 설정을 검토하고 업데이트합니다.
저장을 클릭합니다.

완료

이제 에이전트 및 웹훅이 설정되어 테스트할 수 있습니다.

이의 제기

의견