Files
sim/apps/docs/content/docs/ja/tools/pipedrive.mdx
2025-12-11 21:12:23 -08:00

437 lines
20 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
title: Pipedrive
description: Pipedrive CRMとの連携
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="pipedrive"
color="#2E6936"
/>
{/* MANUAL-CONTENT-START:intro */}
[Pipedrive](https://www.pipedrive.com)は、営業チームがリードを管理し、商談を追跡し、セールスパイプラインを最適化するために設計された強力な営業重視のCRMプラットフォームです。シンプルさと効果を念頭に置いて構築されたPipedriveは、直感的なビジュアルパイプライン管理と実用的な営業インサイトにより、世界中の営業プロフェッショナルや成長中の企業に愛用されています。
Pipedriveは、リード獲得から商談成立までの営業プロセス全体を管理するための包括的なツールセットを提供しています。強力なAPIと広範な統合機能により、Pipedriveは営業チームが繰り返し行うタスクを自動化し、データの一貫性を維持し、最も重要なこと—商談の成立—に集中できるようにします。
Pipedriveの主な機能には以下が含まれます
- ビジュアルセールスパイプライン:カスタマイズ可能な営業段階を通じて商談を管理するための直感的なドラッグアンドドロップインターフェース
- リード管理:潜在的な機会を獲得、評価、変換するための包括的なリードインボックス
- 活動追跡:通話、会議、メール、タスクをスケジュールし追跡するための洗練されたシステム
- プロジェクト管理:販売後の顧客成功と納品のための組み込みプロジェクト追跡機能
- メール統合CRM内でのシームレスなコミュニケーション追跡のためのネイティブメールボックス統合
Simでは、PipedriveインテグレーションによりAIエージェントがセールスワークフローとシームレスに連携できます。これにより、AIを活用した営業プロセスの一部として、リード評価の自動化、商談の作成と更新、活動のスケジューリング、パイプライン管理などの機会が生まれます。このインテグレーションにより、エージェントは商談、リード、活動、プロジェクトをプログラムで作成、取得、更新、管理できるようになり、インテリジェントな営業自動化を促進し、重要な顧客情報が適切に追跡され対応されることを保証します。SimとPipedriveを連携させることで、セールスパイプラインの可視性を維持し、定型的なCRMタスクを自動化し、リードをインテリジェントに評価し、商談の取りこぼしを防止するAIエージェントを構築できます—これにより営業チームの生産性を向上させ、一貫した収益成長を促進します。
{/* MANUAL-CONTENT-END */}
## 使用手順
Pipedriveをワークフローに統合します。強力なCRM機能を使用して、商談、連絡先、セールスパイプライン、プロジェクト、活動、ファイル、コミュニケーションを管理します。
## ツール
### `pipedrive_get_all_deals`
オプションのフィルターを使用してPipedriveからすべての商談を取得する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `status` | string | いいえ | 特定のステータスの商談のみを取得します。値: open, won, lost。省略した場合、削除されていないすべての商談が返されます |
| `person_id` | string | いいえ | 指定された人物にリンクされた商談のみが返されます |
| `org_id` | string | いいえ | 指定された組織にリンクされた商談のみが返されます |
| `pipeline_id` | string | いいえ | 指定されたパイプラインの商談のみが返されます |
| `updated_since` | string | いいえ | 設定した場合、この時間以降に更新された商談のみが返されます。形式: 2025-01-01T10:20:00Z |
| `limit` | string | いいえ | 返す結果の数(デフォルト: 100、最大: 500 |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `deals` | array | Pipedriveからの取引オブジェクトの配列 |
| `metadata` | object | 操作メタデータ |
| `success` | boolean | 操作成功ステータス |
### `pipedrive_get_deal`
特定の取引に関する詳細情報を取得する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `deal_id` | string | はい | 取得する取引のID |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `deal` | object | 詳細情報を含む取引オブジェクト |
| `metadata` | object | 操作メタデータ |
| `success` | boolean | 操作成功ステータス |
### `pipedrive_create_deal`
Pipedriveで新しい取引を作成する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `title` | string | はい | 取引のタイトル |
| `value` | string | いいえ | 取引の金銭的価値 |
| `currency` | string | いいえ | 通貨コードUSD、EUR |
| `person_id` | string | いいえ | この取引に関連する人物のID |
| `org_id` | string | いいえ | この取引に関連する組織のID |
| `pipeline_id` | string | いいえ | この取引を配置するパイプラインのID |
| `stage_id` | string | いいえ | この取引を配置するステージのID |
| `status` | string | いいえ | 取引のステータスopen、won、lost |
| `expected_close_date` | string | いいえ | YYYY-MM-DD形式の予想クローズ日 |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `deal` | object | 作成された取引オブジェクト |
| `metadata` | object | 操作メタデータ |
| `success` | boolean | 操作成功ステータス |
### `pipedrive_update_deal`
Pipedriveの既存のディールを更新する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `deal_id` | string | はい | 更新するディールのID |
| `title` | string | いいえ | ディールの新しいタイトル |
| `value` | string | いいえ | ディールの新しい金銭的価値 |
| `status` | string | いいえ | 新しいステータス: open, won, lost |
| `stage_id` | string | いいえ | ディールの新しいステージID |
| `expected_close_date` | string | いいえ | YYYY-MM-DD形式の新しい予定終了日 |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `deal` | object | 更新された取引オブジェクト |
| `metadata` | object | 操作メタデータ |
| `success` | boolean | 操作成功ステータス |
### `pipedrive_get_files`
オプションのフィルターを使用してPipedriveからファイルを取得する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `deal_id` | string | いいえ | ディールIDでファイルをフィルタリング |
| `person_id` | string | いいえ | 担当者IDでファイルをフィルタリング |
| `org_id` | string | いいえ | 組織IDでファイルをフィルタリング |
| `limit` | string | いいえ | 返す結果の数(デフォルト: 100、最大: 500 |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `files` | array | Pipedriveからのファイルオブジェクトの配列 |
| `metadata` | object | 操作メタデータ |
| `success` | boolean | 操作成功ステータス |
### `pipedrive_get_mail_messages`
Pipedriveメールボックスからメールスレッドを取得する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `folder` | string | いいえ | フォルダーでフィルタリング: inbox, drafts, sent, archive \(デフォルト: inbox\) |
| `limit` | string | いいえ | 返す結果の数 \(デフォルト: 50\) |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `messages` | array | Pipedriveメールボックスからのメールスレッドオブジェクトの配列 |
| `metadata` | object | 操作メタデータ |
| `success` | boolean | 操作成功ステータス |
### `pipedrive_get_mail_thread`
特定のメールスレッドからすべてのメッセージを取得する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `thread_id` | string | はい | メールスレッドのID |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `messages` | array | スレッドからのメールメッセージオブジェクトの配列 |
| `metadata` | object | スレッドIDを含む操作メタデータ |
| `success` | boolean | 操作成功ステータス |
### `pipedrive_get_pipelines`
Pipedriveからすべてのパイプラインを取得する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `sort_by` | string | いいえ | ソートするフィールド: id, update_time, add_time \(デフォルト: id\) |
| `sort_direction` | string | いいえ | ソート方向: asc, desc \(デフォルト: asc\) |
| `limit` | string | いいえ | 返す結果の数 \(デフォルト: 100, 最大: 500\) |
| `cursor` | string | いいえ | ページネーション用、次のページの最初の項目を表すマーカー |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `pipelines` | array | Pipedriveからのパイプラインオブジェクトの配列 |
| `metadata` | object | 操作メタデータ |
| `success` | boolean | 操作成功ステータス |
### `pipedrive_get_pipeline_deals`
特定のパイプラインにあるすべての取引を取得する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `pipeline_id` | string | はい | パイプラインのID |
| `stage_id` | string | いいえ | パイプライン内の特定のステージでフィルタリング |
| `status` | string | いいえ | 取引ステータスでフィルタリング: open、won、lost |
| `limit` | string | いいえ | 返す結果の数(デフォルト: 100、最大: 500 |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `deals` | array | パイプラインからの取引オブジェクトの配列 |
| `metadata` | object | パイプラインIDを含む操作メタデータ |
| `success` | boolean | 操作成功ステータス |
### `pipedrive_get_projects`
Pipedriveからすべてのプロジェクトまたは特定のプロジェクトを取得する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `project_id` | string | いいえ | オプション: 取得する特定のプロジェクトのID |
| `status` | string | いいえ | プロジェクトステータスでフィルタリング: open、completed、deletedすべてリスト表示する場合のみ |
| `limit` | string | いいえ | 返す結果の数(デフォルト: 100、最大: 500、すべてリスト表示する場合のみ |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `projects` | array | プロジェクトオブジェクトの配列(すべてをリスト表示する場合) |
| `project` | object | 単一のプロジェクトオブジェクトproject_idが提供される場合 |
| `metadata` | object | 操作メタデータ |
| `success` | boolean | 操作成功ステータス |
### `pipedrive_create_project`
Pipedriveで新しいプロジェクトを作成する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `title` | string | はい | プロジェクトのタイトル |
| `description` | string | いいえ | プロジェクトの説明 |
| `start_date` | string | いいえ | プロジェクト開始日YYYY-MM-DD形式 |
| `end_date` | string | いいえ | プロジェクト終了日YYYY-MM-DD形式 |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `project` | object | 作成されたプロジェクトオブジェクト |
| `metadata` | object | 操作メタデータ |
| `success` | boolean | 操作成功ステータス |
### `pipedrive_get_activities`
オプションのフィルターを使用してPipedriveからアクティビティタスクを取得する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `deal_id` | string | いいえ | 取引IDでアクティビティをフィルタリング |
| `person_id` | string | いいえ | 担当者IDでアクティビティをフィルタリング |
| `org_id` | string | いいえ | 組織IDでアクティビティをフィルタリング |
| `type` | string | いいえ | アクティビティタイプでフィルタリング(通話、会議、タスク、期限、メール、ランチ) |
| `done` | string | いいえ | 完了ステータスでフィルタリング0は未完了、1は完了 |
| `limit` | string | いいえ | 返す結果の数デフォルト100、最大500 |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `activities` | array | Pipedriveからのアクティビティオブジェクトの配列 |
| `metadata` | object | 操作メタデータ |
| `success` | boolean | 操作成功ステータス |
### `pipedrive_create_activity`
Pipedriveで新しいアクティビティタスクを作成する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `subject` | string | はい | アクティビティの件名/タイトル |
| `type` | string | はい | アクティビティタイプ: call, meeting, task, deadline, email, lunch |
| `due_date` | string | はい | YYYY-MM-DD形式の期日 |
| `due_time` | string | いいえ | HH:MM形式の期限時間 |
| `duration` | string | いいえ | HH:MM形式の所要時間 |
| `deal_id` | string | いいえ | 関連付けるディールのID |
| `person_id` | string | いいえ | 関連付ける人物のID |
| `org_id` | string | いいえ | 関連付ける組織のID |
| `note` | string | いいえ | アクティビティのメモ |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `activity` | object | 作成されたアクティビティオブジェクト |
| `metadata` | object | 操作メタデータ |
| `success` | boolean | 操作成功ステータス |
### `pipedrive_update_activity`
Pipedriveで既存のアクティビティタスクを更新する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `activity_id` | string | はい | 更新するアクティビティのID |
| `subject` | string | いいえ | アクティビティの新しい件名/タイトル |
| `due_date` | string | いいえ | YYYY-MM-DD形式の新しい期日 |
| `due_time` | string | いいえ | HH:MM形式の新しい期限時間 |
| `duration` | string | いいえ | HH:MM形式の新しい所要時間 |
| `done` | string | いいえ | 完了としてマーク: 0は未完了、1は完了 |
| `note` | string | いいえ | アクティビティの新しいメモ |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `activity` | object | 更新されたアクティビティオブジェクト |
| `metadata` | object | 操作メタデータ |
| `success` | boolean | 操作成功ステータス |
### `pipedrive_get_leads`
Pipedriveからすべてのリードまたは特定のリードを取得する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `lead_id` | string | いいえ | オプション取得する特定のリードのID |
| `archived` | string | いいえ | アクティブなリードの代わりにアーカイブされたリードを取得 |
| `owner_id` | string | いいえ | オーナーユーザーIDでフィルタリング |
| `person_id` | string | いいえ | 個人IDでフィルタリング |
| `organization_id` | string | いいえ | 組織IDでフィルタリング |
| `limit` | string | いいえ | 返す結果の数デフォルト100、最大500 |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `leads` | array | リード オブジェクトの配列(すべてをリスト表示する場合) |
| `lead` | object | 単一のリード オブジェクトlead_id が提供される場合) |
| `metadata` | object | 操作メタデータ |
| `success` | boolean | 操作成功ステータス |
### `pipedrive_create_lead`
Pipedriveに新しいリードを作成する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `title` | string | はい | リードの名前 |
| `person_id` | string | いいえ | 個人のIDorganization_idが提供されない限り必須 |
| `organization_id` | string | いいえ | 組織のIDperson_idが提供されない限り必須 |
| `owner_id` | string | いいえ | リードを所有するユーザーのID |
| `value_amount` | string | いいえ | 潜在的な価値の金額 |
| `value_currency` | string | いいえ | 通貨コードUSD、EUR |
| `expected_close_date` | string | いいえ | YYYY-MM-DD形式の予想クローズ日 |
| `visible_to` | string | いいえ | 可視性1オーナーとフォロワー、3会社全体 |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `lead` | object | 作成されたリードオブジェクト |
| `metadata` | object | 操作メタデータ |
| `success` | boolean | 操作成功ステータス |
### `pipedrive_update_lead`
Pipedriveの既存リードを更新する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `lead_id` | string | はい | 更新するリードのID |
| `title` | string | いいえ | リードの新しい名前 |
| `person_id` | string | いいえ | 新しい担当者ID |
| `organization_id` | string | いいえ | 新しい組織ID |
| `owner_id` | string | いいえ | 新しいオーナーユーザーID |
| `value_amount` | string | いいえ | 新しい金額 |
| `value_currency` | string | いいえ | 新しい通貨コードUSD、EUR |
| `expected_close_date` | string | いいえ | YYYY-MM-DD形式の新しい予定クローズ日 |
| `is_archived` | string | いいえ | リードをアーカイブするtrueまたはfalse |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `lead` | object | 更新されたリードオブジェクト |
| `metadata` | object | 操作メタデータ |
| `success` | boolean | 操作成功ステータス |
### `pipedrive_delete_lead`
Pipedriveから特定のリードを削除する
#### 入力
| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `lead_id` | string | はい | 削除するリードのID |
#### 出力
| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `data` | object | 削除確認データ |
| `metadata` | object | 操作メタデータ |
| `success` | boolean | 操作成功ステータス |
## 注意事項
- カテゴリー: `tools`
- タイプ: `pipedrive`