신용카드 등록 사전 빌드된 구성요소

신용카드 등록 사전 빌드된 구성요소는 신규 및 기존 고객이 새로운 신용카드를 신청할 수 있게 해줍니다.

이 구성요소는 먼저 신규 또는 기존 고객 구분을 위해 최종 사용자의 전화 번호를 수집합니다. 신규 사용자의 경우에는 이 구성요소가 고객의 월 수입과 지출 카테고리 또는 카드 혜택을 포함한 필수 세부정보를 수집합니다. 모든 필수 정보가 수집되었으면 구성요소가 콜백을 예약하고 사용자에게 요청 번호를 부여합니다.

기존 고객의 경우에는 구성요소가 등록된 사용자 정보를 검색하고 신용 점수를 포함해서 사용자의 선호도 및 검색된 정보를 기반으로 최종 사용자에게 사용 가능한 카드 옵션을 제공합니다. 고객이 카드 옵션을 선택하면 구성요소가 WhatsApp 또는 SMS를 포함하여 등록된 채널을 통해 등록 절차를 완료할 수 있는 링크를 전송합니다.

이 구성요소는 전화 번호 수집우편 번호 수집 사전 빌드된 구성요소를 사용해서 사용자 세부정보를 수집하고 검증합니다.

제한사항

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

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

샘플 대화상자

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

새 사용자

구성요소는 연결 전화 번호가 등록된 번호인지 여부를 확인해서 신규 사용자인지 파악합니다. 이 구성요소는 사용자가 등록하려는 카드 카테고리를 수집하고 우편 번호, 전화 번호 등의 사용자 식별 정보를 수집합니다. 그런 후 콜백을 예약하고 사용자에게 요청 번호를 부여합니다.

사용자 입력 에이전트 응답
저희 은행의 기존 고객인지 알려주시겠어요?
아닙니다.
신용카드를 신청해 주셔서 감사합니다. 귀하에게 적합한 신용카드가 다양하게 준비되어 있습니다.

최적의 카드를 제공할 수 있도록 귀하의 월 소득을 USD로 알려주시겠어요?
5,000 달러
특별히 관심이 있는 지출 항목 또는 혜택이 있으신가요? 여행, 주유, 쇼핑과 같은 다양한 옵션이 준비되어 있습니다.
쇼핑이 좋아
선택한 응답은 쇼핑 카테고리에 포함됩니다. 계속 진행하려면 예라고 말해주세요.
에이전트가 우편 번호 수집 사전 빌드된 구성요소를 사용해서 사용자의 우편 번호를 수집합니다.
응답하신 우편 번호는 10011입니다. 올바른가요?
네, 맞습니다.
이제 우편번호 수집이 완료되었습니다.
에이전트가 사전 빌드된 전화번호 수집 구성요소를 사용하여 사용자 전화번호 수집합니다.
알겠습니다. 언급한 숫자가 +1 6502530000인가요?
고맙습니다. 전화 번호 수집이 완료되었습니다.

담당 직원 중 한 명이 귀하가 선택한 조건에 적합한 카드를 알려드릴 예정입니다. 귀하의 요청 번호는 993835입니다.

기존 고객

구성요소가 전화 번호를 통해 해당 고객이 등록 고객인지 파악합니다. 그런 후 구성요소는 사용자가 등록하려는 카드 유형 및 카테고리와 같은 정보를 요청합니다. 이 정보가 확인되었으면 구성요소가 고객에게 등록 프로세스를 완료할 채널을 선택하도록 요청하고 고객의 등록된 채널에 링크를 전송합니다.

사용자 입력 에이전트 응답
저희 제품과 서비스를 계속 이용해주셔서 고맙습니다. 귀하에게 적합한 다양한 신용카드가 준비되어 있습니다.

특별히 관심이 있는 지출 항목 또는 혜택이 있으신가요? 여행, 주유, 쇼핑과 같은 다양한 옵션이 준비되어 있습니다.
다음 휴가에 사용할 수 있는 카드가 필요해요.
선택한 응답이 여행 카테고리에 속합니다. 계속 진행하려면 예라고 말해주세요.
귀하가 요청한 유형에 적합한 3개 카드는 플래티넘 여행 카드, 골드 여행 카드, 클래식 여행 카드입니다. 모든 카드 또는 특정 카드에 대한 정보를 확인하시겠어요? 예를 들어 클래식 카드 정보를 보고 싶으면 클래식 카드라고 말해주세요.
플래티넘 카드에 대해 알려주세요.
플래티넘 여행 카드는 연간 수수료가 95달러입니다. 혜택은 매년 10,000 보너스 마일 제공, 모든 구매 시 무제한 2배 마일 적립, 쉽게 획득하고 쉽게 사용 가능한 마일입니다. 혜택 또는 보너스에 대한 자세한 내용은 저희 웹사이트에서 확인할 수 있습니다.

등록하려는 카드가 플래티넘 여행 카드인지 확인해주세요.
예, 등록해주세요.
등록 절차 단계가 포함된 링크를 제공할 예정입니다. SMS 또는 WhatsApp을 통해 이 카드 세부정보를 휴대전화 번호로 전송하시겠어요?
SMS로 보내주세요.
알겠습니다. 등록된 휴대전화 번호로 링크를 전송하고 있습니다. 이 작업은 몇 초 정도 걸릴 수 있습니다. 예 또는 아니요로 응답해서 링크를 받았는지 알려주시겠어요?
받았습니다.
이제 링크를 열고 카드 등록 세부정보를 확인할 수 있습니다. 데이터가 완료되면 새로운 카드 발급이 시작되고 귀하의 현재 주소로 전송됩니다.

정보 거부

사용자가 신용카드 등록에 필요한 정보 제공을 거부하는 경우에는 구성요소가 오류 메시지와 함께 종료됩니다.

사용자 입력 에이전트 응답
저희 은행의 기존 고객인지 알려주시겠어요?
아닙니다.
신용카드를 신청해 주셔서 감사합니다. 귀하에게 적합한 신용카드가 다양하게 준비되어 있습니다.

최적의 카드를 제공할 수 있도록 귀하의 월 소득을 USD로 알려주시겠어요?
정보를 알려주고 싶지 않아요.
전화해 주셔서 감사합니다. 죄송합니다. 요청한 정보가 없으면 현재 작업을 계속할 수 없습니다.

이름 지정 규칙

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

기능 형식
흐름 [구성요소 이름] 신용카드 등록
구성요소 특정 인텐트 prebuilt_components_[component_name]_[intent_name] prebuilt_components_cc_enroll_collect_cardtype
항목 유형 prebuilt_components_[component_name]_[entity_type] prebuilt_components_cc_enroll_expense_category
웹훅 prebuilt_components_[component_name]:[webhook_action] prebuilt_components_credit_card_enrollment:get_available_card

입력 매개변수

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

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

매개변수 이름 설명 입력 형식
$session.params.auth_level (선택사항) 최종 사용자의 현재 인증 레벨을 나타냅니다. 정수
$session.params.phone_number (선택사항) 최종 사용자의 전화 번호입니다. 이 매개변수를 제공하지 않으면 구성요소가 최종 사용자로부터 전화 번호를 수집합니다. 문자열
$flow.max_retry_count 최종 사용자에게 제공되는 재시도 횟수를 지정합니다. 기본값은 3입니다. 정수
$flow.currency_name 월 소득 세부정보를 수집할 때의 예상 통화를 지정합니다. 기본값은 "USD"입니다. 문자열

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

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

출력 매개변수

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

매개변수 이름 설명 출력 형식
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 기본 제공 이벤트를 참조하세요.
문자열

기본 설정

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

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

웹훅 설정

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

계정 세부정보 가져오기

prebuilt_components_credit_card_enrollment:get_account_details 웹훅은 계정이 있는 경우 구성요소가 사용자의 계정 세부정보를 검색하기 위해 사용됩니다.

API 요청 매개변수

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

매개변수 이름 설명 입력 형식
$session.params.phone_number 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. 문자열

API 응답 매개변수

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

매개변수 이름 설명 출력 형식
account_count 등록된 전화 번호와 연결된 계정 수입니다. 정수
credit_score 사용자의 등록된 신용카드입니다. 정수

이 구성요소에 대해 계정 세부정보 가져오기 웹훅을 구성하려면 안내를 펼칩니다.

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

카드 수 가져오기

prebuilt_components_credit_card_enrollment:get_card_count 웹훅은 구성요소가 등록된 사용자 계정과 연결된 신용카드 수를 검색하기 위해 사용됩니다.

API 요청 매개변수

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

매개변수 이름 설명 입력 형식
$session.params.phone_number 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. 문자열

API 응답 매개변수

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

매개변수 이름 설명 출력 형식
card_count 등록된 사용자 계정의 총 신용카드 수입니다. 정수

이 구성요소의 카드 수 가져오기 웹훅을 구성하려면 안내를 펼칩니다.

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

사용 가능한 카드 가져오기

prebuilt_components_credit_card_enrollment:get_available_card 웹훅은 구성요소가 사용자의 신용 점수에 따라 특정 카테고리에서 사용자가 선택할 수 있는 카드 목록을 검색하기 위해 사용됩니다.

API 요청 매개변수

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

매개변수 이름 설명 입력 형식
$flow.expense_category 사용자가 등록을 선택한 지출 카테고리입니다. 유효한 값은 prebuilt_components_cc_enroll_expense_category 커스텀 항목으로 정의됩니다. 기본적으로 fuel, shopping, travel이 지원됩니다. 문자열
$flow.credit_score 구성요소가 계정 세부정보 가져오기 웹훅을 사용해서 검색한 사용자의 신용 점수입니다. 정수

API 응답 매개변수

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

매개변수 이름 설명 출력 형식
available_card_names 사용자에게 제공되는 카드 목록입니다. 예: ["gold shopping card","classic shopping card"]. 목록(문자열)
cards_count 사용자가 사용할 수 있는 카드 수입니다. 정수

이 구성요소에 대해 사용 가능한 카드 가져오기 웹훅을 구성하려면 안내를 펼칩니다.

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

선택한 카드 세부정보 가져오기

prebuilt_components_credit_card_enrollment:get_selected_card 웹훅은 구성요소가 선택한 카드의 연간 수수료 및 혜택을 검색하는 데 사용됩니다.

API 요청 매개변수

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

매개변수 이름 설명 입력 형식
$flow.card_type 사용자가 등록을 선택한 카드 유형입니다. 유효한 값은 prebuilt_components_cc_enroll_card_type 커스텀 항목으로 정의됩니다. 기본적으로 classic, gold, platinum이 지원됩니다. 문자열
$flow.expense_category 사용자가 등록을 선택한 지출 카테고리입니다. 유효한 값은 prebuilt_components_cc_enroll_expense_category 커스텀 항목으로 정의됩니다. 기본적으로 fuel, shopping, travel이 지원됩니다. 문자열
$flow.credit_score 구성요소가 계정 세부정보 가져오기 웹훅을 사용해서 검색한 사용자의 신용 점수입니다. 정수

API 응답 매개변수

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

매개변수 이름 설명 출력 형식
selected_card_benefits 선택한 카드의 혜택에 대한 정보입니다. 문자열
selected_card_annual_fee 선택한 카드의 연간 수수료입니다. 정수
selected_card_name 선택한 카드의 이름입니다. 문자열

이 구성요소에 대해 선택한 카드 세부정보 가져오기 웹훅을 구성하려면 안내를 펼칩니다.

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

등록 요청 제출

prebuilt_components_credit_card_enrollment:submit_enroll 웹훅은 구성요소에서 신규 사용자가 제공한 선호도 및 사용자 세부정보를 기반으로 카드 등록 요청을 생성하기 위해 사용됩니다.

API 요청 매개변수

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

매개변수 이름 설명 입력 형식
$session.params.phone_number 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. 문자열
$flow.zipcode 사용자가 제공한 우편 번호입니다. 문자열
$flow.monthly_salary 사용자가 제공한 월 소득입니다. 정수
$flow.currency_name 구성요소의 입력 매개변수에 구성된 월 소득의 통화입니다. 입력 매개변수를 참조하세요. 문자열

API 응답 매개변수

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

매개변수 이름 설명 출력 형식
request_number 카드 등록 요청을 성공적으로 수행하기 위한 요청 번호입니다. 정수

이 구성요소의 등록 요청 제출 웹훅을 구성하려면 안내를 펼칩니다.

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

메시지 보내기

prebuilt_components_credit_card_enrollment:send_message 웹훅은 구성요소가 기존 고객의 신용 카드 등록을 완료하기 위해 링크가 포함된 메시지를 전송하는 데 사용됩니다.

API 요청 매개변수

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

매개변수 이름 설명 입력 형식
$session.params.phone_number 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. 문자열
$flow.channel 사용자가 메시지를 수신하도록 선택한 채널입니다. 유효한 값은 prebuilt_components_cc_enroll_channel 커스텀 항목으로 정의됩니다. 기본적으로 SMSWhatsApp이 지원됩니다. 문자열
$flow.selected_card_name 사용자가 선택한 카드 목록입니다. 예: ["gold shopping card","classic shopping card"]. 목록(문자열)

API 응답 매개변수

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

매개변수 이름 설명 출력 형식
message_sent 사용자가 지정한 채널로 메시지가 성공적으로 전송되었는지 여부를 나타냅니다. 부울

이 구성요소에 메시지 전송 웹훅을 구성하려면 안내를 펼칩니다.

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

완료

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