Pipedrive 凭据#

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

支持的认证方法#

API token
OAuth2

使用 API token#

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

一个 API Token

获取您的 API 令牌：

打开您的 API Personal Preferences。
复制 Your personal API token 并将其输入到您的 n8n 凭据中。

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

选择您的账户名称并确保您正在查看正确的公司。
然后选择 Company Settings。
选择 Personal Preferences。
选择 API 标签页。
复制 Your personal API token 并将其输入到您的 n8n 凭据中。

参考如何找到 API 令牌了解更多信息。

使用 OAuth2#

要配置此凭据，您需要一个 Pipedrive 开发者沙盒账户和：

一个 Client ID 客户端 ID
一个 Client Secret 客户端密钥

要获取两者，您需要注册新应用：

选择右上角的您的个人资料名称。
找到您的沙盒账户的公司名称并选择 Developer Hub。

没有 Developer Hub

如果您在账户下拉菜单中没有看到 Developer Hub，请注册开发者沙盒账户。
选择 Create an app。
选择 Create public app。应用的 Basic info 标签页打开。
为您的应用输入 App name，如 n8n integration。
从 n8n 复制 OAuth Redirect URL 并将其添加为应用的 Callback URL。
选择 Save。应用的 OAuth & access scopes 标签页打开。
为您的应用开启适当的 Scopes。参考下面的 Pipedrive 节点作用域和 Pipedrive Trigger 节点作用域了解更多指导。
复制 Client ID 并将其输入到您的 n8n 凭据中。
复制 Client Secret 并将其输入到您的 n8n 凭据中。

参考注册公共应用了解更多信息。

Pipedrive 节点作用域#

您添加到应用的作用域取决于您想在 n8n 中使用它进行哪些节点以及您想用这些节点完成什么操作。

您可能需要为 Pipedrive 节点使用的作用域：

对象	节点操作	UI 作用域	实际作用域
Activity	Get data of an activity Get data of all activities	Activities: Read only 或 Activities: Full Access	`activities:read` 或 `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 或 Deals: Full Access	`deals:read` 或 `deals:full`
Deal	Create Delete Duplicate Update	Deals: Full Access	`deals:full`
Deal Activity	Get all activities of a deal	Activities: Read only 或 Activities: Full Access	`activities:read` 或 `activities:full`
Deal Product	Get all products in a deal	Products: Read Only 或 Products: Full Access	`products:read` 或 `products:full`
File	Download Get data of a file	参考下面的注释	参考下面的注释
File	Create Delete	参考下面的注释	参考下面的注释
Lead	Get data of a lead Get data of all leads	Leads: Read only 或 Leads: Full access	`leads:read` 或 `leads:full`
Lead	Create Delete Update	Leads: Full access	`leads:full`
Note	Get data of a note Get data of all notes	参考下面的注释	参考下面的注释
Note	Create Delete Update	参考下面的注释	参考下面的注释
Organization	Get data of an organization Get data of all organizations Search	Contacts: Read Only 或 Contacts: Full Access	`contacts:read` 或 `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 或 Contacts: Full Access	`contacts:read` 或 `contacts:full`
Person	Create Delete Update	Contacts: Full Access	`contacts:full`
Product	Get data of all products	Products: Read Only	`products:read`

Files 和 Notes

Files 和 Notes 的作用域取决于它们与哪个对象相关：

Files 与 Deals、Activities 或 Contacts 相关。
Notes 与 Deals 或 Contacts 相关。

参考这些对象的作用域。

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

参考作用域和权限说明了解更多信息。

Pipedrive Trigger 节点作用域#

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