Salesforce로 연동하기
Salesforce 조직에 블럭스 커넥터(Blux Connector) 패키지를 설치하면, 리드와 영업 활동이 30분마다 블럭스 유저와 행동 데이터로 연동됩니다. 블럭스는 Salesforce 데이터를 읽기만 하고 수정하지 않습니다.
시작 전 준비
- Salesforce 시스템 관리자 계정이 필요합니다.
- API를 쓸 수 있는 에디션(Enterprise·Unlimited·Performance·Developer)이어야 합니다. Professional Edition은 API 애드온이 있어야 합니다.
- 연동할 블럭스 애플리케이션을 담당 매니저와 정해 두세요.
연동 순서
블럭스 커넥터 패키지를 설치하세요.
- 설 치 링크를 열고 시스템 관리자 계정으로 로그인하세요.
- 관리자용으로 설치(Install for Admins Only)를 선택하세요.
- 경고 문구 아래의 확인란을 선택하고 설치버튼을 클릭하세요.
설치 화면에 "AppExchange 파트너 프로그램의 일부로 배포 승인을 받지 못한 비 Salesforce 응용 프로그램"이라는 경고가 표시됩니다. 블럭스 커넥터가 AppExchange 보안 심사를 아직 거치지 않아 표시되는 안내입니다. 커넥터 패키지에는 블럭스가 인증에 쓰는 앱 설정만 들어 있고, 코드나 오브젝트·필드는 추가되지 않습니다.
블럭스 전용 연동 사용자를 만드세요.
블럭스는 이 사용자의 권한으로만 Salesforce 데이터를 읽습니다. 읽기 외의 권한(생성·편집·삭제)은 주지 마세요.
설정 > 사용자 > 사용자에서 새 사용자를 만드세요. 사용자 라이선스는 Salesforce Integration, 프로필은 Minimum Access - API Only Integrations를 선택하세요.- 만든 사용자에게 권한 세트 라이선스 Salesforce API Integration을 할당하세요.
설정 > 권한 세트에서 라이선스가 Salesforce API Integration인 권한 세트를 새로 만들고, 아래 오브젝트에 읽기(Read)와 모두 보기(View All)를 주세요.- 리드(Lead), 연락처(Contact), 거래처(Account), 기회(Opportunity)
- 같은 권한 세트에서 아래 읽기 권한이 필요한 필드에 필드 수준 읽기 권한을 주고, 권한 세트를 연동 사용자에게 할당하세요.
* 작업(Task)과 일정(Event)은 연결된 리드·연락처·기회를 읽을 수 있으면 함께 읽힙니다.
커넥터 정책에서 연동 사용자를 지정하세요.
설정 > 외부 클라이언트 앱 관리자(External Client App Manager)에서 Blux Connector를 클릭하세요.- 정책(Policies) 탭에서 편집버튼을 클릭하세요.
- OAuth 정책(OAuth Policies)에서 클라이언트 자격 증명 흐름 활성화(Enable Client Credentials Flow)를 선택하세요.
- 다른 사용자로 실행(Run As)에 2단계에서 만든 연동 사용자를 지정하고 저장하세요.
담당 매니저에게 내 도메인 URL을 전달하세요.
설정 > 내 도메인(My Domain)에서 현재 내 도메인 URL을 확인해 담당 매니저에게 전달하세요. 운영 조직은https://회사명.my.salesforce.com형식입니다.- 비밀번호나 키는 전달하지 않습니다. 블럭스가 연결을 확인하고 첫 동기화를 시작하면 담당 매니저가 알려 드립니다.
Salesforce 연동이 완료되었어요!
읽기 권한이 필요한 필드
필수 필드를 하나라도 읽을 수 없으면 동기화가 멈춥니다. 이때 담당 매니저가 권한을 추가할 필드를 알려 드립니다. 선택 필드는 읽을 수 없으면 해당 값만 비워 둔 채 연동됩니다.
| 오브젝트 | 필드 |
|---|---|
| 리드(Lead) | (필수) IsConverted, ConvertedContactId, ConvertedOpportunityId(선택) Status, LeadSource, Rating, MobilePhone, Phone, Email, HasOptedOutOfEmail, DoNotCall |
| 작업(Task) | (필수) WhoId, WhatId(선택) Subject, TaskSubtype, CallDisposition, CompletedDateTime |
| 일정(Event) | (필수) WhoId, WhatId(선택) Subject, StartDateTime |
| 기회(Opportunity) | (필수) Amount(선택) Name, StageName, ContactId, LastStageChangeDate, CloseDate |
* Id, CreatedDate, SystemModstamp처럼 모든 사용자가 읽을 수 있는 시스템 필드는 표에서 뺐습니다.
연동되는 데이터
유저
리드 하나가 블럭스 유저 하나가 되고, 리드 ID(00Q로 시작)가 유저 ID입니다. 리드를 전환해 만든 연락처와 기회의 활동도 원래 리드의 유저로 모입니다. 리드 없이 만든 연락처는 연락처 ID(003으로 시작)를 유저 ID로 씁니다.
| 블럭스 유저 속성 | Salesforce 리드 필드 |
|---|---|
| 휴대폰 번호 | MobilePhone, 비어 있으면 Phone (국내 번호만) |
| 이메일 | Email |
lead_status | Status |
lead_source | LeadSource |
lead_rating | Rating |
is_converted | IsConverted |
email_opted_out | HasOptedOutOfEmail |
do_not_call | DoNotCall |
email_opted_out과do_not_call은 커스텀 유저 속성으로만 연동되고 블럭스의 수신 동의에는 반영되지 않습니다. 발송 대상에서 빼려면 오디언스 조건에 넣으세요.- 리드 없이 만든 연락처는 활동만 연동되고 휴대폰 번호와 이메일은 연동되지 않습니다.
행동 데이터
| 이벤트 타입 | 기록 시점 | 주요 속성 |
|---|---|---|
lead_created | 리드를 만들었을 때 | lead_source, lead_status |
lead_status_changed | 리드 상태가 바뀌었을 때 | lead_status, previous_lead_status |
lead_converted | 리드를 전환했을 때 | sf_contact_id, sf_opportunity_id |
task_completed | 작업(Task)을 완료했을 때 | subject, task_subtype, call_disposition |
event_scheduled | 일정(Event)을 만들었을 때 | subject, start_at |
order | 기회가 Closed Won이 되었을 때 | order_amount, opportunity_name, stage_name |
order의 금액은 기회의Amount를 조직 기본 통화 그대로 씁니다.- 거래처에만 연결된 활동처럼 사람을 특정할 수 없는 활동은 연동되지 않습니다.
동기화 방식
- 30분마다 바뀐 데이터만 읽어 반영합니다. Salesforce에서 바뀐 내용이 블럭스에 보이기까지 최대 40분 정도 걸립니다.
- 첫 동기화에서 연동 전의 기록을 모두 가져옵니다. 연동 전 기록으로는 시나리오가 실행되지 않습니다.
- 리드를 삭제하면 블럭스 유저도 삭제되고, 휴지통에서 복원하면 다시 연동됩니다.
- 리드를 병합하면 먼저 만든 리드의 유저로 이후 데이터가 모입니다.
연동 해제
커넥터 정책에서 클라이언트 자격 증명 흐름 활성화를 해제하거나 패키지를 제거하면 동기화가 멈춥니다. 연동을 해제할 때는 담당 매니저에게도 알려 주세요. 이미 연동된 블럭스 데이터는 그대로 남습니다.