소스 .csv 파일의 데이터 작업
외부 ID는 Genesys Cloud의 필수 키 필드입니다. 수입 프로세스 고유한 연락처를 결정하는 데 사용됩니다. 이 필드는 연락처를 식별하는 데 도움이 되므로 동일한 스프레드시트를 통해 기존 연락처를 쉽게 업데이트할 수 있습니다. 고유한 외부 ID마다 가져오기 프로세스를 통해 Genesys Cloud 외부 연락처 레코드가 하나 생성됩니다. 가져오기 프로세스는 행의 모든 연락처 필드를 해당 Genesys Cloud 외부 연락처 레코드로 가져옵니다.
외부 ID를 만들 때는 문자와 숫자를 원하는 대로 조합하여 사용할 수 있습니다. 예를 들어, CRM이나 ERP 시스템의 고유 식별자를 사용할 수도 있고, 사용자에게 의미 있는 복합 키를 만들 수도 있습니다. 255자 제한을 충족하는 한, 레코드를 식별하는 데 사용할 수 있는 외부 ID가 될 수 있습니다. CRM에서 .csv 파일을 추출하는 경우 CRM의 고유 식별자(UUID)를 사용하는 것이 좋습니다. UUID를 사용하면 CRM의 연락처를 향후 기능 업데이트에서 동기화할 수 있습니다.
레코드를 한 번만 가져올 계획이라면 원하는 외부 ID를 사용할 수 있습니다. 시스템은 이러한 외부 ID에 대응하는 내부 ID를 생성합니다.
- 이전에 다음을 사용하여 연락처를 가져온 경우 오래된 대량 가져오기 프로세스에서 시스템은 전화번호 또는 이메일 주소 식별자만 사용하여 연락처를 새로운 외부 ID와 일치시키고 업데이트합니다.
- 기존 연락처를 새 레코드와 성공적으로 병합하려면 .csv 대량 가져오기를 수행할 때 .csv 파일의 모든 전화 번호가 다음을 따르는 것이 중요합니다. E.164 형식 전화로 매칭할 경우.
- .csv 파일의 전화번호가 E.164 형식을 따르지 않는 경우 데이터 검증 단계는 다음과 같습니다. 가져오기 프로세스에서 경고가 발생합니다. 연락처 가져오기 프로세스가 계속 진행되는 동안 ID 확인 알고리즘이 전화번호를 기반으로 연락처를 정확하게 일치시키고 병합한다는 보장은 없습니다.
- 기존 연락처의 이메일이나 전화번호가 새 .csv 파일에 있는 이메일이나 전화번호와 일치하지 않는 경우, 시스템은 지정된 외부 ID로 .csv 파일에 레코드를 생성합니다.
- 동일한 파일에서 연락처 정보가 여러 번 반복되는 경우, 연락처는 여러 번 업데이트되고, 가져온 행 카운터는 반복을 반영합니다. 하지만 업데이트가 이루어지는 순서는 보장되지 않습니다.
이전에 가져온 연락처를 업데이트할 때는 중복 레코드가 생성되는 것을 방지하기 위해 동일한 외부 ID를 사용해야 합니다.
예를 들어, 'A'를 외부 ID로 사용하는 레코드가 있는 스프레드시트를 가져온 다음 나중에 해당 레코드의 외부 ID가 'B'인 동일한 스프레드시트를 다시 가져오는 경우 Genesys Cloud는 기존 레코드를 업데이트하는 대신 레코드를 만듭니다. 기존 레코드를 업데이트하려면 항상 동일한 외부 ID를 사용하세요.
외부 조직
티 외부 조직 외부 ID 이다 가져오기 프로세스에서 고유한 조직을 결정하는 데 사용하는 키 필드 . 고유한 외부 조직 ID마다 가져오기 프로세스를 통해 하나의 Genesys Cloud 외부 조직 레코드가 생성됩니다. 가져오기 프로세스는 행의 모든 계정 필드를 해당 Genesys Cloud 외부 조직 레코드로 가져옵니다.
외부 조직 외부 ID를 만들 때는 문자와 숫자를 원하는 대로 조합하여 사용할 수 있습니다. 255자 제한을 충족하는 한, 자신에게 의미 있는 복합 키를 만들 수 있습니다. CRM에서 .csv 파일을 추출하는 경우 CRM의 고유 식별자(UUID)를 사용하는 것이 좋습니다. UUID를 사용하면 CRM의 연락처를 향후 기능 업데이트에서 동기화할 수 있습니다.
외부 연락처를 외부 조직과 연결
외부 연락처를 외부 조직과 연결하려면 .csv 소스 파일에서 같은 줄에 입력합니다.
이 예에서 Angus Reid는 Phoenix Foundation II의 문제 해결사입니다. 가져오기 프로세스에서는 Phoenix Foundation II에 대한 외부 조직 레코드와 Angus Reid에 대한 외부 연락처 레코드가 생성됩니다. 외부 연락처에서 Angus Reid는 Phoenix Foundation II 조직의 외부 연락처로 나타납니다.
여러 외부 연결 하나의 연락처 외부의 조직
여러 외부 연락처를 하나의 연락처와 연결하려면 외부 외부 조직에 동일한 외부 조직 외부 ID를 할당합니다.
이 예에서 Kathryn, Josh 및 Rebecca는 모두 Office Mart 조직의 연락처입니다.
- 여러 행이 외부 조직 외부 ID를 공유하는 경우 모든 조직별 필드는 동일해야 하며(예: 계정 이름) Genesys Cloud는 모든 관련 연락처에 대해 하나의 외부 조직을 만듭니다. Genesys Cloud는 외부 ID당 하나의 행만 가져오고, 관련된 모든 연락처에 대해 하나의 외부 조직을 생성하며 어떤 행이 사용되는지 보장하지 않습니다. 행 간에 차이가 있는 경우 각 행은 외부 조직에 대한 업데이트를 위해 별도로 전송됩니다.
- .csv 파일을 사용하여 수동으로 만든 조직으로 구성원을 가져올 수 없습니다.
대량 가져오기 프로세스가 병합 작업을 관리하는 방법
이 예에서는 연락처만 가져오고 .csv 파일의 모든 외부 연락처 조직 필드는 비어 있다고 가정합니다.
대량 가져오기 프로세스 중에 가져오기 프로필 화면에서 다음 옵션이 선택되었습니다.
- 연락처 일치 : 외부 ID, 전화번호 및 이메일 주소
- 일치하는 연락처 병합 : 일치하는 모든 연락처를 병합하고 업데이트합니다.
이 예에서는 다음 식별자가 검색됩니다.
- ExternalID: 123AABC
- 전화: +1 919 432 5523
- email: tom.sellenta@sag.aftra.com
.csv의 직장 전화번호는 연락처 C의 휴대전화 번호와 일치합니다. 새로운 병합된 ContactD가 생성됩니다.
다음 표에서,
- 필드 이름 열은 .csv 파일의 필드 이름을 나타냅니다.
- CSV 데이터(요청 강화) 열은 .csv 파일의 데이터를 나타냅니다.
- 연락처 B 열은 Genesys Cloud에서 큐레이션된 연락처입니다.
- Contact C 열은 Genesys Cloud에서 큐레이션된 연락처입니다.
- 연락처 D 열은 가져오기가 완료된 후 병합된 연락처입니다.
- 설명 열은 연락처 D 열 데이터를 가져온 방법을 설명합니다.
필드 이름 | CSV 데이터(요청 강화) | B에게 연락하세요 | C에게 연락하세요 | 연락처 D(병합된 연락처) | 설명 |
---|---|---|---|---|---|
외부 SIP | 123AABC | 123AABC | .csv 레코드의 외부 ID는 병합된 레코드의 기본 식별자로 사용됩니다. 이전 .csv 가져오기에 사용된 연락처 ID는 더 이상 연락처 레코드에 사용되거나 표시되지 않습니다. | ||
이름 | 남자 이름 | 나사 돌리개 | 남자 이름 | 남자 이름 | 데이터 충돌이 발생하면 병합된 연락처는 .csv 파일의 최신 데이터를 유지합니다. |
middleName | 목 | 목 | .csv 가져오기에서는 Null 값이 사용되지 않습니다. C의 값이 사용됩니다. | ||
성 | 셀렉 | 셀크 | 셀렉 | 데이터 충돌이 발생하면 병합된 연락처는 .csv 파일의 최신 데이터를 유지합니다. | |
제목 | 문제 해결사 | 문제 해결사 | 연락처 C의 값이 사용됩니다. | ||
인사말 | 아저씨 | Mr. | 아저씨 | 데이터 충돌이 발생하면 병합된 연락처는 .csv 파일의 최신 데이터를 유지합니다. | |
작업 이메일 | tom.selleck@sag.aftra.com | tom@gmail.com | tom.selleck@sag.aftra.com | tom.selleck@sag.aftra.com | 데이터 충돌이 발생하면 병합된 연락처는 .csv 파일의 최신 데이터를 유지합니다. |
개인 이메일 | tom@hotmail.com | tommy@yahoo.com | tom@gmail.com | 병합 중에는 데이터 손실을 방지하기 위해 이메일과 전화번호를 신중하게 처리합니다. 두 연락처가 동일한 필드(예: 직장 이메일)를 사용하는 경우, 해당 데이터는 다른 사용 가능한 필드(예: 개인 이메일 또는 기타 이메일)로 이동됩니다. 이 예에서 "tom@gmail.com"은 삭제하는 대신 workEmail에서 personalEmail로 이동합니다. 이 과정은 가능한 모든 필드가 사용될 때까지 반복적으로 계속됩니다. 공간이 제한되어 있는 경우 요청 값을 수용하기 위해 이전 이메일이 삭제됩니다. |
|
기타 이메일 | tommy@hotmail.com | 구체적인 필드 이름은 중요하지 않으며 가능한 한 병합된 연락처의 데이터는 보존됩니다. 이전할 필드가 남아 있지 않으면 데이터는 삭제됩니다. | |||
휴대전화 | +1 919 432-5523 | .csv의 직장 전화번호는 연락처 C의 휴대폰 번호와 일치합니다. | |||
직장 전화 | +1 919 432-5523 | +1 317 845-1232 | +1 317 845-1232 | 가져오기 필드 확인란이 선택 취소되었기 때문에 연락처 C의 직장 전화 번호는 가져오기 후에 변경되지 않습니다. | |
홈 전화 | 업데이트가 없고, 연락해도 아무런 가치가 없습니다. | ||||
기타 전화 | 업데이트 없음, 연락처에 가치 없음 |
이 예제에서는 연락처만 가져옵니다. .csv 파일의 외부 조직 필드는 비어 있다고 가정합니다.
대량 가져오기 프로세스 중에 가져오기 프로필 화면에서 다음 옵션이 선택되었습니다.
- 연락처 일치 기준: 외부 ID, 이메일 주소, 전화번호
- 일치하는 연락처 병합 : 첫 번째로 일치하는 연락처만 업데이트합니다.
이 예에서 검색된 식별자의 순서는 다음과 같습니다. (이메일 ID는 ExternalID보다 앞에 옵니다)
- ExternalID: 123AABC
- 이메일: tom.selleck@sag.aftra.com
- 전화: +1 919 432-5523
.csv 파일의 업무용 이메일은 연락처 C의 업무용 이메일과 일치하고, 업무용 전화번호는 연락처 B의 휴대전화와 일치했습니다. '모든 일치 연락처 병합 및 업데이트' 옵션이 선택되지 않았으므로 가져온 후에는 연락처 C만 업데이트되고 연락처 B는 변경되지 않습니다. 두 연락처 모두 CSV 데이터와 부분적으로 일치하더라도 마찬가지입니다.
다음 표에서,
- 필드 이름 열은 .csv 파일의 필드 이름을 나타냅니다.
- CSV 데이터(요청 강화) 열은 .csv 파일의 데이터를 나타냅니다.
- 연락처 B 열은 Genesys Cloud에서 큐레이션된 연락처입니다.
- Contact C 열은 Genesys Cloud에서 큐레이팅된 연락처입니다.
- 업데이트된 연락처 C 열은 가져오기가 완료된 후의 데이터입니다.
- 설명 열은 연락처 D 열 데이터를 가져온 방법을 설명합니다.
필드 이름 | CSV 데이터(요청 강화) | B에게 연락하세요 | C에게 연락하세요 | 업데이트된 연락처 C | 설명 |
---|---|---|---|---|---|
외부 SIP | 123AABC | 123AABC |
.csv 레코드의 외부 ID는 연락처 C 레코드를 기본 식별자로 강화합니다. 이전 .csv 가져오기에 사용된 계정 ID는 더 이상 연락처 레코드에 사용되거나 표시되지 않습니다. |
||
이름 | 남자 이름 | 나사 돌리개 | 남자 이름 | 남자 이름 | 갈등이 없으면 변화도 없습니다. |
middleName | 목 | 목 |
.csv에는 middleName에 대한 값이 없지만 Contact C에는 값이 있습니다. 따라서 Contact C의 middleName 값은 변경되지 않습니다. |
||
성 | 셀렉 | 셀크 | 셀렉 | 갈등. .csv의 데이터로 연락처 C를 업데이트합니다. | |
제목 | 문제 해결사 | 문제 해결사 | 가져오기 필드가 선택되지 않았으므로 업데이트가 없습니다. | ||
인사말 | 아저씨 | Mr. | 아저씨 | 갈등. .csv의 데이터로 연락처 C를 업데이트합니다. | |
작업 이메일 | tom.selleck@sag.aftra.com | tom@gmail.com | tom.selleck@sag.aftra.com | tom.selleck@sag.aftra.com |
.csv 파일의 업무용 이메일은 연락처 C의 업무용 이메일과 일치합니다. 이 연락처는 가져온 후 업데이트되었으며, 연락처 B는 일치하는 첫 번째 연락처가 아니었고, 연락처 C가 일치하는 첫 번째 연락처였으므로 변경되지 않았습니다. |
개인 이메일 | tommy@yahoo.com | tom@yahoo.com | 가져오기 필드가 선택되지 않았으므로 업데이트가 없습니다. | ||
기타 이메일 | 업데이트가 없고, 연락해도 아무런 가치가 없습니다. | ||||
휴대전화 | +1 317 845-1232 | +1 317 845-1232 | 가져오기 필드가 선택되지 않았으므로 업데이트가 없습니다. | ||
직장 전화 | +1 919 432-5523 | +1 317 845-1232 | +1 919 432-5523 | 충돌이 있으므로 연락처 C가 .csv의 데이터로 업데이트됩니다. | |
홈 전화 | 업데이트가 없고, 연락해도 아무런 가치가 없습니다. | ||||
기타 전화 | 업데이트가 없고, 연락해도 아무런 가치가 없습니다. |
이 예에서는 일부 연락처를 식별하고 일부 연락처를 큐레이션합니다.
연락처는 다음 세 가지 유형 중 하나일 수 있습니다.
- 일시적인 : 클라이언트 측 웹 식별자나 쿠키와 연결된 자동 생성된 연락처이지만 다른 정보는 없습니다. 즉, 웹 쿠키/클라이언트 측 식별자가 가리키는 빈 연락처입니다. 60일의 TTL(수명) 제한이 있습니다.
- 식별됨 : 쿠키가 아닌 PII를 포함하고 TTL 제한이 60일인 자동 생성된 연락처입니다.
- 큐레이트됨 : 에이전트나 API 호출에 의해 생성되거나 _홍보_된 연락처입니다. TTL 제한이 없습니다.
일시적 연락처와 식별된 연락처는 시스템에서 생성되며 검색 API, 역방향 화이트페이지 조회 또는 스캔에 나타나지 않습니다.
다음 두 연락처가 시스템에서 일치합니다.
- 연락처 B (큐레이트)
- 연락처 C (식별됨)
대량 가져오기 프로세스 중에 가져오기 프로필 화면에서 다음 옵션이 선택되었습니다.
- 연락처 일치 : 외부 ID, 이메일 주소, 전화번호.
- 일치하는 연락처 병합 : 일치하는 모든 연락처를 병합하고 업데이트합니다.
이 예에서는 다음 식별자가 검색됩니다.
- ExternalID:123AABC
- 이메일: johnny@gmail.com
- 전화: +1 919 432-5523
.csv 파일의 개인 이메일 필드는 연락처 C의 다른 이메일 필드와 일치합니다. 즉, johnny@gmail.com .
.csv 파일의 직장 전화번호는 연락처 B의 휴대전화 번호인 +1 919 432-5523과 일치합니다.
다음 표에서,
- 필드 이름 열은 .csv 파일의 필드 이름을 나타냅니다.
- CSV 데이터(요청 강화) 열은 .csv 파일의 데이터를 나타냅니다.
- 연락처 B 열은 Genesys Cloud에서 큐레이션된 연락처입니다.
- 연락처 C 열은 Genesys Cloud에서 식별된 연락처입니다.
- 연락처 D 열은 가져오기가 완료된 후 병합된 연락처입니다.
- 설명 열은 연락처 D 열 데이터를 가져온 방법을 설명합니다.
필드 이름 | CSV 데이터(요청 강화) | B에게 연락하세요 | C에게 연락하세요 | D에게 연락하세요 | 설명 |
외부 SIP | 123AABC | 123AABC | .csv 레코드의 외부 ID는 병합된 연락처 D 레코드를 기본 식별자로 강화합니다. | ||
이름 | 남자 | 남자 | .csv 가져오기에서는 Null 값이 사용되지 않습니다. C의 값이 사용됩니다. | ||
middleName | 매튜 | 월 | 매튜 | 갈등이 있기 때문에 가치는 최신 큐레이트된 연락처 사용됩니다. | |
성 | 뱅크스 4 | 은행 | 뱅크스 4 | 뱅크스 4 | 여기서는 .csv 파일의 값이 우선합니다. |
제목 | 조니보이 | 조니보이 | .csv 가져오기에서는 Null 값이 사용되지 않습니다. C의 접점 값이 사용됩니다. | ||
인사말 | Mr | Mr | .csv 가져오기에서는 Null 값이 사용되지 않습니다. B 연락처의 값이 사용됩니다. | ||
작업 이메일 | Banks@gmail.com | Banks@gmail.com | .csv 가져오기에서는 Null 값이 사용되지 않습니다. B 연락처의 값이 사용됩니다. | ||
개인 이메일 | johnny@gmail.com | johnny@gmail.com | .csv 파일의 개인 이메일은 연락처 C의 다른 이메일과 일치합니다. .csv 파일의 값은 병합된 연락처 D의 개인 이메일에 사용됩니다. |
||
기타 이메일 | johnny@gmail.com |
.csv 파일의 개인 이메일은 연락처 C의 다른 이메일과 일치합니다. 이 시나리오에서는 병합된 연락처의 다른 이메일이 비어 있습니다. 개인 이메일은 이미 이 이메일 주소를 사용하므로 중복된 전화번호나 이메일 값은 저장되지 않습니다. |
|||
휴대전화 | +1 919 432-5523 |
.csv 형식의 직장 전화번호가 연락처 B의 휴대폰 번호와 일치합니다. 이 시나리오에서는 병합된 연락처의 휴대폰 번호가 비어 있는 이유는 직장 전화가 이미 이 전화번호 값을 가져왔고 중복된 전화번호나 이메일 값은 저장되지 않았기 때문입니다. |
|||
직장 전화 | +1 919 432-5523 | +1 919 432-5523 | .csv 형식의 직장 전화번호가 연락처 B의 휴대폰 번호와 일치합니다. | ||
홈 전화 | 업데이트가 없고, 연락해도 아무런 가치가 없습니다. | ||||
기타 전화 | 업데이트 없음, 연락처에 가치 없음 |