사전 빌드된 이의 제기 구성요소

사전 빌드된 이의 제기 구성요소는 사용자를 인증하고 청구, 거래 및 요금에 대해 논쟁하고 이의를 제기할 수 있습니다. 이 구성요소는 사전 빌드된 인증 구성요소 버전의 커스텀 버전을 사용하여 계정 소유자 및 카드 소지자를 인증합니다. 또한 이 구성요소는 사전 빌드된 생일 구성요소의 커스텀 버전을 사용하여 이의 제기된 트랜잭션의 날짜를 수집합니다.

제한사항

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

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

샘플 대화상자

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

거래 내역에 분쟁이 있는 인증되지 않은 사용자

에이전트는 사용자가 이전에 인증되지 않았음을 식별하고 정보를 수집하여 사용자가 등록된 계정 소유자인지 확인합니다. 에이전트는 계정 번호, 분쟁 모드, 날짜, 금액 등 이의 제기에 대한 정보를 수집하고 이의 제기를 위한 새로운 케이스를 만듭니다.

사용자 입력 에이전트 응답
에이전트가 사전 빌드된 인증 구성요소를 사용하여 사용자 인증을 수행합니다.
감사합니다. 인증이 성공적으로 완료되었습니다.
온라인 뱅킹 포털에서 클레임을 제기하거나 요금에 대해 이의 제기할 수 있습니다. 이 대화를 계속하여 주장이나 이의 제기를 제기하시겠어요?
예, 이의를 제기합니다.
이의 제기가 신용카드 결제 또는 거래와 관련이 있는지 알려주세요.
내 거래에 관한 내용임
계정 세부정보를 가져오는 동안 잠시 기다려 주세요.

귀하의 번호에 연결된 계정이 2개 있는 것으로 확인되었습니다. 말씀하시는 계정의 마지막 4자리 숫자를 알려주세요.
1001
감사합니다. 수집한 마지막 4자리 숫자는 1001입니다. 맞나요?
먼저 거래 날짜가 언제인가요?
에이전트가 사전 빌드된 생일 구성요소를 사용하여 거래 날짜 수집
송금하신 금액을 확인해 주시겠어요? 예를 들어 $100.30 이상의 거래를 찾고 싶다면 '100'이라고 말합니다.
15달러
2023년 5월 0일의 이의 제기 금액이 $15입니다. 계정에 대한 이의 제기를 요청하고 싶으신가요?
이의 제기를 포함하여 새 케이스를 만들었습니다. 케이스 번호는 448639이고 등록된 이메일 주소와 공유되었습니다. Google에 제공한 정보를 확인한 후 1001로 끝나는 계정으로 환불해 드립니다.

신용카드 분쟁이 있는 인증된 사용자

에이전트가 이전에 인증된 사용자를 식별하고 이 사용자에게 등록된 카드 정보를 검색합니다. 사용자가 카드를 영구적으로 잠그도록 선택하면 에이전트가 카드 잠금 요청을 영구적으로 생성합니다. 그런 다음 에이전트는 사용자에게 영구적으로 잠긴 카드에 대한 새 카드를 재발급할지 물어보고 카드 재발급 요청을 만듭니다.

사용자 입력 에이전트 응답
귀하의 전화번호와 연결된 신용카드가 2개 있는 것으로 확인되었습니다. 4321로 끝나는 카드 번호를 찾고 계신가요?
신용카드 청구와 관련된 이의가 제기된 경우 '신용카드 청구'라고 말합니다.
신용카드 결제
과다 수수료 또는 신용카드 결제와 관련된 이의를 제기하고 싶으신가요?
요금이 과다 청구됨
먼저 문제가 발생한 달을 확인해 주시겠어요?
04
클레임을 제기하려는 금액을 확인할 수 있나요? 예를 들어 $100.30 이상의 주장을 찾으려면 '100'이라고 말합니다.
4567
감사합니다. 이 잠재적 문제와 관련된 수수료에 대한 설명을 확인해 주시겠어요? 연간 수수료, 거래 수수료, 지연 결제 수수료 또는 기타 수수료 중에서 선택할 수 있습니다.
연간 수수료
2023년 4월 1일의 이의 제기 금액이 $4,567입니다. 신용카드에 대한 이의를 제기하시겠습니까?
이의 제기를 포함하여 새 케이스를 만들었습니다. 케이스 번호는 111236이고 등록된 전화번호와 공유되었습니다. 케이스는 앞으로 영업일 기준 3일 이내에 해결될 예정입니다.

이름 지정 규칙

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

기능 형식
흐름 [구성요소 이름] 이의 제기
구성요소별 인텐트 prebuilt_components_[component_name]_[intent_name] prebuilt_components_disputes_dispute_type
항목 유형 prebuilt_components_[component_name]_[entity_type] prebuilt_components_disputes_dispute_reason
웹훅 prebuilt_components_[component_name]:[webhook_action] prebuilt_components_disputes:get_disputed_transaction

입력 매개변수

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

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

매개변수 이름 설명 입력 형식
$session.params.auth_level (선택사항) 호출자의 인증 레벨을 나타냅니다. 정수
$session.params.auth_level_req 사용자가 자신의 거래 기록에 액세스하기 전에 필요한 인증 레벨을 나타냅니다. 이 값은 check auth level 페이지에서 페이지 진입 충족 요건의 매개변수 사전 설정에 구성되어 있습니다. 기본적으로 이 값은 1입니다. 정수
$session.params.account_auth_enabled 인증 유형에 설명된 대로 사용자를 계좌 소유자로 인증해야 하는지 여부를 나타냅니다. 이 값은 check auth level 페이지에서 페이지 진입 충족 요건의 매개변수 사전 설정에 구성되어 있습니다. 기본적으로 이 값은 true입니다. 부울
$session.params.card_auth_enabled 인증 유형에 설명된 대로 사용자를 카드 소지자로 인증해야 하는지 여부를 나타냅니다. 이 값은 check auth level 페이지에서 페이지 진입 충족 요건의 매개변수 사전 설정에 구성되어 있습니다. 기본적으로 이 값은 false입니다. 부울
$session.params.phone_number (선택사항) 인증에 사용된 고객의 등록된 전화번호입니다. 문자열
$session.params.card_count (선택사항) 인증된 사용자와 연결된 신용카드 개수입니다. 정수
$session.params.account_count (선택사항) 등록된 전화번호와 연결된 계정의 개수입니다. 이러한 계정에는 자체 계정 및 사용자에게 위임장이 있는 계정이 포함됩니다. 정수
$session.params.last_four_digit_of_card_number (선택사항) 이의 제기가 발생할 수 있는 카드 번호의 마지막 4자리 숫자입니다. 고객에게 카드가 하나만 있는 경우 이 정보는 인증 후 자동으로 검색됩니다. 고객에게 카드가 여러 개 있는 경우 고객에게서 특정 카드 번호가 수집됩니다. 문자열
$session.params.last_four_digit_of_account_number (선택사항) 이의 제기가 발생할 수 있는 고객 계정 번호의 마지막 4자리 숫자입니다. 고객에게 단일 계정이 있으면 이 정보는 인증 후에 자동으로 검색됩니다. 고객에게 계좌가 여러 개 있는 경우 고객에게서 특정 계좌 번호가 수집됩니다. 문자열
$flow.max_dispute_month 이의 제기된 거래 날짜에 허용되는 현재 날짜 이전의 최대 개월 수를 지정합니다. 기본적으로 이 값은 -6이며, 현재 날짜로부터 6개월 이내의 거래에 대해 이의 제기를 할 수 있음을 나타냅니다. 정수
$flow.max_attempts 사용자에게 일회용 비밀번호(OTP)를 수집할 때 허용되는 재시도 횟수를 지정합니다. 기본값은 2입니다. 정수
flow.max_retry_counter 사용자로부터 정보를 수집할 때 허용되는 재시도 횟수를 지정합니다. 기본값은 2입니다. 정수

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

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

출력 매개변수

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

매개변수 이름 설명 출력 형식
auth_level 호출자의 인증 레벨을 나타냅니다. 정수
phone_number 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. 문자열
card_count 인증된 사용자와 연결된 신용카드 수입니다. 정수
account_count 등록된 전화번호와 연결된 계좌의 개수입니다. 이러한 계좌에는 자체 계좌 및 사용자에게 위임장이 있는 계좌가 포함됩니다. 정수
last_four_digit_of_card_number 이의 제기가 발생한 카드 번호의 마지막 4자리 숫자입니다. 문자열
last_four_digit_of_account_number 이의 제기가 발생한 고객 계정 번호의 마지막 4자리 숫자입니다. 문자열
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_account_services:get_credit_card_details 웹훅은 구성요소가 사용자에게 등록된 신용카드 정보를 가져오기 위해 사용됩니다.

API 요청 매개변수

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

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

API 응답 매개변수

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

매개변수 이름 설명 출력 형식
credit_card_count 등록된 전화번호와 연결된 신용카드 개수입니다. 정수
last_four_digit_of_credit_card_number 사용자에게 신용카드가 하나만 있으면 카드 번호의 마지막 네 자리 숫자가 반환됩니다. 사용자에게 카드가 2개 이상 있는 경우 이 매개변수의 값은 null입니다. 문자열
이메일 계정에 등록된 이메일입니다. 계정에 등록된 이메일이 없으면 이 매개변수의 값은 null입니다. 문자열

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

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

신용카드 검증

prebuilt_components_disputes:validate_credit_card 웹훅은 구성요소에서 지정된 신용카드가 사용자에게 등록되어 있는지 확인하는 데 사용됩니다.

API 요청 매개변수

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

매개변수 이름 설명 입력 형식
$session.params.phone_number 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. 문자열
$session.params.last_four_digit_of_card_number 사용자가 이의 제기를 요청한 카드 번호의 마지막 4자리 숫자입니다. 문자열

API 응답 매개변수

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

매개변수 이름 설명 출력 형식
card_found 요청된 카드가 있는지 여부를 나타냅니다. 부울

이 구성요소에 신용카드 검증 웹훅을 구성하려면 안내를 펼칩니다.

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

계정 검증

prebuilt_components_account_services:validate_account 웹훅은 구성요소에서 사용자의 등록된 전화번호 및 제공된 계좌 번호의 마지막 4자리를 기준으로 계좌가 존재하는지 확인하는 데 사용됩니다. 계좌가 존재하는 경우 웹훅에서 계좌 잔액도 반환합니다.

API 요청 매개변수

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

매개변수 이름 설명 입력 형식
$session.params.phone_number 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. 문자열
$session.params.last_four_digit_of_account_number 사용자가 이의 제기를 요청한 계정 번호의 마지막 4자리 숫자입니다. 문자열

API 응답 매개변수

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

매개변수 이름 설명 출력 형식
account_found 사용자의 등록된 계좌에 제공된 마지막 4자리 숫자가 포함된 계좌가 있는지 여부를 나타냅니다. 부울
잔액 계좌의 현재 잔액(존재하는 경우)입니다. 숫자

이 구성요소에 계좌 검증 웹훅을 구성하려면 안내를 펼칩니다.

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

거래 확인

prebuilt_components_disputes:validate_transaction 웹훅은 구성요소에서 지정된 거래가 존재하는지 여부를 확인하는 데 사용됩니다.

API 요청 매개변수

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

매개변수 이름 설명 입력 형식
$session.params.phone_number 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. 문자열
$flow.dispute_type 이의 제기된 거래의 유형입니다. 유효한 값은 prebuilt_components_disputes_dispute_type 커스텀 항목으로 정의됩니다. 문자열
$flow.dispute_date 이의 제기가 발생한 트랜잭션의 날짜로, YYYY-MM-DD 형식입니다. 문자열
$flow.dispute_amount 이의 제기된 거래 금액입니다. 정수
$flow.last_four_digits 이의 제기가 발생한 신용카드의 마지막 4자리 또는 계정 번호 문자열

API 응답 매개변수

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

매개변수 이름 설명 출력 형식
transaction_found 요청된 거래가 있는지 여부를 나타냅니다. 부울

이 구성요소에 트랜잭션 검증 웹훅을 구성하려면 안내를 펼칩니다.

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

이의 제기 케이스 만들기

prebuilt_components_disputes:create_dispute_case 웹훅은 구성요소에서 이의 제기를 위한 새로운 케이스를 만드는 데 사용됩니다.

API 요청 매개변수

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

매개변수 이름 설명 입력 형식
$session.params.phone_number 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. 문자열
$flow.dispute_type 이의 제기 유형입니다. 유효한 값은 prebuilt_components_disputes_dispute_type 커스텀 항목으로 정의됩니다. 문자열
$flow.dispute_date 이의 제기가 발생한 트랜잭션의 날짜로, YYYY-MM-DD 형식입니다. 문자열
$flow.dispute_amount 이의 제기된 거래 금액입니다. 정수
$flow.dispute_reason 이의 제기 사유입니다. 유효한 값은 prebuilt_components_disputes_dispute_reason 커스텀 항목으로 정의됩니다. 문자열
$flow.dispute_fee_type 이의 제기에 대한 수수료 유형입니다. 유효한 값은 prebuilt_components_disputes_fee_types 커스텀 항목으로 정의됩니다. 문자열
$flow.last_four_digits 이의 제기가 발생한 신용카드의 마지막 4자리 또는 계정 번호 문자열

API 응답 매개변수

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

매개변수 이름 설명 출력 형식
dispute_case_number 생성된 이의 제기의 케이스 번호입니다. 정수

이 구성요소에 이의 제기 케이스 만들기 웹훅을 구성하려면 안내를 펼칩니다.

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

완료

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