跳到主要内容

Pipedrive 凭据#

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

支持的认证方式#​

  • API 令牌
  • OAuth2

相关资源#​

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

使用 API 令牌#​

要配置此凭据，您需要拥有 Pipedrive 账户以及：

  • API 令牌

获取 API 令牌的步骤：

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

如果您拥有多家公司，需要先选择正确的公司：

  1. 选择您的账户名称，确保您正在查看正确的公司。
  2. 然后选择 公司设置。
  3. 选择 个人偏好设置。
  4. 选择 API 标签页。
  5. 复制 您的个人 API 令牌 并输入到 n8n 凭据中。

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

使用 OAuth2#​

要配置此凭据，您需要拥有 Pipedrive 开发者沙盒账户 以及：

  • 客户端 ID
  • 客户端密钥

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

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

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

    没有开发者中心？

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

  3. 选择 创建应用。

  4. 选择 创建公共应用。应用的 基本信息 标签页将打开。

  5. 为您的应用输入 应用名称，例如 n8n integration。

  6. 从 n8n 复制 OAuth 重定向 URL 并将其添加为应用的 回调 URL。

  7. 选择 保存。应用的 OAuth 和访问范围 标签页将打开。

  8. 为您的应用开启合适的 范围。更多指导请参阅下文的 Pipedrive 节点范围 和 Pipedrive Trigger 节点范围。

  9. 复制 客户端 ID 并输入到 n8n 凭据中。

  10. 复制 客户端密钥 并输入到 n8n 凭据中。

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

Pipedrive 节点范围#​

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

Pipedrive 节点可能需要的范围：

对象节点操作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

文件和备注

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

  • 文件关联到交易、活动或联系人。
  • 备注关联到交易或联系人。

请参阅这些对象的范围。

Pipedrive 节点还支持自定义 API 调用。请为您打算进行的任何自定义 API 调用添加相关范围。

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

Pipedrive Trigger 节点范围#​

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