분실 및 도난 카드 사전 빌드된 구성요소는 사용자 인증, 사용자에게 등록된 카드 검색, 사용자의 카드 잠금 기능을 수행합니다. 카드 잠금을 확인한 후에는 이 구성요소를 통해 사용자가 업그레이드 또는 신규 카드 발급을 등록할 수 있습니다. 이 구성요소는 인증 사전 빌드된 구성요소의 맞춤설정된 버전을 사용해서 카드 소유자를 인증할 수 있습니다.
제한사항
사전 빌드 구성요소에는 일반적인 사전 빌드 구성요소 제한사항 외에도 다음과 같은 제한사항이 있습니다.
- 이 구성요소는 데이터를 암호화하지 않습니다.
샘플 대화상자
다음 샘플 대화상자에서는 사전 빌드된 구성요소에서 처리하는 일반적인 시나리오를 보여줍니다. 샘플 대화상자는 전화를 통해 구성요소가 호출될 때 기본 시작 인텐트와 대화 시작 시 첫 번째 에이전트 응답을 트리거하는 동작을 보여줍니다.
단일 카드가 있는 인증되지 않은 사용자
에이전트는 사용자가 이전에 인증되지 않았음을 식별하고 사용자가 등록된 카드 소지자인지 확인하기 위한 정보를 수집합니다. 사용자가 인증되었으면 에이전트가 사용자에게 등록된 단일 카드에 대한 정보를 검색합니다. 사용자가 카드 잠금 여부를 확인하면 에이전트가 카드 잠금을 수행합니다. 마지막으로 에이전트가 사용자의 선호 카드 및 배송지 주소를 확인하고 사용자에게 신규 카드를 재발급합니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 에이전트가 사전 빌드된 인증 구성요소를 사용하여 사용자 인증을 수행합니다. | |
| 감사합니다. 인증이 성공적으로 완료되었습니다. | |
| 카드 세부정보를 가져오는 동안 잠시 기다려 주세요. 귀하의 MasterCard 끝 번호가 4444로 확인되었습니다. 카드를 영구적으로 잠그시겠어요? |
|
| 예 | |
| 카드를 잠그는 이유를 알려주세요. 손상, 도난, 분실 등의 옵션 중에서 선택할 수 있습니다. | |
| 카드를 분실했습니다. | |
| 이유를 알려주셔서 고맙습니다. 영구 카드 잠금 절차를 진행할 수 있도록 도와드리겠습니다. 카드 끝 번호가 4444가 맞나요? | |
| 예 | |
| 좋습니다. 계속하기 전에 등록된 휴대전화 번호로 코드를 보내드리겠습니다. 요청을 확인할 수 있도록 코드를 알려주시기 바랍니다. | |
| 123457 | |
| 좋습니다. 4444로 끝나는 귀하의 카드가 영구적으로 잠깁니다. 잠긴 후에는 해당 카드로 온라인 또는 단말기 거래 결제가 불가능합니다. 계속하길 원하시나요? | |
| 예 | |
| 귀하의 카드가 성공적으로 잠겼습니다. 요청 번호는 9761431이고 등록된 휴대전화 번호로도 번호가 성공적으로 전송되었습니다. 새 카드를 재발급하시겠어요? | |
| 예 | |
| 고객님께는 플래티넘 카드 이용 자격이 있습니다. 연간 수수료는 97달러이고 494달러에 상응하는 연간 보너스 및 특별 혜택을 얻을 수 있습니다. 자세히 알아보려면 등록된 휴대전화 번호로 전송된 링크를 클릭하시기 바랍니다. 이 카드를 등록하시겠어요? |
|
| 예 | |
| 등록된 주소로 카드가 발송됩니다. 배송 주소의 우편 번호가 12345인지 확인해주세요. | |
| 예 | |
| 좋습니다. 신규 카드 재발급 요청을 등록하는 동안 잠시만 기다려 주세요. 신규 카드 재발급 요청이 성공적으로 처리되었습니다. 요청 번호는 4643943이고 등록된 휴대전화 번호로도 번호가 성공적으로 전송되었습니다. 카드는 영업일 기준 3일 내에 등록된 주소로 발송될 예정입니다. 카드를 사용하려면 카드에 동봉된 안내를 따라주세요. |
여러 카드가 있는 인증된 사용자
에이전트가 이전에 인증된 사용자를 식별하고 이 사용자에게 등록된 카드 정보를 검색합니다. 사용자가 이전에 잠긴 카드를 선택하여, 에이전트가 사용자의 신규 카드 요청을 처리할 수 있습니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 카드 세부정보를 가져오는 동안 잠시 기다려 주세요. 귀하의 번호로 여러 카드가 등록된 것으로 확인되었습니다. 끝 번호가 1456인 Visa, 1457인 MasterCard, 1345인 MasterCard, 3456인 Visa가 있습니다. 잠그려는 카드의 마지막 네 자리 숫자를 알려주세요. |
|
| 1457 | |
| 잠그려는 카드 번호의 마지막 네 자리 숫자가 1457입니다. 올바른가요? | |
| 예 | |
| 요청한 카드는 이미 영구 잠금 상태입니다. 새 카드를 재발급하시겠어요? | |
| 예 | |
| 등록된 주소로 카드가 발송됩니다. 배송 주소의 우편 번호가 12345인지 확인해주세요. | |
| 예 | |
| 좋습니다. 신규 카드 재발급 요청을 등록하는 동안 잠시만 기다려 주세요. 신규 카드 재발급 요청이 성공적으로 처리되었습니다. 요청 번호는 5423270이고 등록된 휴대전화 번호로도 번호가 성공적으로 전송되었습니다. 카드는 영업일 기준 3일 내에 등록된 주소로 발송될 예정입니다. 카드를 사용하려면 카드에 동봉된 안내를 따라주세요. 다른 잠글 카드가 있으신가요? |
|
| 없습니다. | |
| 알겠습니다. 연락해 주셔서 감사합니다. |
이름 지정 규칙
이 사전 빌드 구성요소는 다음 이름 지정 규칙을 사용합니다.
| 기능 | 형식 | 예 |
|---|---|---|
| 흐름 | [구성요소 이름] | 분실 및 도난 카드 |
| 항목 유형 | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_lost_and_stolen_lock_reason |
| 웹훅 | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_lost_and_stolen_card:lock_card_ticket_number |
입력 매개변수
입력 매개변수는 구성요소의 특정 동작을 구성하는 데 사용되는 매개변수입니다. 매개변수는 흐름 내 하나 이상의 조건에서 구성요소 작동 방식을 결정하는 데 사용됩니다. 흐름 범위 매개변수는 아래 설명된 대로 구성요소의 시작 페이지에서 설정해야 합니다. 세션 범위 매개변수는 호출 흐름 또는 이 구성요소의 시작 페이지에서 설정할 수 있습니다.
이 사전 빌드 구성요소는 다음 입력 매개변수를 허용합니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| $session.params.auth_level | (선택사항) 호출자의 인증 레벨을 나타냅니다. | 정수 |
| $session.params.auth_level_req | 사용자가 자신의 거래 기록에 액세스하기 전에 필요한 인증 레벨을 나타냅니다. 이 값은 check auth level 페이지에서 페이지 진입 충족 요건의 매개변수 사전 설정에 구성되어 있습니다. 기본적으로 이 값은 1입니다. |
정수 |
| $session.params.account_auth_enabled | 인증 유형에 설명된 대로 사용자를 계좌 소유자로 인증해야 하는지 여부를 나타냅니다. 이 값은 check auth level 페이지에서 페이지 진입 충족 요건의 매개변수 사전 설정에 구성되어 있습니다. 기본적으로 이 값은 false입니다. |
부울 |
| $session.params.card_auth_enabled | 인증 유형에 설명된 대로 사용자를 카드 소지자로 인증해야 하는지 여부를 나타냅니다. 이 값은 check auth level 페이지에서 페이지 진입 충족 요건의 매개변수 사전 설정에 구성되어 있습니다. 기본적으로 이 값은 true입니다. |
부울 |
| $session.params.phone_number | (선택사항) 인증에 사용된 고객의 등록된 전화번호입니다. | 문자열 |
| $session.params.card_count | (선택사항) 인증된 사용자와 연결된 신용카드 개수입니다. | 정수 |
| $flow.card_status_active | 선택한 카드가 현재 활성 상태임을 나타내는 카드 검증 웹훅으로 반환된 매개변수 값을 지정합니다. 기본값은 "active"입니다. |
문자열 |
| $flow.card_status_lock_temp | 선택한 카드가 일시적으로 잠겼음을 나타내는 카드 검증 웹훅으로 반환된 매개변수 값을 지정합니다. 기본값은 "inactive"입니다. |
문자열 |
| $flow.card_status_lock_permanent | 선택한 카드가 영구적으로 잠겼음을 나타내는 카드 검증 웹훅으로 반환된 매개변수 값을 지정합니다. 기본값은 "blocked"입니다. |
문자열 |
| $flow.max_retry_card_number | 신용카드의 마지막 네 자리 숫자를 수집할 때 허용되는 재시도 횟수를 지정합니다. 기본값은 3입니다. |
정수 |
| $flow.max_otp_retry_count | 사용자에게 일회용 비밀번호(OTP)를 수집할 때 허용되는 재시도 횟수를 지정합니다. 기본값은 3입니다. |
정수 |
이 구성요소의 입력 매개변수를 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 빌드 탭을 선택합니다.
- 흐름 섹션에서 가져온 구성요소를 클릭합니다.
- 페이지 섹션에서 시작 페이지를 클릭합니다.
- 시작 페이지에서 true 경로를 클릭합니다.
- 경로 창에서 필요에 따라 매개변수 사전 설정 값을 수정합니다.
- 저장을 클릭합니다.
출력 매개변수
출력 매개변수는 구성요소를 종료한 후에도 활성 상태로 유지되는 세션 매개변수입니다. 이러한 매개변수에는 구성요소에 의해 수집된 중요한 정보가 포함됩니다. 이 사전 빌드 구성요소는 다음 출력 매개변수의 값을 제공합니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| auth_level | 호출자의 인증 레벨을 나타냅니다. | 정수 |
| phone_number | 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. | 문자열 |
| card_count | 등록된 전화번호와 연결된 카드 수입니다. | 정수 |
| last_four_digit_of_card_number | 사용자에게 카드가 하나만 있으면 카드 번호의 마지막 네 자리 숫자가 반환됩니다. 사용자에게 카드가 2개 이상 있는 경우 이 매개변수의 값은 잠그거나 신규 카드를 재발급하도록 사용자가 선택한 카드의 마지막 네 자리 숫자입니다. | 문자열 |
| 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 기본 제공 이벤트를 참조하세요. |
문자열 |
기본 설정
이 사전 빌드 구성요소를 설정하려면 다음 안내를 따르세요.
- 사전 빌드된 구성요소를 가져옵니다.
- 외부 서비스를 설명하는 구성으로 제공된 가변형 웹훅을 구성합니다. 아래 웹훅 설정을 참조하세요.
웹훅 설정
이 구성요소를 사용하려면 포함된 유연한 웹훅을 구성하여 외부 서비스에서 필요한 정보를 검색해야 합니다.
인증
인증에 필요한 외부 서비스를 이전에 구성하지 않았으면 이 구성요소에 대해 사용자 인증을 사용 설정하기 위해 이를 구성해야 합니다. 자세한 내용은 인증 웹훅 설정을 참조하세요.
카드 세부정보 가져오기
prebuilt_components_account_services:get_card_details 웹훅은 구성요소가 사용자에게 등록된 카드 정보를 가져오기 위해 사용됩니다.
API 요청 매개변수
다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| $session.params.phone_number | 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. | 문자열 |
API 응답 매개변수
다음 매개변수는 구성요소에서 사용할 API 응답에서 가져옵니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| last_four_digit_of_all_cards | 사용자에게 등록된 각 카드의 마지막 네 자리 숫자가 포함된 목록입니다. 예: ["0000", "1111", "2222"]. 이 목록의 각 요소는 card_vendor_all에 있는 동일한 색인의 요소와 동일한 카드를 나타냅니다. |
목록(문자열) |
| card_vendor_all | 사용자에게 등록된 각 카드의 신용카드 업체가 포함된 목록입니다. 예: ["Visa", "Mastercard", "Discover"]. 이 목록의 각 요소는 last_four_digit_of_all_cards에 있는 동일한 색인의 요소와 동일한 카드를 나타냅니다. |
목록(문자열) |
| card_count | 인증된 사용자와 연결된 카드 수입니다. | 정수 |
이 구성요소에 대해 카드 세부정보 가져오기 웹훅을 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 관리 탭을 선택합니다.
- 웹훅을 클릭합니다.
- prebuilt_components_account_services:get_card_details 웹훅을 선택합니다
- 대화형 에이전트(Dialogflow CX) 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
- 요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
- 응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
- 필요에 따라 인증 설정을 검토하고 업데이트합니다.
- 저장을 클릭합니다.
카드 검증
prebuilt_components_lost_and_stolen_card:validate_card 웹훅은 구성요소가 사용자 계정에 등록된 특정 카드에 대한 정보를 가져오기 위해 사용됩니다.
API 요청 매개변수
다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| $session.params.phone_number | 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. | 문자열 |
| $session.params.last_four_digit_of_card_number | 사용자가 잠금을 요청한 카드 번호의 마지막 네 자리 숫자입니다. | 문자열 |
API 응답 매개변수
다음 매개변수는 구성요소에서 사용할 API 응답에서 가져옵니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| zip_code | 사용자 계정에 등록된 우편 번호입니다. | 문자열 |
| card_vendor | 선택한 카드의 신용카드 업체입니다. | 문자열 |
| card_status | 카드의 현재 상태를 나타냅니다. 기본적으로 유효한 값은 활성, 일시 차단 또는 영구 잠금입니다. 이러한 상태는 $flow.card_status_active, $flow.card_status_lock_temp, $flow.card_status_lock_permanent 매개변수로 지정됩니다. 입력 매개변수를 참조하세요. |
문자열 |
| card_upgrade | 선택한 카드에 업그레이드를 사용할 수 있는지 여부를 나타냅니다. | 부울 |
| card_upgrade_type | 사용 가능한 카드 업그레이드 유형을 지정합니다. 예: "gold" 또는 "platinum". card_upgrade가 false이면 이 매개변수가 필요하지 않습니다. |
문자열 |
| card_upgrade_annual_fee | 카드 업그레이드에 필요한 연간 수수료 금액(달러)을 지정합니다. 예: 150. card_upgrade가 false이면 이 매개변수가 필요하지 않습니다. |
숫자 |
| card_upgrade_benefit | 카드 업그레이드 시 제공되는 혜택 금액(달러)을 지정합니다. 예: 450. card_upgrade가 false이면 이 매개변수가 필요하지 않습니다. |
숫자 |
| reissue_status | 이 카드에 대해 새 카드가 재발급되었는지 여부를 나타냅니다. | 부울 |
| dispatch_status | 재발급된 카드가 등록된 주소로 발송되었는지 여부를 나타냅니다. reissue_status가 false이면 dispatch_status가 false여야 합니다. |
부울 |
| card_estimated_duration | 신규 카드 발송을 위한 예상 시간입니다. 예: "2 days" 또는 "24 hours". reissue_status가 false이면 이 매개변수가 필요하지 않습니다. |
문자열 |
이 구성요소에 카드 검증 웹훅을 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 관리 탭을 선택합니다.
- 웹훅을 클릭합니다.
- prebuilt_components_lost_and_stolen_card:validate_card 웹훅을 선택합니다.
- 대화형 에이전트(Dialogflow CX) 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
- 요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
- 응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
- 필요에 따라 인증 설정을 검토하고 업데이트합니다.
- 저장을 클릭합니다.
카드 잠금
prebuilt_components_lost_and_stolen_card:lock_card_ticket_number 웹훅은 구성요소가 선택한 카드 잠금 요청을 생성하기 위해 사용됩니다.
API 요청 매개변수
다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| $session.params.phone_number | 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. | 문자열 |
| $session.params.last_four_digit_of_card_number | 사용자가 잠금을 요청한 카드 번호의 마지막 네 자리 숫자입니다. | 문자열 |
| $flow.lock_type | 사용자 카드에 적용할 잠금 유형을 나타냅니다. 기본적으로 이 구성요소는 분실 및 도난 카드에 대해 영구 잠금을 지원합니다. 유효한 잠금 유형은 $flow.card_status_active, $flow.card_status_lock_temp, $flow.card_status_lock_permanent 매개변수로 지정됩니다. 입력 매개변수를 참조하세요. |
문자열 |
| $flow.lock_reason | 사용자가 카드 잠금을 요청한 이유를 나타냅니다. 유효한 값은 prebuilt_components_lost_and_stolen_lock_reason 커스텀 항목으로 정의됩니다. 기본적으로 "damaged", "stolen", "lost", "others"가 지원됩니다. |
문자열 |
API 응답 매개변수
다음 매개변수는 구성요소에서 사용할 API 응답에서 가져옵니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| ticket_number | 생성된 카드 잠금 요청의 티켓 번호입니다. | 정수 |
이 구성요소에 대해 카드 잠금 웹훅을 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 관리 탭을 선택합니다.
- 웹훅을 클릭합니다.
- prebuilt_components_lost_and_stolen_card:lock_card_ticket_number 웹훅을 선택합니다.
- 대화형 에이전트(Dialogflow CX) 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
- 요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
- 응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
- 필요에 따라 인증 설정을 검토하고 업데이트합니다.
- 저장을 클릭합니다.
카드 재발급
prebuilt_components_lost_and_stolen_card:reissue_card_number 웹훅은 구성요소가 신규 또는 업그레이드된 카드의 재발급 요청을 생성하기 위해 사용됩니다.
API 요청 매개변수
다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| $session.params.phone_number | 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. | 문자열 |
| $session.params.last_four_digit_of_card_number | 사용자가 잠금을 요청한 카드 번호의 마지막 네 자리 숫자입니다. | 문자열 |
| zip_code | 사용자 계정에 등록된 우편 번호입니다. | 문자열 |
| card_upgrade | 사용자가 카드 업그레이드를 선택했는지 여부를 나타냅니다. | 부울 |
| card_upgrade_type | 사용자가 선택한 카드 업그레이드 유형을 지정합니다. 예: "gold" 또는 "platinum". card_upgrade가 false이면 이 매개변수가 필요하지 않습니다. |
문자열 |
API 응답 매개변수
다음 매개변수는 구성요소에서 사용할 API 응답에서 가져옵니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| acknowledgement_number | 생성된 카드 재발급 요청의 티켓 번호입니다. | 정수 |
이 구성요소에 대해 카드 재발급 웹훅을 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 관리 탭을 선택합니다.
- 웹훅을 클릭합니다.
- prebuilt_components_lost_and_stolen_card:reissue_card_number 웹훅을 선택합니다.
- 대화형 에이전트(Dialogflow CX) 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
- 요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
- 응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
- 필요에 따라 인증 설정을 검토하고 업데이트합니다.
- 저장을 클릭합니다.
완료
이제 에이전트 및 웹훅이 설정되어 테스트할 수 있습니다.