> 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/ja/reception-ai/integrations/webhooks)を使うと、Receptionistは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** を選択し、見積もりを依頼する電話で[Receptionistをテスト](/docs/ja/reception-ai/receptionist/testing)します。

## 制限事項

Webhookツールはフラットな値を送信しますが、Pipedriveでは人物の電話番号がネストされたリストとして保存されます。そのため、これらのツールでは電話番号付きの新しい連絡先を作成できません。代わりに、フォローアップのメモに発信者の番号を保存します。連絡先を作成するには、[Zapier](/docs/ja/reception-ai/integrations/zapier)経由でPipedriveの **Create Person** アクションを使用してください。

## トラブルシューティング

| 問題             | 確認事項                                                                                           |
| -------------- | ---------------------------------------------------------------------------------------------- |
| Pipedriveから401 | ヘッダー名を`x-api-token`とし、有効なトークンを設定する必要があります。                                                     |
| 既知の発信者が見つからない  | Pipedriveは保存されている形式で電話番号を照合します。番号を同じ形式で保存するか、名前でも検索してください。                                     |
| フォローアップにタイプがない | Pipedriveアカウントで`call`がアクティビティタイプになっている必要があります。**Company settings** → **Activities** を確認してください。 |