Pipedrive 凭据#

你可以使用这些凭据来认证以下节点：

• Pipedrive
• Pipedrive Trigger

支持的认证方式#

• API token（API 令牌）
• OAuth2

相关资源#

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

使用 API 令牌#

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

• 一个 API 令牌（API Token）

获取你的 API 令牌的方法如下：

1. 打开你的 API 个人偏好设置。
2. 复制 你的个人 API 令牌（Your personal API token），并将其填入你在 n8n 中的凭据中。

如果你有多个公司账户，需要先选择正确的公司：

1. 点击你的账户名称，确认你正在查看正确的公司。
2. 然后选择 公司设置（Company Settings）。
3. 选择 个人偏好（Personal Preferences）。
4. 选择 API 标签页。
5. 复制 你的个人 API 令牌（Your personal API token），并将其填入你在 n8n 中的凭据中。

更多信息请参考 如何查找 API 令牌。

使用 OAuth2#

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

• 一个 客户端 ID（Client ID）
• 一个 客户端密钥（Client Secret）

要获取这两个信息，你需要注册一个新应用：

1. 在右上角选择你的个人资料名称。
2. 找到你的沙盒账户的公司名称，并选择 Developer Hub（开发者中心）。 没有开发者中心？ 如果你在账户下拉菜单中看不到 Developer Hub，请注册一个 开发者沙盒账户。
3. 选择 Create an app（创建应用）。
4. 选择 Create public app（创建公共应用）。此时将打开应用的 Basic info（基本信息）选项卡。
5. 为你的应用输入一个 App name（应用名称），例如 n8n integration。
6. 从 n8n 中复制 OAuth Redirect URL（OAuth 重定向 URL），并将其添加为该应用的 Callback URL（回调 URL）。
7. 选择 Save（保存）。此时将打开应用的 OAuth & access scopes（OAuth 与访问范围）选项卡。
8. 为你的应用开启适当的 Scopes（权限范围）。更多指导，请参考下方的 Pipedrive 节点权限范围 和 Pipedrive 触发器节点权限范围。
9. 复制 Client ID（客户端 ID）并将其填入你在 n8n 中的凭证信息。
10. 复制 Client Secret（客户端密钥）并将其填入你在 n8n 中的凭证信息。

请参考 注册公共应用 以获取更多信息。

Pipedrive 节点权限范围#

您为应用添加的权限范围（scopes）取决于在 n8n 中希望将其用于哪些节点，以及希望在这些节点上执行哪些操作。

Pipedrive 节点可能需要的权限范围：

activities:full 活动（Activity） | 创建 删除 更新 | Activities: Full Access | activities:full 交易（Deal） | 获取单个交易的数据 获取所有交易的数据 搜索交易 | Deals: Read only 或 Deals: Full Access | deals:read 或 deals:full 交易（Deal） | 创建 删除 复制 更新 | Deals: Full Access | deals:full 交易活动（Deal Activity） | 获取某交易的所有活动 | Activities: Read only 或 Activities: Full Access | activities:read 或 activities:full 交易产品（Deal Product） | 获取交易中的所有产品 | Products: Read Only 或 Products: Full Access | products:read 或 products:full 文件（File） | 下载文件 获取文件数据 | 参见下方说明 | 参见下方说明 文件（File） | 创建 删除 | 参见下方说明 | 参见下方说明 线索（Lead） | 获取单条线索数据 获取所有线索数据 | Leads: Read only 或 Leads: Full access | leads:read 或 leads:full 线索（Lead） | 创建 删除 更新 | Leads: Full access | leads:full 备注（Note） | 获取单条备注数据 获取所有备注数据 | 参见下方说明 | 参见下方说明 备注（Note） | 创建 删除 更新 | 参见下方说明 | 参见下方说明 组织（Organization） | 获取单个组织数据 获取所有组织数据 搜索 | Contacts: Read Only 或 Contacts: Full Access | contacts:read 或 contacts:full 组织（Organization） | 创建 删除 更新 | Contacts: Full Access | contacts:full 联系人（Person） | 获取单个联系人数据 获取所有联系人数据 搜索 | Contacts: Read Only 或 Contacts: Full Access | contacts:read 或 contacts:full 联系人（Person） | 创建 删除 更新 | Contacts: Full Access | contacts:full 产品（Product） | 获取所有产品数据 | Products: Read Only | products:read

文件与备注（Files and Notes）

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

• 文件（Files）关联到 交易（Deals）、活动（Activities）或联系人（Contacts）。
• 备注（Notes）关联到 交易（Deals）或联系人（Contacts）。

参考这些对象的作用域（scopes）。 Pipedrive 节点还支持自定义 API 调用。请根据你计划使用的自定义 API 调用添加相应的作用域。 更多信息请参阅 Scopes and permissions explanations（作用域与权限说明）。

Pipedrive Trigger 节点作用域#

Pipedrive Trigger 节点需要 Webhooks: Full access (webhooks:full) 作用域。