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触发器节点权限范围。
- 复制客户端ID并输入到您的n8n凭证中。
- 复制客户端密钥并输入到您的n8n凭证中。
更多信息请参考注册公共应用。
Pipedrive节点作用域#
您为应用添加的权限范围取决于您想在n8n中使用哪些节点以及希望通过这些节点完成哪些操作。
你可能需要为Pipedrive节点设置的权限范围：
| 对象 | 节点操作 | UI范围 | 实际范围 |
|---|---|---|---|
| Activity | Get data of an activity Get data of all activities |
Activities: Read only or Activities: Full Access |
activities:read or activities:full |
| Activity | Create Delete Update |
Activities: Full Access | activities:full |
| Deal | Get data of a deal Get data of all deals Search a deal |
Deals: Read only or Deals: Full Access |
deals:read or deals:full |
| Deal | Create Delete Duplicate Update |
Deals: Full Access | deals:full |
| Deal Activity | Get all activities of a deal | Activities: Read only or Activities: Full Access |
activities:read or activities:full |
| Deal Product | Get all products in a deal | Products: Read Only or Products: Full Access |
products:read or products:full |
| 文件 | 下载 获取文件数据 |
请参阅下方说明 | 请参阅下方说明 |
| 文件 | 创建 删除 |
请参阅下方说明 | 请参阅下方说明 |
| Lead | Get data of a lead Get data of all leads |
Leads: Read only or Leads: Full access |
leads:read or leads:full |
| Lead | Create Delete Update |
Leads: Full access | leads:full |
| 注意 | 获取单个笔记的数据 获取所有笔记的数据 |
参考下方说明 | 参考下方说明 |
| 备注 | 创建 删除 更新 |
请参阅下方备注 | 请参阅下方备注 |
| Organization | Get data of an organization Get data of all organizations Search |
Contacts: Read Only or Contacts: Full Access |
contacts:read or contacts:full |
| Organization | Create Delete Update |
Contacts: Full Access | contacts:full |
| Person | Get data of a person Get data of all persons Search |
Contacts: Read Only or Contacts: Full Access |
contacts:read or contacts:full |
| Person | Create Delete Update |
Contacts: Full Access | contacts:full |
| Product | Get data of all products | Products: Read Only | products:read |
文件与笔记
文件和笔记的作用域取决于它们关联的对象：
- 文件与交易、活动或联系人相关。
- 备注关联到交易或联系人。
请参考这些对象的作用域。
Pipedrive节点还支持自定义API调用。为您打算进行的任何自定义API调用添加相关范围。
更多信息请参考Scopes and permissions explanations。
Pipedrive 触发器节点作用域#
Pipedrive Trigger 节点需要 Webhooks: 完全访问 (webhooks:full) 权限范围。
