작업 공간을 Example CRM에 연결하여 연락처, 회사 및 거래 데이터를 자동으로 동기화하세요. 이 가이드는 통합 활성화, 동기화 설정 구성 및 일반 문제 해결 방법을 안내합니다.
시작하기 전에
통합을 켜기 전에 다음 사항을 확인하세요:
요구 사항 | 세부 정보 |
관리자 권한 | 통합을 활성화하려면 작업 공간 관리자 또는 소유자여야 합니다. |
Example CRM 계정 | 팀 플랜 이상에서 활성 계정 |
API 액세스 활성화 | Example CRM의 설정 > 개발자 > API 액세스에서 켜져 있어야 합니다. |
도메인 인증 | 이메일 활동을 동기화하려면 발신 도메인이 인증되어야 합니다. |
데이터 매핑 계획 | 중복을 방지하려면 첫 동기화 전에 어떤 필드를 매핑할지 결정하세요. |
1단계: 통합 위치 찾기
설정 > 통합으로 이동하세요.
통합 디렉터리에서 "Example CRM"을 검색하세요.
연결을 클릭하세요.
요청 시 Example CRM 자격 증명으로 로그인하세요.
요청된 권한을 승인하세요.
2단계: 동기화할 항목 선택
연결되면 동기화할 객체를 선택하라는 메시지가 표시됩니다. 각 객체 유형은 동기화 동작과 새로 고침 간격이 다릅니다.
객체 | 동기화 방향 | 기본 새로 고침 간격 | 참고 |
연락처 | 양방향 | 5분 | 기본적으로 이메일 주소로 매칭됨 |
회사 | 양방향 | 15분 | 도메인 이름으로 매칭됨 |
거래 / 기회 | 단방향 (CRM에서 앱으로) | 15분 | 고급 동기화가 활성화되지 않으면 읽기 전용 |
참고 | 단방향 (앱에서 CRM으로) | 실시간 | "공유 가능" 태그가 붙은 노트만 동기화됨 |
작업 | 양방향 | 10분 | 작업 동기화 애드온 필요 |
사용자 지정 객체 | 구성 가능 | 구성 가능 | 엔터프라이즈 플랜에서만 사용 가능 |
3단계: 필드 매핑 구성
필드 매핑은 시스템 간 데이터 정렬 방식을 결정합니다. 잘못된 매핑은 중복 또는 누락 기록의 가장 흔한 원인입니다.
소스 필드 (예: CRM) | 대상 필드 | 데이터 유형 | 필수 |
| 이름 | 텍스트 | 예 |
| 성 | 텍스트 | 예 |
| 기본 이메일 | 이메일 | 예 |
| 전화번호 | 전화 | 아니요 |
| 담당자 | 참조 | 아니요 |
| 라이프사이클 단계 | 열거형 | 아니요 |
| 거래 금액 | 통화 | 아니요 |
| 마지막 활동 날짜 | 날짜 | 아니요 |
| (매핑되지 않음) | 텍스트 | 아니요 |
통합 > 예제 CRM > 필드 매핑에서 사용자 지정 매핑을 추가할 수 있습니다. 매핑되지 않은 필드는 동기화 중 무시되지만 향후 매핑에 사용할 수 있습니다.
4단계: 동기화 규칙 설정
동기화 규칙은 시스템 간 데이터 흐름을 제어하여 원치 않는 덮어쓰기를 방지합니다.
규칙 | 활성화 시 동작 | 비활성화 시 동작 |
충돌 시 덮어쓰기 | 가장 최근에 업데이트된 레코드가 우선 | 기존 앱 데이터는 절대 덮어쓰지 않음 |
삭제된 레코드 동기화 | 한 시스템에서 삭제하면 양쪽 모두 삭제됨 | 삭제는 두 시스템에서 수동으로 해야 함 |
중복 연락처 병합 | 이메일 일치 시 자동 병합 | 중복은 수동 검토용으로 표시됨 |
과거 데이터 동기화 | 첫 동기화 시 최대 24개월의 기록을 채움 | 앞으로는 새 활동만 동기화됨 |
팀별 제한 | 선택한 팀이 소유한 레코드만 동기화 | 소유권과 관계없이 모든 레코드 동기화 |
5단계: 통합 활성화
객체 선택, 필드 매핑, 동기화 규칙을 검토하세요.
동기화 활성화를 클릭하세요.
초기 동기화는 데이터 양에 따라 몇 분에서 몇 시간까지 걸릴 수 있습니다.
첫 동기화 완료 시 알림을 받게 됩니다.
동기화 상태 참조
상태 | 의미 | 조치 필요 |
활성 | 동기화가 정상적으로 실행 중입니다. | 없음 |
일시 중지됨 | 관리자가 수동으로 동기화를 일시 중지함 | 통합 설정에서 다시 시작 |
오류 – 인증 | API 자격 증명이 만료되었거나 취소됨 | 통합을 다시 연결하세요. |
오류 – 요청 제한 | Example CRM에 너무 많은 요청이 전송됨 | 자동 재시도를 기다리거나 지원팀에 문의하세요. |
오류 – 매핑 충돌 | 필수 필드가 매핑되지 않았거나 일치하지 않음 | 필드 매핑 설정을 검토하세요. |
부분 완료 | 일부 객체는 동기화되었으나 일부는 실패함 | 자세한 내용은 동기화 로그를 확인하세요. |
일반 문제
연락처가 동기화되지 않음 연락처에 유효하고 중복되지 않은 이메일 주소가 있는지 확인하세요. 이메일 주소가 없는 연락처는 기본적으로 건너뜁니다.
중복 회사가 나타남 보통 회사 매칭이 도메인 대신 이름에 의존할 때 발생합니다. 필드 매핑으로 이동하여 기존 레코드에 도메인 필드가 채워져 있는지 확인하세요.
동기화가 "초기화 중"에 멈춤 대규모 계정(50,000개 이상 레코드)은 첫 동기화에 몇 시간이 걸릴 수 있습니다. 12시간 이상 지났다면 작업 공간 ID와 함께 지원팀에 문의하세요.
동기화 후 일부 필드가 빈칸으로 표시됨 3단계에서 필드가 매핑되었는지 확인하세요. 매핑되지 않은 필드는 소스 데이터와 관계없이 항상 빈칸으로 표시됩니다.
통합 비활성화
설정 > 통합 > Example CRM으로 이동하세요.
연결 끊기를 클릭하세요.
이전에 동기화된 데이터를 유지할지 삭제할지 선택하세요.
연결 끊기를 확인하세요.
연결을 끊어도 명시적으로 선택하지 않는 한 이미 동기화된 기록은 삭제되지 않습니다.
관련 문서
Example CRM에서 API 액세스 설정하기
중복 기록 관리하기
동기화 로그 및 오류 코드 이해하기
고급 동기화 애드온 개요
목차
