Pipedrive 凭据#
您可以使用此凭据验证以下节点：
支持的认证方式#
- API 令牌
- OAuth2
相关资源#
有关该服务的更多信息，请参阅 Pipedrive 开发者文档。
使用 API 令牌#
要配置此凭据，您需要拥有 Pipedrive 账户以及：
- API 令牌
获取 API 令牌的步骤：
- 打开您的 API 个人偏好设置。
- 复制 您的个人 API 令牌 并输入到 n8n 凭据中。
如果您拥有多家公司，需要先选择正确的公司：
- 选择您的账户名称，确保您正在查看正确的公司。
- 然后选择 公司设置。
- 选择 个人偏好设置。
- 选择 API 标签页。
- 复制 您的个人 API 令牌 并输入到 n8n 凭据中。
更多信息请参阅 如何查找 API 令牌。
使用 OAuth2#
要配置此凭据，您需要拥有 Pipedrive 开发者沙盒账户 以及：
- 客户端 ID
- 客户端密钥
要获取这两项信息，您需要注册新应用：
-
在右上角选择您的个人资料名称。
-
找到您的沙盒账户的公司名称并选择 开发者中心。
没有开发者中心？
如果在账户下拉菜单中看不到 开发者中心，请注册 开发者沙盒账户。
-
选择 创建应用。
-
选择 创建公共应用。应用的 基本信息 标签页将打开。
-
为您的应用输入 应用名称，例如
n8n integration。 -
从 n8n 复制 OAuth 重定向 URL 并将其添加为应用的 回调 URL。
-
选择 保存。应用的 OAuth 和访问范围 标签页将打开。
-
为您的应用开启合适的 范围。更多指导请参阅下文的 Pipedrive 节点范围 和 Pipedrive Trigger 节点范围。
-
复制 客户端 ID 并输入到 n8n 凭据中。
-
复制 客户端密钥 并输入到 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) 范围。