CSV 형식으로 목록 만들기

쉼표로 구분된 값(.csv) 형식으로 기록을 업로드하여 목록을 만듭니다. 업로드하거나 목록에 추가하기 전에 UTF-8로 인코딩된 .csv 구문을 준수하려는 데이터 형식을 지정합니다.

  • 각 레코드는 줄 바꿈(LF)이나 캐리지 리턴 줄 바꿈(CRLF) 쌍으로 종료되는 한 줄입니다.
  • 열 이름에는 백슬래시(\)와 같은 특수 문자를 사용할 수 없습니다.
  • 쉼표를 사용하여 필드라고 불리는 데이터 항목을 구분합니다.
  • 첫 번째 줄은 쉼표로 구분된 필드 이름의 헤더 행이어야 합니다.
  • 공백이나 쉼표가 포함된 필드는 큰따옴표로 묶습니다.
  • 앞뒤에 공백이 포함된 문자열은 큰따옴표로 묶습니다.
  • 필드가 비어 있으면 레코드의 해당 위치에 쉼표를 삽입하십시오.
  • 큰따옴표 문자 쌍 안에 쉼표가 포함된 필드를 묶습니다. 예: "이름, 성","전화번호","주소".
  • 필드에 큰따옴표가 포함된 경우 전체 필드를 큰따옴표로 묶고 각 큰따옴표 문자를 두 개의 큰따옴표 문자로 변환합니다.
  • 중요 참고 사항 : .csv 파일에는 데이터 끝에 빈 행이 포함되어서는 안 됩니다. 빈 행이 포함되어 있으면 가져오기가 실패할 수 있습니다.

필수 열

최소한 .csv 파일에는 전화번호 열이 한 개 포함되어야 합니다. 예를 들어, 연락 거부 목록의 단일 열은 다음과 같습니다.

핸드폰
317-123-4567
….
메모 : 앞에 오는 더하기 기호를 제외한 서식 문자는 무시됩니다. E.164 형식의 숫자입니다.

연락처 이름, 계정 코드 등 .csv 파일에 필요한 모든 열을 정의합니다. .csv 파일을 업로드하여 새 목록을 만들면 시스템은 클라우드에 일치하는 열이 포함된 테이블을 만듭니다. 이 테이블이 생성된 후에는 다른 열 집합이 포함된 데이터를 추가할 수 없습니다. 

50열을 초과하지 마십시오.

연락처 목록에 허용되는 최대 열 수는 50개입니다. 새로운 연락처 목록이 해당 제한을 초과하는 경우 오류 메시지가 나타나지만 이벤트 뷰어에 해당 항목이 나타나지 않습니다.

규칙 이름은 고유해야 합니다.

첫 번째 행의 모든 열 이름은 고유해야 합니다. 열 이름을 복제하면 파일을 가져올 수 없습니다.

고유 식별자 열 포함

각 행을 고유하게 식별하는 열을 .csv 파일에 포함합니다. 이렇게 하면 나중에 새 데이터나 업데이트된 데이터를 정확하게 추가할 수 있습니다. 일반적인 고유 식별자는 고객의 ID 또는 계정 번호입니다. 나중에 당신이 레코드 추가 연락처 목록에서 고유 식별자 열을 선택합니다. 해당 열을 사용하면 추가 프로세스에서 들어오는 데이터를 기존 연락처와 가장 정확하게 일치시킬 수 있습니다.

고유 식별자가 없으면 전체 행이 기본 키가 됩니다. 수정된 레코드를 추가하면 기존 행에 동일한 식별자가 있더라도 후속 업로드에서 해당 레코드를 새 행으로 추가합니다. 이런 동작은 사람들이 목록을 내보내고, 변경한 다음 데이터를 추가하고 업로드할 때 기대하는 동작이 아닙니다. 고유 식별자를 사용하면 시스템이 기존 레코드를 대체합니다.

고유 식별자에 특수 문자를 사용하지 마십시오.

영숫자로 고유 식별자를 작성합니다. 공백, 백슬래시 및 다음과 같은 특수 문자는 URL에 사용할 수 없습니다.

– . _ ~ : / ? # [ ] @ ! $ & ‘ ( ) * + , ; =

영역 열 사용

Contact list records often store multiple phone numbers per contact, such as work, cell, and home numbers. To use the callable times feature, each phone number column must have a corresponding time zone name column which contains the name you previously configured for callable time entries in the contactable time set in Genesys Cloud. For example, a column named Home Time Zone to contain the time zone name corresponding to each number in the Home Phone column. Note that zone columns are not used in Do Not Contact lists.

  • 연락처 목록을 만들 때 각 전화번호 열(예: 집 또는 직장)에 해당하는 고유한 ID와 시간대 이름 열을 모두 지정하는 것이 가장 좋습니다.
  • 나중에 시간대 이름 열을 추가할 수는 없지만 동일한 고유 ID를 가진 레코드를 추가(업로드)하여 기존 시간대 이름 열을 채우거나 업데이트할 수 있습니다. Genesys Cloud는 일치하는 행을 찾으면 추가 파일의 데이터를 사용하여 열을 업데이트합니다. 예를 들어, 시스템은 .csv 파일에서 읽은 시간대 데이터로 레코드의 모든 구역 이름 열을 업데이트합니다. 영역 이름 열이 있어야 합니다.
  • Associate each time zone name column with a contact number column when you create a list. You can also edit the contact list later, and map its time zone columns to phone number columns by selecting from the time zone column dropdown list.

선행 및 후행 공백을 제거하지 마십시오

연락처 목록을 저장하면 연락처 목록의 연락처 필드에서 앞뒤 공백이 제거됩니다. 연락처 목록에서 공백을 제거하지 않으려면 선행/후행 공백 제거 토글을 다음으로 전환합니다. 아니요 .

스프레드시트 프로그램을 사용하여 .csv 파일을 편집합니다.

텍스트 편집기가 아닌 스프레드시트 프로그램에서 CSV 형식으로 저장하는 것이 좋습니다. 스프레드시트가 .csv 파일을 저장할 때 필요한 따옴표와 쉼표를 자동으로 삽입합니다. 스프레드시트를 사용하면 수동으로 기록을 서식 지정하는 것보다 오류가 발생할 가능성이 적습니다.

이름 집 전화 홈 시간대 휴대폰 셀 시간대 차감 부족액 계정 코드 HomeAddress
암사슴 제임스 "빅 존" 317-123-4567 America/Indiana/Indianapolis 317-987-6543 America/Indiana/Indianapolis 175 1003 123 Anystreet, Indianapolis, IN
다우닝 메리 424-999-2334 America/Los_Angeles 234 3799 724 Bel Air Drive, 로스앤젤레스, 캘리포니아

예를 들어, 파일 > 다른 이름으로 저장 > CSV(쉼표로 구분) Microsoft Excel의 명령은 다음 .csv 레코드를 생성합니다.

성, 이름, 집 전화, 집 시간대, 휴대전화, 휴대전화 시간대, 미지급 잔액, 계정 코드, 집 주소
Doe,”James “”Big John”””,317-123-4567, America/Indiana/Indianapolis,317-987-6543, America/Indiana/Indianapolis,175,1003,”123 Anystreet, Indianapolis, IN”
Downing,Mary,424-999-2334,America/Los_Angeles,,,234,3799,”724 Bel Air Drive, Los Angeles, CA”
메모 : SMS 캠페인을 위한 CSV 목록을 만들 때 스프레드시트 프로그램으로 Excel을 사용하는 경우 전화번호 열은 E.164 형식이어야 합니다. 전화번호 열의 경우 +# ?/? 숫자 형식 코드와 함께 Excel 맞춤 형식을 사용합니다. 사용자 지정 서식을 지정하지 않으면 Excel 기본 서식이 제거됩니다. 접두사.