boosterMAX가이드센터

🔗리드연동추가 : 외부서비스(웹훅)

🔗
외부서비스 연동은 BoosterMAX가 발급한 전용 수신 URL로 외부 서비스가 JSON을 POST하면, 잠재고객에 리드가 실시간으로 쌓이는 인바운드 웹훅 방식입니다. 웹훅/API 전송을 지원하는 서비스라면 무엇이든 연결할 수 있습니다.

STEP 1. 리드연동관리 진입

  • 왼쪽 사이드 메뉴에서 설정 > 잠재고객관리 > 리드연동관리 클릭
  • 우측 상단의 + 외부 연동 추가 버튼 클릭

STEP 2. 기본정보 — 연동 방식 선택

연동 추가는 기본정보 → 상세설정 → 필드매핑 → 중복처리 4단계로 진행돼요.

  • 연동 방식: "외부서비스 연동" 선택
  • 서비스명: 관리하기 쉬운 이름 입력 (예: 위픽부스터, 네이버 폼)
  • 입력 완료 후 다음 버튼 클릭

STEP 3. 상세설정 — 수신 URL 발급

이 단계에서 리드를 받을 전용 수신 URL이 자동 발급됩니다.

  1. 복사 버튼으로 수신 URL을 복사해 외부 개발자에게 전달합니다 — "이 URL로 테스트 데이터 1건을 JSON(POST)으로 보내달라"고 요청하세요. 전송 예시 복사를 누르면 요청 형식 예시도 함께 전달할 수 있습니다.
  2. 테스트 데이터가 1건이라도 수신되면 "다음" 버튼이 활성화됩니다.
💡
개발자가 지금 전송할 수 없나요? 하단의 "예시 JSON을 붙여넣어 바로 설정"을 열고 예시 JSON을 붙여넣으면, 실제 수신 없이도 매핑 구성을 미리 진행할 수 있습니다.
  • 창을 닫아도 발급된 URL은 계속 유효합니다. 목록의 "설정 계속하기"로 언제든 이어서 설정할 수 있어요.
  • 설정을 마치기 전에 수신된 리드는 보관되었다가, 매핑 완료 시 한꺼번에 등록됩니다.
  • 랜딩페이지 연결(옵션): 랜딩페이지 연결(옵션): "연결 안 함"으로 두거나, "기존 랜딩페이지 선택"으로 이미 만든 랜딩페이지에 연결할 수 있습니다.

STEP 4. 필드매핑

수신된 데이터의 필드가 자동으로 감지됩니다. 외부 필드를 BoosterMAX의 시스템 필드에 연결하세요.

  • 고객명 / 연락처 / 유입일시 3개는 필수 매핑입니다
  • 유입일시는 매핑하지 않으면 받은 시각으로 기록돼요.
  • 필수 항목 외의 모든 필드는 추가정보로 자동 저장되며, 잠재고객 상세에서 확인할 수 있습니다
  • 매핑 완료 후 다음 버튼 클릭 — 지금 마치기 어려우면 나중에 하기를 누르고, 목록의 "설정 계속하기"로 이어서 진행하세요


STEP 5. 중복처리

같은 고객이 다시 들어왔을 때 어떻게 받을지 정합니다.

(이미지)

  • 중복 리드 처리 활성화 — 켜면, 선택한 기간 이내에 이 연동으로 같은 이름·전화번호가 다시 들어올 경우 중복으로 제외돼요.
  • 같은 이름·전화번호가 기간이 지난 뒤 다시 들어오면 '중복신청' 상태로 받아요.
  • 중복 판단 기간 — 1일 / 7일(기본) / 30일 / 90일 / 무제한 / 직접 입력 중 선택
  • 설정 완료 후 완료 버튼 클릭
💡
중복처리 설정을 바꾸면 그 뒤에 들어오는 리드부터 적용돼요. 이전에 들어온 리드는 바뀌지 않아요. 연동을 만든 뒤에도 리드연동관리 > 연동 설정 상세 화면에서 언제든 바꿀 수 있어요.

STEP 6. 연동 완료 후 — 연동 설정 상세

완료하면 연동 설정 상세 화면에서 연동 상태를 관리할 수 있습니다.

  • 기본 정보: 서비스명, 등록일, 수신 URL (복사 버튼)
  • 컬럼 매핑: "매핑 수정"으로 언제든 변경할 수 있습니다 — 변경한 시점 이후에 수집된 리드부터 새 매핑이 반영됩니다
  • 중복 리드 처리: 연동별 중복 판단 기간을 여기서 바꿀 수 있습니다
  • 수정한 항목은 맨 아래 저장을 눌러야 반영됩니다
  • 수신 현황: 총 수신 리드 수, 상태(활성/비활성), 셋업 완료 여부
  • 수신된 리드는 잠재고객 메뉴에서 바로 확인할 수 있습니다
💡
중복 리드는 연동마다 설정한 중복 판단 기간에 따라 처리됩니다. 기간 이내 재유입은 제외되고, 기간이 지난 재신청은 '중복신청' 상태로 들어와요.

자주 묻는 질문

Q. 외부 개발자가 테스트 데이터를 아직 못 보내줘요

  • "예시 JSON을 붙여넣어 바로 설정"으로 매핑을 미리 구성해두세요
  • 창을 닫아도 URL은 유효하니, 전송이 준비되면 목록의 "설정 계속하기"로 이어서 완료하면 됩니다

Q. 필드매핑을 잘못 설정했어요

  • 연동 설정 상세의 "매핑 수정"에서 언제든 변경할 수 있습니다
  • 단, 변경한 시점 이후에 수집된 리드부터 반영됩니다

Q. 중복 리드는 어떻게 처리되나요?

  • 연동마다 정한 중복 판단 기간 안에 같은 이름·전화번호가 다시 들어오면 제외됩니다
  • 기간이 지난 뒤 다시 들어오면 '중복신청' 상태로 받아요
  • 기간은 연동 설정 상세의 중복 리드 처리에서 바꿀 수 있어요