Pipedrive 凭证#

您可以使用这些凭证来验证以下节点：

支持的认证方式#

API 令牌
OAuth2

使用 API 令牌#

要配置此凭证，您需要一个 Pipedrive 账户和：

一个 API 令牌

获取 API 令牌的步骤：

打开您的 API 个人偏好设置。
复制 您的个人 API 令牌 并输入到 n8n 凭证中。

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

选择您的账户名称并确保查看的是正确的公司。
然后选择 公司设置。
选择 个人偏好设置。
选择 API 选项卡。
复制 您的个人 API 令牌 并输入到 n8n 凭证中。

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

使用 OAuth2 认证#

要配置此凭证，您需要拥有一个 Pipedrive 开发者沙盒账户并准备以下信息：

客户端 ID
客户端密钥

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

点击右上角的个人资料名称
找到您的沙盒账户对应的公司名称，然后选择 开发者中心

没有开发者中心选项

如果在账户下拉菜单中看不到 开发者中心，请先注册一个开发者沙盒账户。
选择 创建应用
选择 创建公开应用，系统将打开应用的 基本信息 标签页
为您的应用输入一个 应用名称，例如 n8n 集成
从 n8n 复制 OAuth 重定向 URL 并添加为应用的 回调 URL
选择保存，系统将打开应用的 OAuth & 访问权限 标签页
为您的应用开启合适的 权限范围。具体指引请参考下方的 Pipedrive 节点权限范围和 Pipedrive 触发器节点权限范围
复制 客户端 ID 并填入您的 n8n 凭证
复制 客户端密钥 并填入您的 n8n 凭证

更多信息请参阅注册公开应用。

Pipedrive 节点权限范围#

您需要为应用添加的权限范围取决于您在 n8n 中想要使用的节点以及您希望通过这些节点完成的操作。

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

对象	节点操作	界面显示范围	实际权限范围
活动	获取单个活动数据获取所有活动数据	活动：只读或活动：完全访问	`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 调用添加相关权限范围。

更多信息请参考权限范围与权限说明。

Pipedrive Trigger 节点所需权限范围#

Pipedrive Trigger 节点需要 Webhooks: 完全访问 (webhooks:full) 权限范围。