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

# Copper

리셉셔니스트는 이미 Copper에 있는 발신자를 인식하고, 새 발신자를 리드로 추가하며, 각 발신자가 원한 내용을 기록하고 팀을 위한 후속 작업을 만들 수 있습니다. 발신자 조회와 작업 생성에는 [웹훅 도구](/docs/ko/reception-ai/integrations/webhooks)를 사용합니다. 리드와 메모 추가는 [Zapier](/docs/ko/reception-ai/integrations/zapier)를 통해 처리합니다. Copper는 전화번호와 메모 링크를 웹훅 도구로는 전송할 수 없는 중첩 데이터로 저장하기 때문입니다.

## 시작하기 전에

Copper에서 **System settings** → **API Keys**를 열고 **Generate API key**를 선택합니다. 예를 들어 `Reception.ai`라고 레이블을 지정합니다. 이 키는 사용자를 대신하므로, 사용자가 볼 수 있고 변경할 수 있는 항목을 모두 보고 변경할 수 있습니다.

아래의 모든 웹훅 도구는 다음 요청 헤더를 전송합니다.

| 헤더                 | 값                 |
| ------------------ | ----------------- |
| `X-PW-AccessToken` | API 키             |
| `X-PW-Application` | `developer_api`   |
| `X-PW-UserEmail`   | 키를 만든 사용자의 이메일 주소 |

> **Warning**
>
> API 키와 이메일 주소를 가진 사람은 누구나 Copper 데이터를 읽고 변경할 수 있습니다. 키를
> 공유 문서에 넣지 말고, 유출된 경우 Copper에서 삭제하세요.

## 웹훅 도구 만들기

각 도구에 대해 **Integrations**로 이동해 **Add integration**을 선택하고 **Webhook Tool**을 선택한 다음 **Assign to agents**를 **Receptionist**로 설정합니다. Copper의 검색 엔드포인트는 본문에 검색어를 포함한 POST를 사용합니다.

### 연락처 찾기

| 필드          | 값                                                       |
| ----------- | ------------------------------------------------------- |
| **이름**      | `find_copper_person`                                    |
| **설명**      | "전화번호로 연락처 중에서 발신자를 찾습니다. 통화 시작 시 고객인지 확인하는 데 사용하세요."   |
| **메서드**     | POST                                                    |
| **URL**     | `https://api.copper.com/developer_api/v1/people/search` |
| **요청 헤더**   | [시작하기 전에](#before-you-start)의 헤더                        |
| **본문 매개변수** | `phone_number` (문자열, 필수): "발신자의 전화번호입니다."               |

### 리드 찾기

| 필드          | 값                                                      |
| ----------- | ------------------------------------------------------ |
| **이름**      | `find_copper_lead`                                     |
| **설명**      | "전화번호로 리드 중에서 발신자를 찾습니다. 발신자가 연락처가 아닐 때 사용하세요."        |
| **메서드**     | POST                                                   |
| **URL**     | `https://api.copper.com/developer_api/v1/leads/search` |
| **요청 헤더**   | [시작하기 전에](#before-you-start)의 헤더                       |
| **본문 매개변수** | `phone_number` (문자열, 필수): "발신자의 전화번호입니다."              |

### 후속 작업 만들기

| 필드          | 값                                                                                               |
| ----------- | ----------------------------------------------------------------------------------------------- |
| **이름**      | `create_copper_task`                                                                            |
| **설명**      | "발신자에게 콜백을 약속할 때마다 팀을 위한 작업을 만듭니다."                                                             |
| **메서드**     | POST                                                                                            |
| **URL**     | `https://api.copper.com/developer_api/v1/tasks`                                                 |
| **요청 헤더**   | [시작하기 전에](#before-you-start)의 헤더                                                                |
| **본문 매개변수** | `name` (문자열, 필수): "예: 주방 견적에 관해 Jane Doe에게 콜백."  `details` (문자열, 필수): "발신자의 이름, 전화번호 및 필요한 사항." |

각 도구에서 **Enable**을 선택합니다.

## 리드 및 메모 추가

### Zapier 연결

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

### Copper 작업 추가

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

* **Create Lead**: 소유자와 리드 소스는 고정 값으로 설정하고, 발신자의 이름, 전화번호, 이메일 주소 및 원하는 사항은 AI가 입력하도록 설정합니다.
* **Create Activity**: 활동 유형을 메모로 설정하고, 검색 도구에서 찾은 사람 또는 리드와 발신자에게 필요한 사항은 AI가 입력하도록 설정합니다.

### 도구 할당

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

### 테스트

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

> **Tip**
>
> 리셉셔니스트가 먼저 연락처와 리드를 검색하고, 어느 검색에서도 발신자를 찾지 못했을 때만 리드를 만들도록 [절차](/docs/ko/reception-ai/receptionist/rules-and-procedures)를
> 추가하세요.

## 제한 사항

* 웹훅 도구는 플랫 값을 전송하지만 Copper는 중첩 값을 사용해 작업을 사람 또는 리드에 연결합니다. 따라서 `create_copper_task`의 작업은 발신자의 레코드에 연결되지 않으며, 대신 작업 세부 정보에 발신자의 이름과 번호가 유지됩니다.
* Copper는 마감일을 AI가 안정적으로 계산할 수 없는 Unix 타임스탬프로 받으므로, `create_copper_task`는 마감일을 비워 둡니다.
* 작업을 발신자에게 연결하거나 마감일을 설정하려면, 웹훅 도구 대신 Zapier를 통해 Copper의 **Create Task** 작업을 사용하세요.
* 리셉셔니스트가 실행하는 각 Zapier 작업은 Zapier 요금제의 작업 수를 사용합니다. 요금제 한도를 모두 사용하면 재설정될 때까지 작업이 중지됩니다.

## 문제 해결

| 문제                            | 확인할 사항                                                                            |
| ----------------------------- | --------------------------------------------------------------------------------- |
| Copper에서 401 또는 403 오류        | 세 헤더를 모두 확인하세요. `X-PW-UserEmail`은 키를 생성한 사용자의 이메일이어야 합니다.                         |
| 기존 발신자를 찾을 수 없음               | Copper는 저장된 형식 그대로 전화번호를 일치시킵니다. 번호를 하나의 형식으로 저장하고, 발신자가 회사가 아닌 사람 또는 리드인지 확인하세요. |
| 리셉셔니스트가 중복 리드를 만듦             | 검색 도구의 설명에서 발신자를 찾지 못했을 때만 리드를 만들도록 지시하세요.                                        |
| Copper 작업이 표시되지 않음            | Zapier에서 작업을 추가한 후 Zapier 통합에서 **Refresh tools**를 선택하세요.                          |
| 작업에 **Changed**가 표시되고 사용되지 않음 | Zapier에서 해당 작업을 수정했습니다. **Tools** 탭에서 **Update**를 선택하세요.                          |