Salesforce CRM과 연동하는 방법
학습 내용
Salesforce CRM을 Klaviyo와 연동하는 방법을 알아보세요. 이 연동을 사용하면 안내에 따라 앱 내 설정 플로우에서 Salesforce 계정을 연결하고, 동기화할 오브젝트를 선택하며, 필드를 매핑할 수 있어요.
이 연동을 사용하면 Klaviyo가 Salesforce 데이터(예: 리드 또는 연락처)를 Klaviyo 프로필로 자동 동기화해 CRM 데이터를 사용해 메시지를 개인화하고 고객을 세그먼트화할 수 있어요.
시작하기 전에 알아야 할 것
시작하기 전에, 다음 사항을 확인해 주세요:
- Salesforce 계정에 로그인되어 있어요.
- 비즈니스에 Salesforce 조직이 여러 개 있는 경우 올바른 조직에 로그인되어 있어요.
- Salesforce 계정에 대한 관리자 액세스 권한이 있어요.
Salesforce를 Klaviyo에 연결
- Klaviyo에 로그인하세요. 그런 다음 연동 탭을 선택하세요.
- 앱 둘러보기 를 클릭해 Klaviyo 앱 마켓플레이스를 여세요. Salesforce 앱 목록을 검색한 다음 여세요. 그런 다음 설치를 클릭합니다.
- Salesforce 연동 설정 플로우로 리디렉션돼요. 1단계에서 프로덕션 또는 샌드박스 Salesforce 조직에 연결할지 선택한 다음 Klaviyo Client 앱 설치
를 클릭하세요.

- Salesforce에서 설치 마법사를 따라 Klaviyo에 연결하려는 Salesforce 조직에서 “Klaviyo Salesforce OAuth Connector” 패키지를 확인하고 설치해 주세요.

- 설치가 완료되면 Klaviyo의 Salesforce 연동 설정 페이지로 돌아가세요. 그런 다음 2단계를 따라 Salesforce에 연결을 클릭하세요.

- 허용 을 클릭해 OAuth 플로우를 완료하고 Klaviyo를 Salesforce에 연결을 마무리해 주세요.

동기화할 Salesforce 개체를 선택해 주세요.
연결한 후 Klaviyo로 동기화할 Salesforce 개체를 선택하라는 안내가 표시돼요. 계속하려면 다음 을 클릭해 주세요.
이제 Klaviyo에 동기화할 최대 3개의 개체 를 선택할 수 있어요. 사용 가능한 옵션은 다음과 같아요:
- 리드 - Salesforce 제품 또는 서비스에 관심을 보인 잠재 고객
- 연락처 - Salesforce 조직의 계정과 연결된 개인
- 계정 - 비즈니스와 관련된 조직 또는 개인(예: 고객, 경쟁사, 파트너)입니다.
- Opportunity - 잠재적 판매 또는 거래
- 기타 (사용 중인 Salesforce 설정에 따라 사용 가능 여부가 달라요)
Salesforce에서 동기화된 객체는 Klaviyo 프로필로 생성되거나 업데이트돼요. 여러 객체를 동기화할 때:
- 선택한 모든 오브젝트의 레코드가 Klaviyo로 동기화돼요.
- 레코드의 이메일 주소가 기존 Klaviyo 프로필과 일치하면 해당 프로필이 업데이트돼요.
- 레코드의 이메일 주소가 Klaviyo에 없으면 새 프로필이 생성돼요.
- 동일한 이메일 주소로 동기화된 여러 객체에 동일한 사람이 존재하는 경우, Klaviyo는 이메일을 기준으로 해당 항목을 단일 프로필 로 통합해요. (필드 매핑은 다음 단계에서 객체별로 설정해요.)
Salesforce 필드를 Klaviyo 속성에 매핑하기
다음으로 Salesforce 필드를 Klaviyo 프로필 속성에 매핑할 거예요. 이메일, 전화번호, 이름, 성 같은 일부 핵심 매핑은 미리 매핑되어 있어요. Salesforce 이메일 주소 매핑은 필수예요.
동기화할 Salesforce 객체를 여러 개 선택한 경우 각 객체별로 별도로 필드 매핑을 구성하세요. 이렇게 하면 각 객체의 어떤 필드가 Klaviyo 프로필 속성이 될지 제어할 수 있어요.
매핑 추가 또는 편집
- 현재 선택된 객체 에 대해 추가 Salesforce 필드를 매핑하려면 매핑 추가 를 사용해 주세요.
- 왼쪽에서 Salesforce 필드를 선택하고 오른쪽에서 해당 Klaviyo 속성을 선택해 주세요.
- 필요한 경우 휴지통 아이콘 을 사용해 매핑을 삭제해 주세요.
- 동기화된 각 객체에 대해 이 과정을 반복해 주세요.
동일한 Klaviyo 프로필 속성(예: 전화번호 또는 도시)이 여러 Salesforce 객체에서 매핑된 경우, Klaviyo는 Salesforce에서 가장 최근에 업데이트된 값을 프로필에 동기화해요.
CSV를 통해 매핑을 가져오기(선택 사항)
CSV 가져오기를 하면 선택한 객체의 기존 필드 매핑이 모두 대체돼요. 파일에 포함되지 않은 필드는 구성에서 제거돼요. 동기화 중단을 방지하려면 CSV에 필수 필드(예: 이메일)와 계속 동기화하려는 추가 필드가 모두 포함되어 있는지 확인해 주세요.
CSV를 통해 매핑을 가져오려면:
- 매핑 추가 → 매핑 가져오기를 클릭하세요.
- CSV 템플릿을 다운로드해 주세요.
- Salesforce → Klaviyo 필드 매핑을 CSV 템플릿에 추가해 주세요.
- 완료된 CSV를 업로드하여 매핑을 일괄 적용하세요.
구독 취소 처리(선택 사항)
Salesforce 객체에서 Email Opt Out이 true로 설정되면 Salesforce 객체를 구독 취소로 동기화하는 옵션을 활성화할 수 있어요. 그러면 Klaviyo에서 해당 프로필이 이메일 구독 취소로 표시돼요.
설정 완료
매핑이 완료되면 설정 완료를 클릭해 주세요. Klaviyo가 연동을 최종 처리해요(보통 몇 초 정도 걸려요). Salesforce 계정이 성공적으로 연결되고 동기화되면 확인 메시지가 표시돼요.
Salesforce 동기화를 모니터링하고 데이터를 확인하기
Salesforce 연동은 1시간마다 Klaviyo로 동기화돼요.
연동을 확인하려면:
- Klaviyo에서 분석 드롭다운을 클릭하고 지표를 선택하세요. Salesforce로 필터링한 다음 리드가 됨 지표를 찾아 활동 피드 아이콘을 클릭하세요.
- 연동에서 데이터 동기화가 시작되면 이 활동 피드에 Salesforce 아이콘이 있는 리드가 됨 이벤트가 추가된 것을 볼 수 있어요.
- Klaviyo는 Salesforce 리드를 모두 가져옵니다. 이를 확인하려면 특정 날짜에 Klaviyo에 추가되는 리드 수와 Salesforce에 추가되는 리드 수를 비교해 일치하는지 확인하세요.
- 어제 결제가 몇 건 발생했는지 확인하고 Salesforce에 데이터 스토어된 데이터와 비교하려면, 지표를 클릭해 찾을 수 있는 리드가 됨 활동 피드에서 어제의 데이터포인트에 마우스를 올리거나 차트 아래의 데이터 표를 확인하세요.
- 데이터가 일치하지 않으면 Klaviyo 계정의 시간대가 Salesforce 계정의 시간대와 일치하지 않는 것이 가장 흔한 원인입니다. Klaviyo에서 시간대 설정을 확인하는 방법:
- 왼쪽 하단에서 계정 이름을 클릭합니다.
- 설정 > 조직을 클릭한 다음 선택하세요.
- 시간대까지 아래로 스크롤하세요.
Klaviyo의 Salesforce 지표
현재 Klaviyo는 Salesforce CRM과 리드가 됨이라는 지표 1개를 동기화해요.
이 지표는 Salesforce에서 새 리드가 생성될 때 추적됩니다. 이 이벤트 자체에는 Salesforce의 데이터가 포함되지 않지만, 이 이벤트가 기록되면 Klaviyo는 각 리드에 대해 다음 사용자 지정 속성을 동기화하고 리드의 Klaviyo 프로필에 첨부합니다:
- ID
- 이름
- 성
- 직위
- 회사
- 거리명
- 도시
- 상태
- 우편 번호
- 국가
- 위도
- 경도
- 전화
- 이메일
- 웹사이트
- LeadSource
- 상태
- 산업
- NumberOfEmployees
- HasOptedOutOfEmail
- 소유자 이메일
그런 다음 이러한 속성을 세그먼트, 플로우에서 사용하고, 메시지 템플릿에 고객 속성을 동적으로 채우는 데 사용할 수 있어요.
문제 해결
설치 및 인증 문제
기본 인증에서 OAuth로 마이그레이션
OAuth가 지원되기 전에 Salesforce 연동을 설정했다면, Salesforce 애플리케이션이 기본 인증을 사용해 Klaviyo에 연결되어 있을 수 있습니다.
기존 기본 인증 연결은 자격 증명이 만료될 때까지 계속 작동해요. 하지만 해당 자격 증명이 만료되면 재설정하거나 갱신할 수 없어요. Salesforce 연동을 Klaviyo에 계속 연결해 두려면 OAuth로 마이그레이션해야 해요.
- Klaviyo에 연결된 Salesforce 조직에 로그인해 주세요.
- Klaviyo 포털에서 Salesforce 연동 설정 페이지로 이동하세요. 페이지 상단에 “OAuth 인증이 이제 필요합니다.”라고 표시된 배너가 있어야 합니다. 배너 설명에서 “external Klaviyo app”이라고 표시된 하이퍼링크를 클릭해 Salesforce 조직에 “Klaviyo Salesforce OAuth Connector” 패키지를 설치하세요.

- 설치가 완료되면 Salesforce 연동 설정 페이지 로 돌아가 업데이트를 클릭하세요. 그런 다음 OAuth 플로우를 완료하세요.

자세한 내용은 이 가이드 상단의 “Salesforce를 Klaviyo에 연결” 섹션을 참고해 주세요.
오류 “외부 Klaviyo 앱이 설치되어 있지 않습니다. 설치한 후 다시 시도하세요”
이 오류는 인증(또는 재인증)하려는 Salesforce Org에 “Klaviyo Salesforce OAuth Connector” 패키지가 설치되어 있지 않음을 나타내요.
다음을 확인해 주세요:
- Salesforce에 로그인되어 있어요.
- Klaviyo와 연동된 Salesforce 조직에 로그인되어 있습니다. 비즈니스에 Salesforce 조직이 여러 개 있는 경우, 잘못된 조직에 로그인되어 있을 수 있습니다.
- 올바른 Salesforce 조직에 로그인되어 있는데도 이 오류가 계속 발생한다면, Salesforce에서 설치된 패키지를 검색해 “Klaviyo Salesforce OAuth Connector” 패키지가 설치되어 있는지 확인해 주세요. 설치되어 있지 않다면, 연동 설정 플로우에서 1단계를 다시 진행해 패키지를 설치해 주세요(이 가이드 상단의 “Salesforce를 Klaviyo에 연결” 섹션 참고). 또는 기존 연동이 있고 OAuth로 마이그레이션하는 경우, 하이퍼링크된 “external Klaviyo App” 텍스트를 클릭해 패키지를 설치해 주세요(위의 “OAuth로 마이그레이션” 섹션 참고).

그래도 문제가 계속 발생하면 지원 팀에 문의하세요.
계정 불일치 오류 메시지
비즈니스에서 여러 Salesforce 조직을 사용하는 경우, 연동을 다시 인증할 때 현재 Klaviyo에 연결된 Salesforce 조직에 로그인되어 있는지 확인해 주세요.
다른 Salesforce 조직에 로그인되어 있으면 “계정 불일치” 오류가 표시돼요:

오류를 해결하려면 다음 중 하나를 수행해 주세요:
- 기존 Salesforce 조직 다시 연결: 창을 닫고 Salesforce에서 로그아웃한 다음, 현재 Klaviyo에 연결된 Salesforce 조직에 로그인하고 다시 시도해 주세요.
- 다른 Salesforce 조직을 연결: Klaviyo에서 Salesforce 연동을 제거한 다음 다시 설치하고, 새 Salesforce 조직을 사용하여 Salesforce 연동 설정 플로우를 완료하세요.
필드 매핑 경고 및 오류
Klaviyo는 데이터가 안정적으로 동기화될 수 있도록 Salesforce 필드 매핑을 지속적으로 검증해요. 매핑된 Salesforce 필드를 사용할 수 없게 되면(예: 삭제, 이름 변경, 또는 권한 변경) 연동 설정에서 경고 또는 오류가 표시될 수 있어요.
필수가 아닌 필드를 사용할 수 없을 때
매핑된 Salesforce 필드를 더 이상 사용할 수 없고 필수 항목이 아니라면 Klaviyo는 다음을 수행해요:
- 누락된 필드가 무엇인지 표시하는 경고를 표시해 주세요.
- 사용 가능한 다른 모든 필드 동기화를 계속하세요.
- 사용할 수 없는 필드는 업데이트되거나 제거될 때까지 이후 동기화에서 제외해 주세요.
이를 해결하려면,
- Klaviyo에서 Salesforce 연동 으로 이동해 주세요.
- 영향을 받는 객체를 여세요.
- 유효하지 않은 필드 매핑을 업데이트하거나 제거해 주세요.
- 변경 사항을 저장 해 주세요.
업데이트가 완료되면 동기화가 예상대로 계속 진행돼요.
필수 필드(이메일)를 사용할 수 없을 때
Salesforce 이메일 필드를 더 이상 객체에서 사용할 수 없는 경우(예: 스키마 변경 또는 권한 때문에) Klaviyo에서는 다음을 수행해요:
- 이메일 필드가 누락되었다는 오류를 표시하세요.
- 영향을 받는 개체에 대한 데이터 동기화를 중지하세요.
- 동기화를 복원하려면 필드 매핑을 업데이트하라는 메시지가 표시돼요.
이를 해결하려면,
- Klaviyo에서 Salesforce 연동 으로 이동해 주세요.
- 영향을 받는 객체를 여세요.
- 유효한 Salesforce 이메일 필드가 Klaviyo의 이메일 속성에 매핑되어 있는지 확인해 주세요.
- 변경 사항을 저장 해 주세요.
Email 필드가 다시 성공적으로 매핑되면, 데이터 동기화가 자동으로 재개돼요.
Klaviyo에서 프로필이 누락됨
Salesforce 레코드가 Klaviyo에서 프로필로 표시되지 않는 경우, 먼저 동기화하는 각 객체에 대해 유효한 이메일 필드가 매핑되어 있는지 확인해 주세요. Klaviyo는 이메일 주소를 프로필을 생성하거나 업데이트하기 위한 필수 식별자로 사용하므로, 이메일 필드가 매핑되지 않았거나 유효한 이메일 값이 없는 레코드는 프로필로 동기화되지 않아요. 다음 사항을 확인해 주세요:
- Salesforce 이메일 필드는 선택한 모든 객체에 대해 Klaviyo의 이메일 속성에 매핑됩니다.
- 매핑된 이메일 필드에는 Salesforce의 실제 이메일 값이 포함되어 있어요. 비어 있거나 유효하지 않은 이메일은 레코드가 프로필로 동기화되는 것을 방해할 수 있어요.
유효한 이메일 필드가 매핑되어 있고 레코드에 이메일 주소가 포함되어 있으면 Klaviyo가 다음 동기화 시 해당 프로필을 생성하거나 업데이트해요.
결과
이제 Klaviyo 계정을 Salesforce CRM과 통합하고 동기화된 데이터를 검토했어요.