연락처 가져오기
기존 청중을 Kagibag으로 가져오세요. CSV 파일, HubSpot 내보내기 또는 API에서 연락처를 가져오면 시스템이 자동으로 필드 매핑, 중복 제거 및 신원 확인을 처리합니다.
가져오기 소스
| 소스 | 작동 방식 | 최고의 사용처 |
|---|---|---|
| CSV 업로드 | 모든 CSV 파일을 업로드하고 브라우저에서 연락처 필드에 열을 매핑합니다. | 일회성 가져오기 |
| HubSpot 내보내기 | HubSpot에서 내보낸 CSV를 업로드하세요. 열 헤더가 자동으로 감지되고 매핑됩니다. | HubSpot에서 마이그레이션 |
| API 가져오기 | MCP 서버 또는 REST API를 통해 JSON 형식으로 연락처를 전송합니다. | 자동 또는 반복 가져오기 |
CSV 가져오기 시작하기
관리자로 이동한 후, 연락처, 가져오기를 선택하세요. CSV 파일을 업로드합니다. 시스템이 파일 헤더를 읽고 열 매핑 화면을 표시합니다. 각 열은 표준 연락처 필드에 매핑되거나 건너뛸 수 있습니다. 가져오기를 클릭하여 처리를 시작합니다.
필드 매핑
매핑 가능한 표준 필드입니다. 열 별칭(예: "이메일 주소" 또는 "이름")이 자동으로 인식됩니다.
| 필드 | 필수 | 설명 |
|---|---|---|
| 이메일 | 예 | 연락처의 이메일 주소입니다 |
| 이름 | 아니요 | 이름 또는 주어진 이름 |
| 성 | 아니요 | 성 또는 가족 이름 |
| 회사 | 아니요 | 조직 또는 회사 이름 |
| 직함 | 아니요 | 직무 또는 역할 |
| 전화 | 아니요 | 전화번호 |
가져오기 처리
가져오기는 백그라운드에서 비동기적으로 실행됩니다. 각 행은 개별적으로 처리되므로 단일 잘못된 행이 나머지를 차단하지 않습니다.
| 상태 | 설명 |
|---|---|
| 업로드됨 | 파일 수신, 시작 대기 중입니다. |
| 구문 분석 중 | 시스템이 행을 읽고 검증하고 있습니다. |
| 처리 중 | 행이 일치하고, 중복 제거 및 보강되고 있습니다. |
| 처리됨 | 모든 행이 성공적으로 처리되었습니다. |
| 오류 | 하나 이상의 행이 실패했습니다 — 오류 세부정보를 검토하세요. |
신원 확인
가져온 각 이메일은 정규화(소문자 변환, 공백 제거)되고 기존 연락처와 비교됩니다. 일치하는 항목이 발견되면 기존 연락처 프로필이 새로운 정보로 업데이트됩니다. 일치하는 항목이 없으면 새로운 연락처 프로필이 생성됩니다. 이는 동일한 목록을 여러 번 가져올 때 중복을 방지합니다.
결과 검토하기
처리가 완료되면, 가져오기 요약에는 처리된 총 행 수, 기존 연락처와 일치한 수, 새 연락처로 생성된 수, 오류가 발생한 수가 표시됩니다. 개별 행을 클릭하여 오류 세부정보 또는 해결된 연락처 프로필을 확인하세요.
가져온 연락처 사용하기
가져온 후, 연락처는 Kagibag 전역에서 사용 가능합니다. 다음과 같이 활용하세요:
- 초대 전용 이벤트에 초대장 보내기
- 자동 마케팅 캠페인에 포함하기
- 대상 청중으로 세분화하기
연락처는 상호작용에서 추가 데이터로 시간이 지남에 따라 풍부해집니다.
API 가져오기
MCP 서버의 import_contacts 도구를 사용하여 프로그래밍 방식으로 연락처를 가져옵니다. 이메일, first_name, last_name, company 및 title 필드가 포함된 연락처 객체의 JSON 배열을 전송하세요. API는 가져오기 ID와 함께 202 응답을 반환합니다. 그 ID로 check_import_status를 폴링하여 진행 상황을 추적하세요.
[
{ "email": "[email protected]", "first_name": "Jane", "last_name": "Doe", "company": "Acme" },
{ "email": "[email protected]", "first_name": "John", "last_name": "Smith" }
]