> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# HighLevel

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

## 설정

### 비공개 통합 토큰 만들기

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

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

### 위치 ID 찾기

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

### 웹훅 도구 만들기

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

| 필드           | 값                                                                                                                                                                                                                                                                                                                        |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **이름**       | `save_highlevel_contact`                                                                                                                                                                                                                                                                                                 |
| **설명**       | "발신자의 이름과 전화번호를 알게 되면 CRM에 연락처로 저장합니다. 신규 고객과 기존 고객의 모든 통화에서 사용합니다."                                                                                                                                                                                                                                                     |
| **메서드**      | POST                                                                                                                                                                                                                                                                                                                     |
| **URL**      | `https://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**을 선택합니다.

### 테스트하기

이름과 전화번호를 제공하는 통화로 [리셉셔니스트를 테스트](/docs/ko/reception-ai/receptionist/testing)하세요. 연락처가 HighLevel의 **Contacts**에 표시됩니다. 같은 번호로 다시 전화하면 HighLevel은 새 연락처를 추가하는 대신 해당 연락처를 업데이트합니다.

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

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

> **Tip**
>
> 통화 후 기회를 생성하거나 팀에 알림을 보내는 등 추가 작업을 하려면 **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** 설정과 전화번호가 동일한 국제 형식으로 저장되었는지 확인하세요.                    |
| 연락처에 이름이 없음        | 저장하기 전에 발신자의 이름을 물어보도록 도구 설명에 리셉셔니스트에게 지시하세요.                                      |