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

# Capsule CRM

리셉셔니스트는 이미 Capsule에 있는 발신자를 인식하고, 새 발신자를 연락처로 추가하며, 각 발신자가 원한 내용을 기록하고 팀을 위한 후속 작업을 만들 수 있습니다. 발신자 조회에는 [웹훅 도구](/docs/ko/reception-ai/integrations/webhooks)를 사용합니다. 연락처, 메모 및 작업 추가는 [Zapier](/docs/ko/reception-ai/integrations/zapier)를 통해 처리합니다. Capsule의 API는 웹훅 도구로는 전송할 수 없는 중첩 요청 본문을 필요로 하기 때문입니다.

## 발신자 조회

### API 토큰 만들기

Capsule에서 **My Preferences** → **API Authentication Tokens**를 열고 새 토큰을 생성합니다. 예를 들어 `Reception.ai`라고 이름을 지정합니다. 이 토큰은 사용자를 대신하므로, 사용자가 볼 수 있고 변경할 수 있는 항목을 모두 보고 변경할 수 있습니다.

> **Warning**
>
> 토큰을 가진 사람은 누구나 Capsule 데이터를 읽고 변경할 수 있습니다. 공유 문서에 토큰을 넣지 말고,
> 유출된 경우 Capsule에서 삭제하세요.

### 웹훅 도구 만들기

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

| 필드           | 값                                                                 |
| ------------ | ----------------------------------------------------------------- |
| **이름**       | `find_capsule_contact`                                            |
| **설명**       | "전화번호, 이름 또는 이메일로 CRM에서 발신자를 찾습니다. 통화 시작 시 기존 고객인지 확인하는 데 사용하세요." |
| **메서드**      | GET                                                               |
| **URL**      | `https://api.capsulecrm.com/api/v2/parties/search`                |
| **요청 헤더**    | `Authorization`: `Bearer ` 뒤에 토큰 입력                               |
| **쿼리 매개변수**  | `q` (문자열, 필수): "발신자의 전화번호, 전체 이름 또는 이메일 주소입니다."                   |
| **에이전트에 할당** | **Receptionist**                                                  |

**Enable**을 선택합니다. 검색 결과는 Capsule 자체 검색창의 결과와 같습니다.

## 연락처, 메모 및 작업 추가

### Zapier 연결

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

### Capsule 작업 추가

[mcp.zapier.com](https://mcp.zapier.com)의 Zapier MCP 서버에서 Capsule CRM 계정을 연결하고 아래의 [작업](#actions)을 추가합니다. 각 필드에는 고정 값을 설정하거나, 안내된 대로 AI가 입력하도록 설정합니다.

### 도구 할당

Reception.ai에서 Zapier 통합의 **Tools** 탭을 열고 **Refresh tools**를 선택한 다음, 안내된 대로 각 작업을 할당합니다.

### 테스트

Capsule 연락처에 저장된 번호로 [리셉셔니스트를 테스트](/docs/ko/reception-ai/receptionist/testing)한 후, 콜백을 요청하는 새 발신자로 테스트합니다. 새 연락처, 메모 및 작업이 Capsule에 표시됩니다.

## 작업

### 발신자 추가

| 필드               | 값                     |
| ---------------- | --------------------- |
| **Zapier 작업**    | **Create Contact**    |
| **Zapier에서 설정**  | 유형(Person), 소유자 및 태그. |
| **AI가 입력하도록 설정** | 이름, 성, 전화번호 및 이메일 주소. |
| **할당 대상**        | **Client**            |

### 메모 기록

| 필드               | 값                                                                |
| ---------------- | ---------------------------------------------------------------- |
| **Zapier 작업**    | **Add Note to Entity**                                           |
| **Zapier에서 설정**  | 메모를 추가할 레코드 유형: 연락처.                                             |
| **AI가 입력하도록 설정** | 연락처 ID(`find_capsule_contact` 또는 **Create Contact**에서 가져옴) 및 메모. |
| **할당 대상**        | **Client**                                                       |

### 후속 작업 만들기

| 필드               | 값                      |
| ---------------- | ---------------------- |
| **Zapier 작업**    | **Create Task**        |
| **Zapier에서 설정**  | 콜백을 처리할 팀 구성원.         |
| **AI가 입력하도록 설정** | 설명, 마감일 및 작업과 관련된 연락처. |
| **할당 대상**        | **Client**             |

> **Tip**
>
> 리셉셔니스트가 먼저 발신자를 검색하고 일치 항목이 없을 때만 연락처를 만들도록 [절차](/docs/ko/reception-ai/receptionist/rules-and-procedures)를
> 추가하세요.

## 제한 사항

* Zapier의 Capsule 앱은 누구의 일정 가능 여부도 확인할 수 없으므로, 리셉셔니스트는 Capsule에서 미팅을 예약할 수 없습니다. 대신 후속 작업을 사용하거나 [Google Calendar](/docs/ko/reception-ai/integrations/google-calendar)를 통한 Reception의 자체 예약 기능을 사용하세요.
* 리셉셔니스트가 실행하는 각 Zapier 작업은 Zapier 요금제의 작업 수를 사용합니다. Zapier는 현재 성공한 통화당 작업 2개를 계산하며, 실패한 통화는 계산하지 않습니다. 요금제 한도를 모두 사용하면 재설정될 때까지 작업이 중지됩니다.

## 문제 해결

| 문제                                | 확인할 사항                                                                 |
| --------------------------------- | ---------------------------------------------------------------------- |
| Capsule에서 401 오류                  | 헤더 값이 `Bearer `와 공백으로 시작하는지 확인하고, 토큰이 삭제되지 않았는지 확인하세요.                 |
| 기존 발신자를 찾을 수 없음                   | Capsule은 저장된 형식 그대로 전화번호를 일치시킵니다. 번호를 하나의 형식으로 저장하거나 이름 또는 이메일로 검색하세요. |
| 리셉셔니스트가 중복 연락처를 만듦                | 조회 도구의 설명에서 발신자를 찾지 못했을 때만 연락처를 추가하도록 지시하세요.                           |
| Capsule 작업이 Reception.ai에 표시되지 않음 | Zapier에서 작업을 추가한 후 Zapier 통합에서 **Refresh tools**를 선택하세요.               |
| 작업에 **Changed**가 표시되고 사용되지 않음     | Zapier에서 해당 작업을 수정했습니다. **Tools** 탭에서 **Update**를 선택하세요.               |