> 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.

# Nutshell

리셉셔니스트는 이미 Nutshell에 등록된 발신자를 인식하고, 새 발신자를 팀에서 후속 조치할 수 있도록 리드가 연결된 사람으로 추가할 수 있습니다. 발신자 조회에는 [웹훅 도구](/docs/ko/reception-ai/integrations/webhooks)를 사용합니다. 사람과 리드 추가는 [Zapier](/docs/ko/reception-ai/integrations/zapier)를 통해 진행합니다. Nutshell API는 레코드를 생성하기 위해 목록과 중첩 값이 필요하지만 웹훅 도구는 이를 전송할 수 없기 때문입니다.

## 발신자 조회

### API 키 만들기

Nutshell에서 왼쪽 하단의 **Settings**를 선택한 다음 **Connections** 아래의 **API keys**를 선택합니다. **Add API key**를 선택하고 Zapier에도 필요한 **API + user impersonation**을 선택합니다. 키를 복사합니다.

### 인증 헤더 만들기

Nutshell API는 Nutshell 이메일 주소를 사용자 이름으로, API 키를 비밀번호로 사용합니다. 터미널에서 두 값을 바꾸고 그 사이의 콜론은 유지한 채 인코딩합니다.

```bash
printf 'YOUR_EMAIL:YOUR_API_KEY' | base64
```

헤더 값은 `Basic ` 뒤에 출력값을 붙인 형식입니다.

> **Warning**
>
> API 키를 온라인 인코더에 붙여 넣지 마세요. 키 또는 인코딩된 헤더를 가진 사람은 누구나
> Nutshell 데이터를 읽고 변경할 수 있습니다.

### 웹훅 도구 만들기

**Integrations**로 이동하여 **Add integration**을 선택한 다음 **Webhook Tool**을 선택합니다.

| 필드           | 값                                                                 |
| ------------ | ----------------------------------------------------------------- |
| **이름**       | `find_nutshell_person`                                            |
| **설명**       | "전화번호, 이름 또는 이메일로 CRM에서 발신자를 찾습니다. 통화 시작 시 기존 고객인지 확인하는 데 사용합니다." |
| **메서드**      | GET                                                               |
| **URL**      | `https://app.nutshell.com/rest/contacts`                          |
| **요청 헤더**    | `Authorization`: 인코딩된 값 앞에 `Basic ` 붙이기                           |
| **쿼리 매개변수**  | `q` (문자열, 필수): "발신자의 전화번호, 전체 이름 또는 이메일 주소."                      |
| **에이전트에 할당** | **Receptionist**                                                  |

**Enable**을 선택합니다.

## 사람 및 리드 추가

### Zapier 연결

아직 연결하지 않았다면 Reception.ai에서 [Zapier](/docs/ko/reception-ai/integrations/zapier)를 연결하세요.

### Nutshell 작업 추가

[mcp.zapier.com](https://mcp.zapier.com)의 Zapier MCP 서버에서 API 키로 Nutshell 계정을 연결하고 다음 작업을 추가합니다.

* **Create Person**: AI가 발신자의 이름, 전화번호, 이메일 주소를 입력하도록 설정합니다.
* **Create Lead**: 소스, 파이프라인, 담당자는 고정 값으로 설정하고, AI가 발신자의 요청 내용과 해당 대상자에 대한 설명을 입력하도록 설정합니다.

> **Tip**
>
> 사람의 타임라인에 통화를 기록하려면 **Log Activity**도 추가하고 AI가
> 짧은 요약을 입력하도록 설정하세요.

### 도구 할당

Reception.ai에서 Zapier 통합의 **Tools** 탭을 열고 **Refresh tools**를 선택한 다음 Nutshell 작업을 **Client**(리셉셔니스트)에 할당합니다.

### 테스트

Nutshell 사람에 저장된 번호로 전화를 건 경우와 견적을 원하는 새 발신자인 경우로 [리셉셔니스트를 테스트](/docs/ko/reception-ai/receptionist/testing)하세요. 새 사람과 해당 리드가 Nutshell에 표시됩니다.

## 제한 사항

* Zapier의 Nutshell 앱에는 후속 태스크를 만드는 작업이 없습니다. 대신 리드 담당자가 Nutshell에서 새 리드를 확인할 수 있습니다.
* Zapier의 Nutshell 앱은 사용 가능 시간을 확인할 수 없으므로 리셉셔니스트는 Nutshell에서 미팅을 예약할 수 없습니다. [Google Calendar](/docs/ko/reception-ai/integrations/google-calendar)를 사용하여 Reception 자체 예약 기능을 이용하세요.
* 리셉셔니스트가 실행하는 각 Zapier 작업은 Zapier 플랜의 태스크를 사용합니다. 현재 Zapier는 성공한 통화당 태스크 2개를 계산하며, 실패한 통화는 계산하지 않습니다. 플랜이 소진되면 재설정될 때까지 작업이 중지됩니다.

## 문제 해결

| 문제                                 | 확인 사항                                                    |
| ---------------------------------- | -------------------------------------------------------- |
| Nutshell에서 401 반환                  | Nutshell 이메일 주소, 콜론, 키를 인코딩하고 헤더 값은 `Basic `으로 시작해야 합니다. |
| 알려진 발신자를 찾을 수 없음                   | Nutshell의 사람에 저장된 번호로 테스트 전화를 걸거나, 발신자에게 이름을 물어보세요.      |
| 리셉셔니스트가 중복된 사람을 생성함                | 조회 도구 설명에 발신자를 찾지 못한 경우에만 사람을 추가하라고 지시하세요.               |
| Nutshell 작업이 Reception.ai에 표시되지 않음 | Zapier에서 작업을 추가한 후 Zapier 통합에서 **Refresh tools**를 선택하세요. |
| Zapier가 Nutshell에 연결할 수 없음         | **API + user impersonation**이 포함된 API 키를 사용하세요.          |