Pipedrive | ElevenLabs Documentation

以下のWebhookツールを使うと、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をテストします。

制限事項

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

トラブルシューティング

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