CRM 브리지
세션에 이름이 연결되면 CRM의 기존 연락처에 녹화를 메모로 추가합니다. 새 연락처를 만들지 않습니다.
1. 한 문장으로 설명
세션을 식별하는 순간 전달받은 식별자로 CRM에서 해당 사람을 찾아 녹화 링크가 있는 메모를 붙입니다.
그뿐입니다. 연락처나 거래를 새로 만들거나 파이프라인을 바꾸지 않습니다. 가격 페이지를 방문할 때마다 중복 항목을 만드는 CRM은 연동이 없는 것보다 나쁩니다.
사람을 찾지 못하면 아무것도 하지 않습니다. 새로 만들면 브라우저 세션을 근거로 CRM에 기록하게 되지만, 브라우저 세션은 고객을 판단하는 권위 있는 근거가 아닙니다.
2. 매칭 키: 사람을 찾는 방법
CRM 연동이 조용히 잘못되는 지점이므로 10분 정도 살펴볼 가치가 있습니다.
사이트가 알려 준 식별자, 즉 MousePlayer.setUserId(), 분석 도구에서 읽은 distinct ID 또는 서버 identify 호출로 방문자를 압니다. CRM도 어떤 값으로 사람을 식별하므로 양쪽이 같아야 합니다.
| 검색 기준 | 변경 가능 여부 | |
|---|---|---|
| HubSpot | 연락처 이메일 주소 | 불가 — 검색 엔드포인트가 이메일을 기준으로 함 |
| Pipedrive | 검색어로 사람 조회, 이메일 우선 | 불가 |
| Salesforce | 필드: 직접 지정, 기본값 Email | 가능 |
Salesforce만 필드를 묻는 이유
Salesforce는 이메일을 키로 쓰는 경우가 드뭅니다. 예를 들어 Customer_Number__c또는 청구 시스템의 외부 ID를 쓸 수 있습니다. 그런데도 이메일로 찾으면 아무것도 찾지 못하고 성공으로 보고하여 연동이 정상처럼 보이는 최악의 실패가 됩니다.
따라서 다음을 묻습니다: 전달하는 값이 Contact의 어느 필드에 있나요? API 이름을 입력하며 맞춤 필드라면 __c 도 포함하세요.
필드 이름은 쿼리에 들어가기 전 엄격한 패턴으로 검사합니다. 문자, 숫자 및 밑줄만 허용하며 나머지는 이스케이프하지 않고 거부합니다. 이스케이프는 미묘하게 틀릴 수 있지만 거부는 그렇지 않기 때문입니다.
3. 실행 시점과 의도적으로 실행하지 않는 경우
사이트의 MousePlayer.setUserId()호출, 분석 브리지가 PostHog, Mixpanel 또는 Amplitude에서 distinct ID를 읽거나 서버가 identify 엔드포인트를 호출하는 식별 시점에 실행합니다.
페이지당 아닌 세션당 한 번
로그인 후 11페이지를 탐색해도 메모는 11개가 아닌 하나입니다. CRM 타임라인은 사람이 읽는 곳입니다.
식별자가 없으면 실행하지 않음
익명 세션은 매칭 기준이 없습니다. IP 주소로 추측하거나 같은 주소를 공유하는 다른 사람에게 녹화를 붙이지 않습니다.
CRM에 없는 사람이면 실행하지 않음
실패가 아닌 완료로 집계합니다. 잠재 고객이 아직 CRM에 없는 것은 정상이며 내일 재시도해도 달라지지 않습니다.
4. 메모 형식과 토큰 보관 위치
연락처 타임라인에 세션이 녹화되었다는 한 줄과 링크를 하나의 메모로 추가합니다. 영업 담당자는 클릭하여 문의 전 실제 행동을 볼 수 있습니다.
자격 증명
AES-256-GCM으로 암호화하여 저장하며 다시 표시하지 않습니다. 필드에는 별표가 표시되고 별표 상태로 저장해도 저장값은 유지합니다. 작업을 전달하는 내부 대기열에도 넣지 않습니다. 대기열은 공유 상태이며 키를 두기에 적합하지 않습니다.
Salesforce는 세 항목, 나머지는 두 항목 필요
Salesforce는 갱신 토큰이 있는 Connected App으로 인증하므로 consumer key, secret, 갱신 토큰 및 인스턴스 URL을 받습니다. HubSpot과 Pipedrive는 API 토큰 하나를 받습니다. 모두 자체 앱을 사용하며 MousePlayer가 운영하는 마켓플레이스 앱을 신뢰할 필요는 없습니다.
5. Zoho CRM 및 Freshsales
두 CRM이 추가되며 설정 난이도는 서로 반대입니다.
| Zoho CRM | Freshsales | |
|---|---|---|
| 제공할 정보 | 데이터 센터, 클라이언트 ID, 클라이언트 비밀 값, 갱신 토큰 | API 키 및 Freshworks 도메인 |
| 검색 기준 | 직접 지정한 필드, 기본값 Email | 직접 지정한 필드, 기본값 email |
| 메모 위치 | 연락처의 Note 레코드 | 연락처의 메모 |
Zoho는 여섯 데이터 센터 중 하나에 위치
계정은 com, eu, in, com.au, jp 또는 com.cn에 있으며 키로는 알 수 없습니다. 잘못 선택하면 Zoho가 INVALID_TOKEN 을 반환하여 키 문제처럼 보이고 엉뚱한 곳을 확인하게 됩니다. 그래서 드롭다운 필드로 제공합니다.
Self Client, 한 번만
Zoho API 콘솔에서 Self Client를 만들고 ZohoCRM.modules.ALL 및 ZohoSearch.securesearch.READ범위의 grant token을 생성하여 갱신 토큰으로 한 번 교환하세요. 갱신 토큰은 만료되지 않으며 매시간 액세스 토큰을 받아 쓰고 저장하지 않습니다.
Zoho는 거부하면서도 200을 반환
토큰 교환과 레코드 쓰기 모두 HTTP 200의 본문에 오류나 레코드별 상태를 담을 수 있습니다. 상태 코드만 믿으면 생성되지 않은 메모에 성공을 보고하므로 본문을 읽습니다.
여기에 언급된 모든 상표는 각 소유자에게 귀속됩니다. MousePlayer는 이 제공업체들과 사업 관계가 없습니다.