Skip to content

Pipedrive 凭据(Pipedrive credentials)#

你可以使用以下凭据验证以下节点：

🌐 You can use these credentials to authenticate the following nodes:

支持的身份验证方法(Supported authentication methods)#

  • API 令牌
  • OAuth2

有关该服务的更多信息，请参阅 Pipedrive 开发者文档。

🌐 Refer to Pipedrive's developer documentation for more information about the service.

使用 API 令牌(Using API token)#

要配置此凭证，你需要一个 Pipedrive 账户以及：

🌐 To configure this credential, you'll need a Pipedrive account and:

  • 一个 API 令牌

获取 API 令牌：

🌐 To get your API token:

  1. 打开你的 API 个人偏好。
  2. 复制 你的个人 API 令牌 并将其输入到你的 n8n 凭证中。

如果你有多家公司，请先选择正确的公司：

🌐 If you have multiple companies, you'll need to select the correct company first:

  1. 选择你的账户名称，并确保你正在查看正确的公司。
  2. 然后选择公司设置。
  3. 选择 个人偏好。
  4. 选择 API 选项卡。
  5. 复制 你的个人 API 令牌 并将其输入到你的 n8n 凭证中。

有关更多信息，请参阅 如何查找 API 令牌。

🌐 Refer to How to find the API token for more information.

使用 OAuth2(Using OAuth2)#

要配置此凭证，你需要一个 Pipedrive 开发者沙箱账户 以及：

🌐 To configure this credential, you'll need a Pipedrive developer sandbox account and:

  • 客户端 ID
  • 客户端密钥

要同时获取 API 密钥和应用 ID，你需要注册一个新应用：

🌐 To get both, you'll need to register a new app:

  1. 选择右上角的个人资料名称。

  2. 找到你的沙盒账户的公司名称并选择 开发者中心。

    没有开发者中心

    如果你在账户下拉菜单中看不到开发者中心，请注册一个开发者沙箱账户。

  3. 选择 创建应用。

  4. 选择 创建公开应用。应用的 基本信息 标签会打开。
  5. 为你的应用输入一个应用名称，例如 n8n integration。
  6. 从 n8n 复制 OAuth 重定向 URL 并将其添加为应用的 回调 URL。
  7. 选择 保存。应用的 OAuth 和访问权限 标签页将打开。
  8. 为你的应用开启适当的权限范围。请参阅下方的 Pipedrive 节点权限范围 和 Pipedrive 触发节点权限范围 获取更多指导。
  9. 复制 客户端 ID 并将其输入到你的 n8n 凭证中。
  10. 复制 客户端密钥 并将其输入到你的 n8n 凭证中。

有关更多信息，请参阅注册公共应用。

🌐 Refer to Registering a public app for more information.

Pipedrive 节点作用域(Pipedrive node scopes)#

你添加到应用的作用域取决于你希望在 n8n 中将其用于哪些节点以及你希望使用这些节点完成哪些操作。

🌐 The scopes you add to your app depend on which node(s) you want to use it for in n8n and what actions you want to complete with those.

你可能需要为 Pipedrive 节点使用的权限范围：

🌐 Scopes you may need for the Pipedrive node:

| 对象 | 节点操作 | 界面范围 | 实际范围 |

| --- | --- | --- | --- |

| 活动 | 获取某个活动的数据
获取所有活动的数据 | 活动：只读 或
活动：完全访问 | activities:read 或
activities:full |

| 活动 | 创建
删除
更新 | 活动：完全访问 | activities:full |

| 交易 | 获取交易数据
获取所有交易的数据
搜索交易 | 交易：只读 或
交易：完全访问 | deals:read 或
deals:full |

| 交易 | 创建
删除
复制
更新 | 交易：完全访问 | deals:full |

| 交易活动 | 获取交易的所有活动 | 活动：只读 或
活动：完全访问 | activities:read 或
activities:full |

| 交易产品 | 获取交易中的所有产品 | 产品：只读 或
产品：完全访问 | products:read 或
products:full |

| 文件 | 下载
获取文件数据 | 参见下方说明 | 参见下方说明 |

| 文件 | 创建
删除 | 参见下方说明 | 参见下方说明 |

| 潜在客户 | 获取潜在客户的数据
获取所有潜在客户的数据 | 潜在客户：只读 或
潜在客户：完全访问 | leads:read 或
leads:full |

| 潜在客户 | 创建
删除
更新 | 潜在客户：完全访问 | leads:full |

| 注释 | 获取注释数据
获取所有注释的数据 | 参阅下方注释 | 参阅下方注释 |

| 注释 | 创建
删除
更新 | 参见下方注释 | 参见下方注释 |

| 组织 | 获取某个组织的数据
获取所有组织的数据
搜索 | 联系人：只读 或
联系人：完全访问 | contacts:read 或
contacts:full |

| 组织 | 创建
删除
更新 | 联系人：完全访问 | contacts:full |

| 人员 | 获取某人的数据
获取所有人的数据
搜索 | 联系人：只读 或
联系人：完全访问 | contacts:read 或
contacts:full |

| 人员 | 创建
删除
更新 | 联系人：完全访问权限 | contacts:full |

| 产品 | 获取所有产品的数据 | 产品：只读 | products:read |

文件和注意

文件和注意的范围取决于它们关联的对象：

  • 文件关联于交易、活动或联系人。
  • 注意关联于交易或联系人。

请参考这些对象的范围。

Pipedrive 节点也支持自定义 API 调用。为你打算进行的任何自定义 API 调用添加相关权限范围。

🌐 The Pipedrive node also supports Custom API calls. Add relevant scopes for whatever custom API calls you intend to make.

有关更多信息，请参阅 范围和权限说明。

🌐 Refer to Scopes and permissions explanations for more information.

Pipedrive 触发器节点作用域(Pipedrive Trigger node scopes)#

Pipedrive 触发器 节点需要 Webhooks：完全访问 (webhooks:full) 权限。

🌐 The Pipedrive Trigger node requires the Webhooks: Full access (webhooks:full) scope.