혜택 및 특가 사전 빌드 구성요소는 발신자가 등록된 사용자인지 확인합니다. 사용자에게 등록된 계정이 있으면 구성요소는 사용자별 혜택 및 특가에 대한 정보를 제공할 수 있습니다. 또한 사용자는 일반 혜택 및 특가에 관한 세부정보를 확인하거나 특정 쿠폰 코드와 관련된 문제를 보고할 수 있습니다. 이 구성요소는 영숫자 수집 사전 빌드 구성요소를 사용하여 쿠폰 코드를 수집합니다. 이 구성요소는 또한 통화 후 요약, FAQ, 혜택 세부정보를 위해 생성기를 사용합니다.
제한사항
사전 빌드 구성요소에는 일반적인 사전 빌드 구성요소 제한사항 외에도 다음과 같은 제한사항이 있습니다.
- 이 구성요소는 데이터를 암호화하지 않습니다.
샘플 대화상자
다음 샘플 대화상자에서는 사전 빌드된 구성요소에서 처리하는 일반적인 시나리오를 보여줍니다. 샘플 대화상자는 전화를 사용하여 구성요소가 호출될 때 기본 시작 인텐트와 대화 시작 시 첫 번째 에이전트 응답을 트리거하는 동작을 보여줍니다.
사용자별 및 일반 혜택과 특가
최종 사용자가 이전에 인증되었습니다. 사용자가 최신 혜택을 요청하고 에이전트는 사용자와 관련된 혜택 목록을 제공합니다. 사용자가 혜택에 대해 몇 가지 질문을 한 다음 특정 카테고리의 혜택을 요청합니다. 에이전트에서 카테고리의 혜택 목록을 제공합니다. 에이전트가 사용자에게 혜택 세부정보 전송을 제안하지만 사용자가 거부합니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 환영합니다. 최신 혜택을 살펴보고 싶거나 특정 쿠폰 코드와 관련된 문제를 겪고 계신가요? | |
| 최신 혜택을 확인하고 싶습니다. | |
| 혜택을 찾고 있다고 하셨습니다. 맞나요? | |
| 예 | |
| 귀하가 찾고 계신 혜택은 다음과 같습니다. 혜택 1: 의류 구매 시 5% 할인, 코드 APPARELS5 사용(2024년 3월 28일까지 유효) 혜택 2: 식료품 구매 시 15% 할인, 코드 GROCERY500 사용(2024년 3월 28일까지 유효) 이 혜택이 유용하셨기를 바랍니다. Google에서 안내해 드릴 수 있는 혜택이나 특가에 대해 궁금한 점이 있으신가요? |
|
| 식료품 혜택에 최소 구매 요건이 있나요? | |
| 예. 식료품 구매 시 15% 할인을 받으려면 최소 구매 금액이 10 이상이어야 합니다. 이 혜택을 받으려면 2024년 3월 28일까지 유효한 코드 GROCERY500을 사용하세요. 필요한 세부정보를 제공해 드렸기를 바랍니다. Google에서 안내해 드릴 수 있는 혜택이나 특가에 대해 궁금한 점이 있으신가요? |
|
| 전자제품 구매 시 혜택이 있나요? | |
| 물론이죠. 혜택 세부정보는 다음과 같습니다. 혜택 1: 전자제품 구매 시 5% 할인, 코드 ELECTRIC5 사용(2024년 3월 28일까지 유효) 혜택 2: 전자제품 구매 시 15% 할인, 코드 ELECTRIC15 사용(2024년 3월 28일까지 유효) 필요한 세부정보를 제공해 드렸기를 바랍니다. Google에서 안내해 드릴 수 있는 혜택이나 특가에 대해 궁금한 점이 있으신가요? |
|
| 아니요. 괜찮습니다. | |
| 등록된 휴대전화 또는 이메일로 쿠폰 세부정보를 공유받으시겠어요? | |
| 나중에 | |
| 전화해 주셔서 감사합니다. |
쿠폰 코드 관련 문제
최종 사용자가 이전에 인증되었습니다. 사용자가 쿠폰 코드에 문제가 있다고 말합니다. 에이전트가 쿠폰 코드를 수집하고 사용자에게 쿠폰 코드 사용에 대한 세부정보를 제공합니다. 사용자가 쿠폰 코드에 문제가 있음을 확인하고 에이전트가 문제를 보고하기 위해 티켓을 제출합니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 환영합니다. 최신 혜택을 살펴보고 싶거나 특정 쿠폰 코드와 관련된 문제를 겪고 계신가요? | |
| 쿠폰 코드에 문제가 있습니다. | |
| 쿠폰 코드를 찾고 있다고 하셨습니다. 맞나요? | |
| 예 | |
| 원하는 결과를 보지 못하셨다니 아쉽습니다. 사용 중인 쿠폰 코드를 알려주시겠어요? | |
| 에이전트가 영숫자 수집 사전 빌드 구성요소를 사용하여 쿠폰 코드를 수집합니다. | |
| 의류와 관련된 혜택 코드 APPARELS5는 2024년 3월 28일까지 유효하며 구매 금액이 100달러 이상이어야 사용 가능합니다. 최소 구매 요건과 같은 조건을 충족하는지 확인하세요. 이 정보가 도움이 되었나요? |
|
| 아니요 | |
| 발생한 문제를 구체적으로 설명해 주세요. 쿠폰 코드가 작동하지 않거나, 해당 지역에서 코드가 작동하지 않는다고 하셨습니다. | |
| 쿠폰 코드가 작동하지 않음 | |
| 쿠폰 코드가 작동하지 않는 문제가 있다고 하셨습니다. 이 정보가 맞나요? | |
| 예 | |
| 문제를 신고하기 위해 티켓을 제출했습니다. 전화해 주셔서 감사합니다. |
이름 지정 규칙
이 사전 빌드 구성요소는 다음 이름 지정 규칙을 사용합니다.
| 기능 | 형식 | 예 |
|---|---|---|
| 흐름 | [구성요소 이름] | 혜택 및 특가 |
| 항목 유형 | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_offers_and_deals_category |
| 웹훅 | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_offers_and_deals:get_offers_details |
입력 매개변수
입력 매개변수는 구성요소의 특정 동작을 구성하는 데 사용되는 매개변수입니다. 매개변수는 흐름 내 하나 이상의 조건에서 구성요소 작동 방식을 결정하는 데 사용됩니다. 흐름 범위 매개변수는 구성요소의 시작 페이지에서 설정해야 합니다. 세션 범위 매개변수는 호출 흐름 또는 이 구성요소의 시작 페이지에서 설정할 수 있습니다.
이 사전 빌드 구성요소는 다음 입력 매개변수를 허용합니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| $session.params.phone_number | (선택사항) 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. | 문자열 |
이 사전 빌드 구성요소를 사용하면 다음과 같은 선택적 매개변수를 사용하여 재시도를 포함한 구성요소 동작을 구성할 수 있습니다.
| 매개변수 이름 | 설명 | 형식 |
|---|---|---|
| $flow.max_retry_concern_type | 사용자가 혜택을 들을 것인지 또는 쿠폰 코드 관련 문제를 신고할 것인지 선택할 때 허용되는 재시도 횟수를 지정합니다. 기본값은 2입니다. |
정수 |
| $flow.max_retry_offers_category | 혜택을 들을 카테고리를 입력할 때 허용되는 재시도 횟수를 지정합니다. 기본값은 2입니다. |
정수 |
| $flow.max_retry_another_coupon_code | 문제가 발생한 특정 쿠폰 코드를 입력할 때 허용되는 재시도 횟수를 지정합니다. 기본값은 2입니다. |
정수 |
| $flow.max_retry_coupon_code_issue_counter | 쿠폰 코드에 발생한 문제를 입력할 때 허용되는 재시도 횟수를 지정합니다. 기본값은 2입니다. |
정수 |
| $flow.max_retry_message_confirm_channel | 혜택 세부정보를 수신할 채널을 입력할 때 허용되는 재시도 횟수를 지정합니다. 기본값은 2입니다. |
정수 |
| $flow.valid_coupon_code_status | 쿠폰 코드가 유효함을 나타내는 get_coupon_code_details 웹훅으로 반환된 coupon_code_status 필드 값을 지정합니다. 기본값은 "valid"입니다. |
문자열 |
| $flow.invalid_coupon_code_status | 쿠폰 코드가 유효하지 않음을 나타내는 get_coupon_code_details 웹훅으로 반환된 coupon_code_status 필드 값을 지정합니다. 기본값은 "invalid"입니다. |
문자열 |
| $flow.expired_coupon_code_status | 쿠폰 코드가 만료되었음을 나타내는 get_coupon_code_details 웹훅으로 반환된 coupon_code_status 필드 값을 지정합니다. 기본값은 "expired"입니다. |
문자열 |
이 구성요소의 입력 매개변수를 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 빌드 탭을 선택합니다.
- 흐름 섹션에서 가져온 구성요소를 클릭합니다.
- 페이지 섹션에서 시작 페이지를 클릭합니다.
- 시작 페이지에서 true 경로를 클릭합니다.
- 경로 창에서 필요에 따라 매개변수 사전 설정 값을 수정합니다.
- 저장을 클릭합니다.
출력 매개변수
출력 매개변수는 구성요소를 종료한 후에도 활성 상태로 유지되는 세션 매개변수입니다. 이러한 매개변수에는 구성요소에 의해 수집된 중요한 정보가 포함됩니다. 이 사전 빌드 구성요소는 다음 출력 매개변수의 값을 제공합니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| phone_number | 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. | 문자열 |
| 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 기본 제공 이벤트를 참조하세요. |
문자열 |
생성기
이 구성요소는 생성기를 사용하여 대화의 특정 부분을 사용 설정합니다.
요약
Summarization 생성기는 구성요소에서 처리한 대화를 설명하는 통화 후 요약을 생성하는 데 사용됩니다.
일반 FAQ
General FAQ 생성기는 할인, 판매, 구매, 포인트 제도와 관련하여 자주 묻는 질문(FAQ)을 처리하는 데 사용됩니다.
- 마음이 바뀌면 할인 제품을 반품할 수 있나요?
- 특정 제품을 구매할 때 무료 샘플이나 선물을 받을 수 있나요?
- 구매한 상품이 나중에 세일하게 되면 가격이 조정되나요?
- 포인트 프로그램 리워드 사용 시간 제한이 있나요?
사용자별 혜택 세부정보
User-specific offer details 생성기는 get_offers_details 웹훅에서 제공하는 정보를 기반으로 사용자별 혜택에 대한 세부정보를 제공하는 데 사용됩니다.
혜택 및 특가 세부정보
Offers and deals details 생성기는 get_offers_details 웹훅에서 제공하는 정보를 기반으로 일반 혜택 및 거래에 대한 세부정보를 제공하는 데 사용됩니다.
사용자는 특정 카테고리의 혜택에 대해 질문하거나 특정 혜택에 대한 자세한 내용을 요청할 수 있습니다.
혜택 및 특가 FAQ
Offers and deals FAQ 생성기는 혜택 및 특가와 관련하여 자주 묻는 질문(FAQ)을 처리하는 데 사용됩니다.
- 신규 고객을 위한 특별 이벤트가 있나요?
- 향후 특가에 대한 알림을 받으려면 어떻게 해야 하나요?
- 매장 또는 온라인에서만 제공되는 혜택이 있나요?
- 플랫폼에 새로운 특가가 얼마나 자주 추가되나요?
할인 및 프로모션 코드 FAQ
Discount and promo code FAQ는 할인 및 프로모션 코드와 관련하여 자주 묻는 질문(FAQ)을 처리하는 데 사용됩니다.
- 할인 코드를 두 번 이상 사용할 수 있나요?
- 단일 주문에 여러 할인을 사용할 수 있나요?
- 결제 중에 할인 코드를 사용하려면 어떻게 해야 하나요?
- 결제 시 할인 코드를 적용하는 것을 잊으면 어떻게 되나요?
기본 설정
이 사전 빌드 구성요소를 설정하려면 다음 안내를 따르세요.
- 사전 빌드된 구성요소를 가져옵니다.
- 외부 서비스를 설명하는 구성으로 제공된 가변형 웹훅을 구성합니다. 웹훅 설정을 참조하세요.
웹훅 설정
이 구성요소를 사용하려면 포함된 유연한 웹훅을 구성하여 외부 서비스에서 필요한 정보를 검색해야 합니다.
혜택 세부정보 확인
prebuilt_components_offers_and_deals:get_offers_details 웹훅은 구성요소가 사용자별 및 일반 혜택에 대한 세부정보를 검색하는 데 사용됩니다.
API 요청 매개변수
다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| $session.params.phone_number | 혜택 세부정보를 검색할 전화번호입니다. | 문자열 |
API 응답 매개변수
다음 매개변수는 구성요소에서 사용할 API 응답에서 가져옵니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| active_category | 사용자가 사용할 수 있는 혜택 카테고리 목록입니다. 유효한 값은 prebuilt_components_offers_and_deals_category 항목으로 정의됩니다. |
목록(문자열) |
| user_email | 제공된 계정에 등록된 이메일로, 쿠폰 세부정보를 전송하는 데 사용됩니다. | 문자열 |
| user_offer | 사용자별 쿠폰 세부정보 목록입니다. 목록의 각 요소는 단일 혜택을 나타내며, 키-값 쌍은 혜택의 다양한 속성을 설명합니다(예: {"valid_from": "2024-01-29", "sale_type": "none", "valid_until": "2024-03-28", "offer_id": "G5E0M2D7A6Y4W9S", "discount_value": "5%", "coupon_code": "ELECTRIC5", "is_redeem_allowed": "true", "minimum_order_value": "1000", "maximum_discount_amount": "200", "offer_category_name": "electronics"}). |
목록(객체) |
| all_offers | 일반 혜택 세부정보 목록입니다. 목록의 각 요소는 user_offer 필드와 동일한 형식을 따르는 단일 혜택을 나타냅니다. |
목록(객체) |
이 구성요소에 대해 혜택 세부정보 확인 웹훅을 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 관리 탭을 선택합니다.
- 웹훅을 클릭합니다.
- prebuilt_components_offers_and_deals:get_offers_details 웹훅을 선택합니다.
- 대화형 에이전트(Dialogflow CX) 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
- 요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
- 응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
- 필요에 따라 인증 설정을 검토하고 업데이트합니다.
- 저장을 클릭합니다.
쿠폰 코드 세부정보 확인
prebuilt_components_offers_and_deals:get_coupon_code_details 웹훅은 구성요소에서 사용자가 문제를 보고한 특정 쿠폰 코드에 대한 세부정보를 검색하는 데 사용됩니다.
API 요청 매개변수
다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| $flow.coupon_code | 세부정보를 검색할 쿠폰 코드입니다. | 문자열 |
| $session.params.phone_number | 사용자 계정에 연결된 전화번호입니다. | 문자열 |
API 응답 매개변수
다음 매개변수는 구성요소에서 사용할 API 응답에서 가져옵니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| offer_id | 쿠폰 코드의 혜택 ID입니다. | 문자열 |
| offer_category_name | 쿠폰 코드의 카테고리입니다. 유효한 값은 prebuilt_components_offers_and_deals_category 항목으로 정의됩니다. |
문자열 |
| coupon_code_status | 쿠폰 코드의 상태입니다. 유효한 값은 $flow.valid_coupon_code_status, $flow.invalid_coupon_code_status, $flow.valid_coupon_code_status 입력 매개변수로 정의됩니다. |
문자열 |
| valid_until | 쿠폰 코드의 기한입니다(YYYY-MM-DD 형식). |
문자열 |
| minimum_order_value | 쿠폰 코드의 최소 주문 금액입니다. | 문자열 |
이 구성요소에 쿠폰 코드 세부정보 확인 웹훅을 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 관리 탭을 선택합니다.
- 웹훅을 클릭합니다.
- prebuilt_components_offers_and_deals:get_coupon_code_details 웹훅을 선택합니다.
- 대화형 에이전트(Dialogflow CX) 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
- 요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
- 응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
- 필요에 따라 인증 설정을 검토하고 업데이트합니다.
- 저장을 클릭합니다.
메시지 보내기
prebuilt_components_offers_and_deals:send_message 웹훅은 구성요소에서 혜택 세부정보가 포함된 메시지를 사용자가 선택한 채널에 전송하는 데 사용됩니다.
API 요청 매개변수
다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| $session.params.phone_number | 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. | 문자열 |
| $flow.confirmation_channel | 사용자가 혜택 세부정보를 수신하도록 선택한 채널입니다. 유효한 값은 prebuilt_components_channel_email_phone 항목으로 정의됩니다. |
문자열 |
이 구성요소에 메시지 전송 웹훅을 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 관리 탭을 선택합니다.
- 웹훅을 클릭합니다.
- prebuilt_components_offers_and_deals:send_message 웹훅을 선택합니다.
- 대화형 에이전트(Dialogflow CX) 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
- 요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
- 응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
- 필요에 따라 인증 설정을 검토하고 업데이트합니다.
- 저장을 클릭합니다.
티켓 제출
prebuilt_components_offers_and_deals:raise_ticket 웹훅은 구성요소가 쿠폰 코드와 관련된 사용자 문제를 보고하는 티켓을 제출하는 데 사용됩니다.
API 요청 매개변수
다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| $session.params.phone_number | 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. | 문자열 |
| $flow.coupon_code | 사용자가 문제를 신고한 쿠폰 코드입니다. | 문자열 |
| $flow.offer_id | 제공된 쿠폰 코드의 혜택 ID입니다. | 문자열 |
| $flow.coupon_code_issue | 사용자가 제공한 쿠폰 코드 관련 문제입니다. | 문자열 |
이 구성요소에 티켓 제출 웹훅을 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 관리 탭을 선택합니다.
- 웹훅을 클릭합니다.
- rebuilt_components_offers_and_deals:raise_ticket 웹훅을 선택합니다.
- 대화형 에이전트(Dialogflow CX) 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
- 요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
- 응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
- 필요에 따라 인증 설정을 검토하고 업데이트합니다.
- 저장을 클릭합니다.
완료
이제 에이전트 및 웹훅이 설정되어 테스트할 수 있습니다.