Salesforce 연동 기능을 통해, 데이터스페이스에서 수집한 데이터를 Salesforce의 리드(Lead) 또는 연락처(Contact) 페이지로 직접 전송할 수 있습니다.
본 기능은 Add-on(추가 기능)으로, Enterprise 플랜 사용자에 한해 별도 구매 후 이용 가능합니다.
데이터스페이스에 Salesforce 계정 연동하기
Salesforce로 데이터를 전송하기 위해선, 먼저 데이터스페이스에 Salesforce 계정을 연동해야 합니다.
1) 데이터스페이스 홈 화면 좌측 메뉴에서 ‘설정> 연동>앱 & 소프트웨어> Salesforce [연동하기]’를 차례로 선택해 주세요.
📌 꼭 알아두세요!
Salesforce [연동하기] 버튼은 해당 스페이스에 연결된 계정이 없는 경우에만 노출됩니다.
이미 다른 멤버가 계정을 연동해둔 경우에는, '앱 & 소프트웨어' 화면에서 ‘Salesforce [연동 관리]’를 클릭한 뒤, 중앙의 멤버 목록 우측에 있는 [내 계정 연동하기]를 선택해 주세요.
2) [연동하기] 버튼을 클릭하면 Salesforce 로그인 화면이 나타납니다. Salesforce 사용자 이름과 비밀번호를 입력한 후, [로그인] 버튼을 눌러주세요.
Salesforce 계정 연동을 위한 에디션 제한은 없지만, 아래와 같은 권한이 필요합니다.
권한 설정은 Salesforce 관리자 페이지에서 확인해 주세요.
API 사용 권한(API Enabled)
리드 또는 연락처 객체에 대한 최소 '조회(Read)' 권한
또한, 첫 연동은 가급적 Salesforce 시스템 관리자(System Administrator)의 계정으로 진행하실 것을 권장해 드립니다.
시스템 관리자가 아니어도 연동은 가능하지만, 데이터스페이스 데이터가 저장될 Salesforce 개체(Object)를 생성하고, 해당 개체를 리드 및 연락처 페이지 레이아웃에 노출하기 위해 시스템 관리자의 지원이 필요할 수 있습니다.
보다 자세한 내용은 Salesforce로 데이터스페이스 데이터 내보내기를 참고해 주세요.
3) 연동을 위해 로그인 후 액세스 권한을 허용해 주세요.
4) 연동이 성공적으로 완료되면 ‘연동을 완료하였습니다.’라는 메시지와 함께 Salesforce 연동 관리 페이지로 자동 이동합니다.
🤔 계정 연동에 실패하셨나요?
계정 연동은 다음과 같은 이유로 실패할 수 있습니다.
◾Salesforce 계정 및 권한 문제
1) Salesforce 계정이 유효한지, API 사용 가능 권한이 활성화되어 있는지, 리드 혹은 연락처 개체에 대해 최소 조회(Read) 권한이 부여되어 있는지 확인해 주세요.
2) 계정에 IP 제한이 설정되어 있는지 확인해 주세요. IP 제한이 적용된 경우, 연동 작업을 원활히 진행하기 위해 아래 IP 주소를 ‘로그인 IP 범위’에 추가해야 합니다.
IP 주소: 52.79.102.134
IP 시작 주소와 IP 끝 주소 모두에 52.79.102.134를 입력해 주세요.
◾네트워크 불안정 및 기타 오류
네트워크 상태가 불안정하거나 로그인 화면을 장시간 유지했거나 기타 오류로 인해 연동이 실패할 수 있으니, 네트워크 상태를 확인한 후 다시 시도해 주세요.
동일한 문제가 지속되면 헬프센터로 문의해 주시기 바랍니다.
매칭ID(리드ID 혹은 연락처ID)가 포함된 설문 준비하기
계정 연동이 성공적으로 완료되면, 리드 또는 연락처를 대상으로 수집한 데이터를 Salesforce로 전송할 수 있습니다.
단, 데이터 내에 반드시 매칭ID(리드 ID 또는 연락처 ID)가 포함되어야 하며, 매칭 ID를 포함하려면, 설문 진행 시 파라미터를 활용하여 함께 수집하는 방법이 가장 효율적입니다.
파라미터에 대한 자세한 내용은 아래 참고 문서를 확인해 주세요.
📄 참고 문서: URL 파라미터 포함한 응답 링크 활용하기
Salesforce로 데이터스페이스 데이터 내보내기
매칭 ID가 포함된 설문을 준비한 후, 아래 절차에 따라 내보내기를 진행합니다.
내보내기는 데이터 종류(직접 생성 설문 또는 임포트된 데이터)나 수집 그룹의 상태(수집 중, 일시 중지, 종료)에 관계없이, 응답이 1건 이상 수집된 설문이라면 모두 진행할 수 있습니다.
1) 다음 경로 중 하나를 이용해 [Salesforce로 데이터 내보내기] 버튼을 클릭합니다.
◾홈 또는 프로젝트 화면에서 내보내기 실행
① 데이터스페이스 홈 화면 또는 프로젝트 화면에서 내보내고자 하는 설문의 [추가 작업(⦙)] 버튼을 클릭합니다.(※마우스 우클릭으로도 동일 메뉴에 진입할 수 있습니다.)
② 이후 '응답 내보내기> Salesforce'를 순서대로 선택합니다.
◾분석 화면에서 내보내기 실행
① 내보내고자 하는 설문을 선택한 후 [분석으로 이동]을 클릭합니다.
② 분석 화면 오른쪽 상단의 '내보내기> Salesforce로 내보내기> 내보내기 버튼 '을 눌러 전송을 완료합니다.
2) 내보내기를 처음 진행하는 경우, 데이터스페이스 데이터를 전송할 Salesforce 개체를 생성해야 합니다. 이 작업은 최초 1회만 수행되며, 개체가 정상적으로 생성된 이후에는 별도의 추가 설정 없이 곧바로 데이터 전송이 가능합니다.
◾Salesforce 시스템 관리자 계정으로 연동한 경우
① [오브젝트 생성] 버튼을 클릭합니다.
② 버튼을 클릭하면 Salesforce에 Dataspace Data 오브젝트가 생성됩니다.
③ Dataspace Data 오브젝트에는 다음과 같은 필드가 생성됩니다.
Salesforce 필드 레이블 | 데이터스페이스에서 전송되는 정보 |
Answer ID | 응답 ID(예: id_12345678) |
Survey Name | 설문 제목(예: 2025 웨비나 만족도 조사) |
Survey ID | 설문 ID(예: a01hm5zy7d643avvvktd6j6sd2x) |
Variable Name | 변수 이름(예: Q2) |
Variable Label | 변수 라벨(예: 2025 웨비나에서 어떤 점이 가장 만족스러우셨나요?) |
Value | Value(예: 이해하기 쉽고 업무에 직접적으로 도움을 받았습니다) |
Finished At | Finished_At(예: 2025-05-05) |
Variable Type | Variable_Type(예: Text) |
External ID | 연동을 위한 자동 생성ID |
📌 꼭 확인해 주세요!
생성된 Dataspace Data 오브젝트와 오브젝트에 포함된 필드 설정은 변경하지 마세요. 설정을 임의로 수정할 경우, 데이터 내보내기 기능이 정상적으로 작동하지 않을 수 있습니다. 단, 오브젝트 및 필드의 레이블(Label)은 자유롭게 수정하실 수 있습니다.
④ 생성된 Dataspace Data 오브젝트에 데이터를 내보내기 위해선, 연동한 Salesforce 계정에 권한 집합 할당이 필요합니다. 권한을 부여할 Salesforce 계정에 ‘Dataspace Integration Access’ 권한 집합을 할당해 주세요. 이 권한 집합에는 다음과 같은 권한이 포함됩니다.
Dataspace Data 오브젝트 접근 권한(조회/생성/수정/타인의 레코드 조회 및 수정 가능)
외부 API 통신을 위한 API 사용 권한
📌 꼭 확인해 주세요!
권한 집합은 Salesforce 시스템 관리자에게도 자동으로 할당되지 않습니다. Dataspace Data 오브젝트를 관리하거나 레이아웃을 설정하려면, 시스템 관리자 본인에게도 반드시 ‘Dataspace Integration Access’ 권한 집합을 할당한 후 다음 단계로 진행해 주세요.
⑤ 마지막으로, 생성된 Dataspace Data 오브젝트를 리드 및 연락처 페이지에 노출하기 위해 레이아웃을 설정합니다. Dataspace Data 오브젝트를 노출할 레이아웃을 선택한 후 [적용] 버튼을 눌러 설정을 완료해 주세요.
이 단계는 생략 가능하지만, 생략할 경우 Salesforce 내에서 수동으로 레이아웃을 업데이트해야만 Dataspace Data 오브젝트를 확인할 수 있습니다.
⑥ 선택한 레이아웃이 정확한지 다시 한 번 확인해 주세요. [설정] 버튼을 클릭하면, 해당 Salesforce 레이아웃에 Dataspace Data 오브젝트가 표시됩니다.
◾Salesforce 시스템 관리자 계정으로 연동하지 않은 경우
1) Salesforce 시스템 관리자에게 Dataspace Data 오브젝트 생성 및 권한 할당을 요청해 주세요.
시스템 관리자가 데이터스페이스에 가입하지 않더라도, Salesforce 내에서 직접 사용자 정의 개체를 생성하고, 권한을 부여하면 데이터스페이스를 통해 내보내기를 진행할 수 있습니다. 아래 가이드를 시스템 관리자에게 공유해 주세요.
✅ 사용자 정의 개체(Custom Object) 설정
◾사용자 정의 개체 정보
레이블(Label): Dataspace Data
개체 이름(Object Name): Dataspace_Data
◾레코드 이름 레이블 및 형식 입력
레코드 이름(Record Name): Answer ID
데이터 유형(Data Type): 텍스트
◾개체 분류: 대량 API 액세스 허용(Allow Bulk API Access) 활성화
◾배포 상태: 배포됨(Deployed) 선택
✅ Dataspace Data 오브젝트 내 필드 설정
필드 레이블 | 필드 이름 | 데이터 유형 | 추가 설정 |
Survey Name | Survey_Name | 텍스트(Text) | 최대 글자 수 255자 |
Survey ID | Survey_ID | 텍스트(Text) | 최대 글자 수 255자 |
Variable Name | Variable_Name | 텍스트(Text) | 최대 글자 수 255자 |
Variable Label | Variable_Label | 긴 텍스트 영역(Text Area(Long)) | 최대 글자 수 131,072자 |
Value | Value | 긴 텍스트 영역(Text Area(Long)) | 최대 글자 수 131,072자 |
Finished At | Finished_At | 날짜/시간(Date/Time) |
|
Variable Type | Variable_Type | 텍스트(Text) | 최대 글자 수 255자 |
External ID | External_ID | 텍스트(Text) | 최대 글자 수 255자 -외부 ID(External ID) -고유하며 대/소문자 구분함(Unique Case Sensitive) |
Lead ID | Lead_ID | 조회 관계(리드) | 리드를 조회하도록 조회 관계 생성(Lookup(Lead)) |
Contact ID | Contact_ID | 조회 관계(연락처) | 리드를 조회하도록 조회 관계 생성(Lookup(Contact)) |
✅ 권한 설정
◾API 사용 가능(API Enabled) 권한 활성화
◾사용자 정의 개체 권한
Dataspace Data 오브젝트에 대한 읽기(Read)/만들기(Create)/수정(Edit)/삭제(Delete)/모든 레코드 보기(View All Records), 모든 레코드 수정(Modify All Records) 권한 필요
◾사용자 정의 필드 수준 보안
Dataspace Data에 포함된 모든 필드에 대해 읽기 액세스(Read Access) 및 편집 액세스(Edit Access) 활성화 필요
2) Data 오브젝트 및 필드 생성과 권한 설정이 완료되었다면, 아래 경로 중 하나를 통해 [Salesforce로 데이터 내보내기] 버튼을 클릭하여 전송을 진행해 주세요.
◾홈 또는 프로젝트 화면에서 내보내기 실행
① 데이터스페이스 홈 화면 또는 프로젝트 화면에서 내보내고자 하는 설문의 [추가 작업(⦙)] 버튼을 클릭합니다.(※마우스 우클릭으로도 동일 메뉴에 진입할 수 있습니다.)
② 이후 '응답 내보내기> Salesforce'를 순서대로 선택합니다.
◾분석 화면에서 내보내기 실행
① 내보내고자 하는 설문을 선택한 후 [분석으로 이동]을 클릭합니다.
② 분석 화면 오른쪽 상단의 '내보내기> Salesforce로 내보내기> 내보내기 버튼 '을 눌러 전송을 완료합니다.
3) 내보낼 변수, 숨김 응답 전송 여부, Salesforce와 연결할 매칭 ID(리드 ID 또는 연락처 ID)를 선택한 후, [내보내기] 버튼을 클릭해 주세요. 단, 개인정보 및 이미지 문항은 '내보내기'가 제한됩니다.
4) 내보내기가 성공적으로 시작되면 ‘내보내기를 시작했습니다.’라는 메시지가 표시되며, 해당 작업의 진행 상태는 '내보내기 내역 보기'에서 확인할 수 있습니다.
내보내기 내역 보기
'설정 > 앱 & 소프트웨어 > Salesforce'에서 [연동 관리] 버튼을 클릭하면, Salesforce 내보내기 내역을 확인할 수 있으며 아래와 같은 정보를 확인할 수 있습니다.
데이터 제목
요청 멤버
요청 일시
진행 상태(내보내기 중 / 내보내기 완료 / 내보내기 실패)
📌 함께 알아두세요!
🔍 진행 상태
1) 내보내기 중
Salesforce로 데이터 전송이 진행 중입니다.
※ 상태는 자동으로 업데이트되지 않으므로, 오른쪽 상단의 [새로고침] 버튼을 눌러 최신 상태를 확인해 주세요.
2) 내보내기 완료
초록색 체크 표시: 모든 데이터가 성공적으로 전송되었습니다.
노란색 체크 표시: 일부 데이터는 전송되었으나, 일부는 실패했습니다.
빨간색 경고 표시: 내보내기 프로세스는 실행되었으나, 오류로 인해 데이터가 전송되지 않았습니다.
3) 내보내기 실패: 오류로 인해 데이터 전송이 실패했습니다.
🔍 실패 사유
ID 오류: Salesforce에 일치하는 리드 ID 또는 연락처 ID가 존재하지 않아 전송에 실패했습니다. 올바른 ID로 수정 후 다시 시도해 주세요.
오브젝트 오류: Dataspace의 오브젝트 및 필드 설정 문제, 혹은 Salesforce 계정 권한 이슈로 인해 전송에 실패했습니다. 오브젝트 구성, 필드 매핑, 계정 권한을 확인 후 다시 시도해 주세요.
알 수 없는 오류: 원인을 특정할 수 없는 오류가 발생했습니다. 네트워크 상태를 점검한 후, 다시 시도해 주세요.
참고 사항
하나의 스페이스에는 단일 Salesforce 조직만 연동할 수 있습니다. 다른 Salesforce 조직을 연동하려면 다음 중 하나를 선택해 주세요.
새로운 스페이스를 구매하여 해당 조직과 연동
기존 스페이스에서 현재 연동된 조직을 해제한 후, 새로운 조직을 연결
기존 스페이스의 Salesforce 조직을 해제하려면, '앱 & 소프트웨어' 화면 상단의 [조직 연동 해제] 버튼을 클릭해 주세요. (※ 단, 이 작업은 데이터스페이스의 Admin 권한을 가진 멤버만 수행할 수 있습니다.)
또는, 해당 조직에 연동된 모든 구성원이 직접 연동 해제를 완료하면 조직 연동도 자동으로 해제됩니다.