Skip to content

Pipedrive 凭据#

¥Pipedrive credentials

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

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

支持的身份验证方法#

¥Supported authentication methods

  • API 令牌

¥API token

  • OAuth2

相关资源#

¥Related resources

有关服务的更多信息，请参阅 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 令牌

¥An API Token

获取 API 令牌：

¥To get your API token:

  1. 打开 API 个人身份验证首选项。

¥Open your API Personal Preferences. 2. 复制你的个人 API 令牌，并将其输入到你的 n8n 凭据中。

¥Copy Your personal API token and enter it in your n8n credential.

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

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

  1. 选择你的账户名称，并确保你正在查看正确的公司。

¥Select your account name and be sure you're viewing the correct company. 2. 然后选择“公司设置”。

¥Then select Company Settings. 3. 选择“个人偏好设置”。

¥Select Personal Preferences. 4. 选择“API”选项卡。

¥Select the API tab. 5. 复制你的个人 API 令牌，并将其输入到你的 n8n 凭据中。

¥Copy Your personal API token and enter it in your n8n credential.

有关更多信息，请参阅 如何查找 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

¥A Client ID

  • 客户端密钥：

¥A Client Secret

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

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

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

¥Select your profile name in the upper right corner.

  1. 找到你的沙盒账户的公司名称，然后选择“开发者中心”。

¥Find the company name of your sandbox account and select Developer Hub.

No Developer Hub

1
If you don't see **Developer Hub** in your account dropdown, sign up for a [developer sandbox account](https://developers.pipedrive.com/).
  1. 选择“创建应用”。

¥Select Create an app. 4. 选择“创建公共应用”。打开应用的“基本信息”选项卡。

¥Select Create public app. The app's Basic info tab opens. 5. 输入你的应用名称，例如 n8n integration。

¥Enter an App name for your app, like n8n integration. 6. 从 n8n 复制 OAuth 重定向 URL，并将其添加为应用的回调 URL。

¥Copy the OAuth Redirect URL from n8n and add it as the app's Callback URL. 7. 选择“保存”。打开应用的“OAuth 和访问范围”选项卡。

¥Select Save. The app's OAuth & access scopes tab opens. 8. 为你的应用启用相应的权限范围。请参阅下面的 Pipedrive 节点作用域 和 Pipedrive 触发器节点作用域 获取更多指导。

¥Turn on appropriate Scopes for your app. Refer to Pipedrive node scopes and Pipedrive Trigger node scopes below for more guidance. 9. 复制客户端 ID，并将其作为你的 n8n 客户端 ID 输入。

¥Copy the Client ID and enter it in your n8n credential. 10. 复制客户端密钥并将其输入到你的 n8n 凭据中。

1
¥Copy the **Client Secret** and enter it in your n8n credential.

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

¥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:

对象 节点操作 UI 范围 实际范围
活动 获取活动的数据
获取所有活动的数据		 活动只读或
活动：完全访问权限		 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

Files and Notes

文件和注意的作用域取决于它们关联的对象：

¥The scopes for Files and Notes depend on which object they relate to:

  • 文件与交易、活动或联系人相关。

¥Files relate to Deals, Activities, or Contacts.

  • 注释与交易或联系人相关。

¥Notes relate to Deals or Contacts.

请参阅这些对象的作用域。

¥Refer to those objects' scopes.

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 Trigger 节点需要 Webhooks：完全访问权限 (webhooks:full) 范围。

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