탐색으로 건너뛰기
통합설정 가이드CRM

HighLevel

웹훅 도구를 사용해 발신자를 HighLevel에 연락처로 저장하세요.

HighLevel은 GoHighLevel이라고도 하며, API는 LeadConnector라는 이름으로 실행됩니다. 웹훅 도구를 사용하면 리셉셔니스트가 발신자를 HighLevel 하위 계정의 연락처로 저장할 수 있습니다. 발신자가 이미 연락처인 경우 HighLevel은 중복 항목을 만들지 않고 기존 기록을 업데이트합니다.

설정

1

비공개 통합 토큰 만들기

HighLevel 하위 계정에서 Settings → Private Integrations를 열고 Create New Integration을 선택합니다. 이름을 지정하고, 연락처를 조회하고 수정하는 데 필요한 범위만 선택한 다음 생성합니다. 토큰은 즉시 복사하세요. HighLevel은 토큰을 한 번만 표시합니다.

설정에 Private Integrations가 없다면 대행사 관리자에게 액세스 권한을 요청하세요.

2

위치 ID 찾기

같은 하위 계정에서 Settings → Business Profile을 열고 Location ID를 복사합니다.

3

웹훅 도구 만들기

Reception.ai에서 Integrations로 이동해 Add integration을 선택한 다음 Webhook Tool을 선택합니다.

필드값
이름save_highlevel_contact
설명”발신자의 이름과 전화번호를 알게 되면 CRM에 연락처로 저장합니다. 신규 고객과 기존 고객의 모든 통화에서 사용합니다.”
메서드POST
URLhttps://services.leadconnectorhq.com/contacts/upsert
요청 헤더Authorization: Bearer 뒤에 토큰 입력
Version: 2021-07-28
본문 매개변수locationId (문자열, 필수): “항상 정확히 LOCATION_ID 값을 사용합니다.”
firstName (문자열, 필수): “발신자의 이름입니다.”
lastName (문자열): “발신자가 제공한 경우 발신자의 성입니다.”
phone (문자열, 필수): “예: +14155550123과 같은 국제 형식의 발신자 전화번호입니다.”
email (문자열): “발신자가 제공한 경우 발신자의 이메일 주소입니다.”
source (문자열, 필수): “항상 정확히 Reception.ai phone call 값을 사용합니다.”
에이전트에 할당Receptionist

LOCATION_ID를 복사한 ID로 바꿉니다. Enable을 선택합니다.

4

테스트하기

이름과 전화번호를 제공하는 통화로 리셉셔니스트를 테스트하세요. 연락처가 HighLevel의 Contacts에 표시됩니다. 같은 번호로 다시 전화하면 HighLevel은 새 연락처를 추가하는 대신 해당 연락처를 업데이트합니다.

토큰으로 연락처를 읽고 변경할 수 있습니다. 공유 문서에 넣지 말고, 유출된 경우 HighLevel에서 비공개 통합을 삭제하세요.

HighLevel은 하위 계정의 Allow Duplicate Contact 설정을 사용해 발신자가 이미 연락처인지 판단합니다. 이 설정이 이메일과 전화번호 모두로 일치 여부를 확인하도록 되어 있다면, 설정에 나열된 순서대로 확인합니다.

통화 후 기회를 생성하거나 팀에 알림을 보내는 등 추가 작업을 하려면 Inbound Webhook 트리거로 시작하는 HighLevel 워크플로를 만드세요. 두 번째 웹훅 도구가 필요한 필드와 함께 워크플로의 URL을 가리키도록 한 다음, 워크플로 내에서 해당 필드를 매핑합니다. 워크플로 URL은 비밀로 취급하세요. HighLevel은 Inbound Webhook을 프리미엄 트리거로 분류하므로, 요금제의 사용 요금을 확인하세요.

제한 사항

  • HighLevel의 MCP 서버에는 OAuth 로그인이 필요하지만 Reception.ai는 이를 지원하지 않으므로 웹훅 도구를 사용하세요.
  • 태그와 사용자 지정 필드는 HighLevel API에서 목록이며, 웹훅 도구는 평면 값을 전송합니다. 대신 워크플로에서 설정하세요.
  • 메모나 작업을 추가하려면 URL에 연락처 ID가 필요하지만, 웹훅 도구는 통화 중 이를 입력할 수 없습니다. 이러한 작업에는 Inbound Webhook 워크플로를 사용하세요.

문제 해결

문제확인할 사항
HighLevel에서 401 반환Authorization 헤더는 Bearer 뒤에 토큰이 와야 하며, Bearer 뒤에 공백이 있어야 합니다.
HighLevel에서 403 반환토큰에 연락처 범위가 필요하며, locationId는 토큰이 생성된 하위 계정이어야 합니다.
HighLevel이 버전을 거부함Version 헤더는 정확히 2021-07-28이어야 합니다. HighLevel API 문서에 더 새로운 필수 값이 있다면 이를 사용하세요.
기존 발신자가 중복 생성됨Allow Duplicate Contact 설정과 전화번호가 동일한 국제 형식으로 저장되었는지 확인하세요.
연락처에 이름이 없음저장하기 전에 발신자의 이름을 물어보도록 도구 설명에 리셉셔니스트에게 지시하세요.