> 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

借助以下 [webhook 工具](/docs/zh/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/zh/reception-ai/receptionist/testing)。

## 限制

Webhook 工具发送扁平值，而 Pipedrive 将联系人的电话号码存储为嵌套列表。因此，这些工具无法创建包含电话号码的新联系人。后续跟进的备注会保留来电者号码。要创建联系人，请通过 [Zapier](/docs/zh/reception-ai/integrations/zapier) 使用 Pipedrive 的 **Create Person** 操作。

## 故障排除

| 问题               | 检查内容                                                                     |
| ---------------- | ------------------------------------------------------------------------ |
| Pipedrive 返回 401 | 请求头必须命名为 `x-api-token`，并且包含有效令牌。                                         |
| 未找到已知来电者         | Pipedrive 会按已存储的电话号码进行匹配。请统一号码格式，或同时按姓名搜索。                               |
| 后续跟进没有类型         | `call` 必须是 Pipedrive 账户中的活动类型。请检查 **Company settings** → **Activities**。 |