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

# Pipedrive

아래 [웹훅 도구](/docs/ko/reception-ai/integrations/webhooks)를 사용하면 접수 담당자가 Pipedrive에 이미 등록된 발신자를 식별하고, 새로운 영업 기회에 대한 거래를 생성하며, 팀의 후속 통화를 예약할 수 있습니다.

## 시작하기 전에

Pipedrive에서 **Personal preferences** → **API**를 열고 API 토큰을 복사하세요. 아래의 모든 도구는 `x-api-token` 요청 헤더로 이를 전송합니다. 이 도구는 사용자 권한으로 작동하므로, 올바른 파이프라인을 볼 수 있는 사용자의 토큰을 사용하세요.

## 도구 만들기

각 도구에서 **Integrations**로 이동해 **Add integration**을 선택하고 **Webhook Tool**을 선택한 다음, **Assign to agents**를 **Receptionist**로 설정하세요.

### 발신자 찾기

| 필드          | 값                                                                  |
| ----------- | ------------------------------------------------------------------ |
| **이름**      | `find_pipedrive_person`                                            |
| **설명**      | "전화번호 또는 이름으로 CRM에서 발신자를 찾습니다. 판매, 견적 또는 기존 거래에 관한 통화 시작 시 사용하세요." |
| **메서드**     | GET                                                                |
| **URL**     | `https://api.pipedrive.com/api/v2/persons/search`                  |
| **요청 헤더**   | `x-api-token`: API 토큰                                              |
| **쿼리 매개변수** | `term` (문자열, 필수): "발신자의 전화번호 또는 전체 이름(최소 2자)"                      |

### 거래 생성

| 필드          | 값                                                                                                                                                            |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **이름**      | `create_pipedrive_deal`                                                                                                                                      |
| **설명**      | "발신자가 견적을 요청하거나 구매하려 할 때 거래를 생성합니다. 제목에 발신자 이름을 포함하세요."                                                                                                      |
| **메서드**     | POST                                                                                                                                                         |
| **URL**     | `https://api.pipedrive.com/api/v2/deals`                                                                                                                     |
| **요청 헤더**   | `x-api-token`: API 토큰                                                                                                                                        |
| **본문 매개변수** | `title` (문자열, 필수): "발신자 이름과 요청 내용을 포함한 짧은 제목."  `person_id` (숫자): "`find_pipedrive_person`의 id입니다. 발신자를 찾지 못한 경우 생략하세요."  `value` (숫자): "발신자가 제시한 경우 거래 금액." |

### 후속 조치 예약

| 필드          | 값                                                                                                                                                                                                                              |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **이름**      | `create_pipedrive_followup`                                                                                                                                                                                                    |
| **설명**      | "발신자에게 후속 조치를 약속할 때마다 팀의 콜백을 예약합니다."                                                                                                                                                                                           |
| **메서드**     | POST                                                                                                                                                                                                                           |
| **URL**     | `https://api.pipedrive.com/api/v2/activities`                                                                                                                                                                                  |
| **요청 헤더**   | `x-api-token`: API 토큰                                                                                                                                                                                                          |
| **본문 매개변수** | `subject` (문자열, 필수): "예: Jane Doe에게 주방 견적 관련 콜백."  `type` (문자열, 필수): "항상 정확히 `call` 값으로 설정하세요."  `due_date` (문자열, 필수): "YYYY-MM-DD 형식의 후속 조치 날짜."  `note` (문자열, 필수): "발신자의 이름, 전화번호 및 요청 사항."  `deal_id` (숫자): "생성한 경우 거래 id." |

각 도구에서 **Enable**을 선택한 다음, 견적을 요청하는 통화로 [접수 담당자를 테스트하세요](/docs/ko/reception-ai/receptionist/testing).

## 제한 사항

웹훅 도구는 평면 값을 전송하지만 Pipedrive는 개인의 전화번호를 중첩 목록으로 저장합니다. 따라서 이 도구로는 전화번호가 포함된 새 연락처를 만들 수 없습니다. 대신 후속 조치의 메모에 발신자 번호가 저장됩니다. 연락처를 만들려면 [Zapier](/docs/ko/reception-ai/integrations/zapier)를 통해 Pipedrive의 **Create Person** 작업을 사용하세요.

## 문제 해결

| 문제               | 확인할 사항                                                                            |
| ---------------- | --------------------------------------------------------------------------------- |
| Pipedrive의 401   | 헤더 이름은 반드시 `x-api-token`이어야 하며 현재 토큰을 포함해야 합니다.                                   |
| 등록된 발신자를 찾을 수 없음 | Pipedrive는 저장된 형식 그대로 전화번호를 일치시킵니다. 번호를 하나의 형식으로 저장하거나 이름으로도 검색하세요.               |
| 후속 조치에 유형이 없음    | `call`은 Pipedrive 계정의 활동 유형이어야 합니다. **Company settings** → **Activities**를 확인하세요. |