Skip to content

LinkedIn 凭证(LinkedIn credentials)#

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

🌐 You can use these credentials to authenticate the following nodes:

先决条件(Prerequisites)#

支持的身份验证方法(Supported authentication methods)#

  • 社区管理 OAuth2：如果你是新的 LinkedIn 用户或正在创建新的 LinkedIn 应用，请使用此方法。
  • OAuth2：对较旧的 LinkedIn 应用和用户账户使用此方法。

有关该服务的更多信息，请参阅 LinkedIn 的社区管理 API 文档。

🌐 Refer to LinkedIn's Community Management API documentation for more information about the service.

此凭证适用于 API 版本 202404。

🌐 This credential works with API version 202404.

使用社区管理 OAuth2(Using Community Management OAuth2)#

如果你是 LinkedIn 新用户或正在创建新的 LinkedIn 应用，请使用此方法。

🌐 Use this method if you're a new LinkedIn user or creating a new LinkedIn app.

要配置此凭证，你需要一个 LinkedIn 账户、一个 LinkedIn 公司页面，以及：

🌐 To configure this credential, you'll need a LinkedIn account, a LinkedIn Company Page, and:

  • 客户端 ID：在你创建新的开发者应用后生成。
  • 一个 客户端密钥：在你创建新的开发者应用后生成。

要创建新的开发者应用并设置凭据：

🌐 To create a new developer app and set up the credential:

  1. 登录 LinkedIn 并点击此链接 创建新的开发者应用。
  2. 为你的应用输入一个应用名称，例如 n8n integration。
  3. 对于 LinkedIn 页面，请输入 LinkedIn 公司页面 或使用 创建新的 LinkedIn 页面 链接即时创建一个。有关更多信息，请参阅 将应用与 LinkedIn 页面关联。
  4. 添加应用图标。
  5. 勾选此框以同意法律协议。
  6. 选择 创建应用。
  7. 这应该会打开产品选项卡。选择你想为你的应用启用的产品/API。为了使 LinkedIn 节点工作，你必须包括并配置：
    • 分享到领英
    • 使用 OpenID Connect 通过 LinkedIn 登录
    • 广告 API（如果作为组织账户而非个人使用）
  8. 一旦你请求了所需产品的访问权限，请打开 Auth 标签。
  9. 复制 客户端 ID 并将其输入到你的 n8n 凭证中。10. 点击图标 复制 主要客户端密钥。将其作为 客户端密钥 输入到你的 n8n 凭证中。

从组织账号发布

要以组织身份发布，你需要让你的应用通过 LinkedIn 的社区管理应用审核流程。

有关范围和权限的更多信息，请参阅 获取 LinkedIn API 访问权限。

🌐 Refer to Getting Access to LinkedIn APIs for more information on scopes and permissions.

使用潜在客户同步 API(Using Lead Sync API)#

LinkedIn 的 Lead Sync API 允许你将来自 LinkedIn 广告和自然表单（公司页面、活动、产品）的潜在客户表单响应通过 webhook 同步到你的 n8n 工作流。这需要更多的设置和 LinkedIn 的批准。

🌐 LinkedIn's Lead Sync API allows you to sync lead form responses from LinkedIn ads and organic forms (company pages, events, products) to your n8n workflows using webhooks. This requires more setup and LinkedIn approval.

先决条件(Prerequisites)#

  • 一个 LinkedIn 开发者应用（使用上述步骤创建）
  • 你的公司 LinkedIn 账户已链接到你的开发者应用
  • 访问 Lead Sync API 产品（需要单独申请）
  • 一个公开可访问的 HTTPS webhook URL（你的 n8n 工作流 webhook URL）

安装过程(Setup process)#

  1. 创建一个 LinkedIn 开发者应用，按照上面社区管理 OAuth2 或 OAuth2 部分的步骤进行操作。
  2. 关联你的公司账户：向 LinkedIn 提交请求，将你的公司 LinkedIn 账户关联到你的开发者应用。这可以通过 LinkedIn 开发者门户完成。
  3. 请求潜在客户同步 API 访问： - 在你的 LinkedIn 开发者应用 中，导航到 产品 标签。 - 请求访问 Lead Sync API 产品。
  4. 配置权限：确保你的应用具有 r_marketing_leadgen_automation 权限，该权限允许你： - 访问已认证会员的广告表单和自然表单 - 访问表单响应（潜在客户） - 管理潜在客户通知（网络钩子）
  5. 在 n8n 中设置 webhook： - 在 n8n 中创建一个带有 Webhook 触发节点的工作流。 - 从 n8n 复制网页钩子 URL（必须是 HTTPS）。 - Webhook URL 必须可以公开访问，并且接受不需要额外授权的 POST 请求。

  6. 处理挑战请求： - 当你在 LinkedIn 注册你的 webhook 时，LinkedIn 会发送一个带有 challengeCode 查询参数的 GET 请求。 - 你的 n8n 工作流必须在 3 秒内响应，并包含以下 JSON 数据：

    • challengeCode：LinkedIn 发送的验证码
    • challengeResponse：使用你的应用客户端密钥作为密钥，对挑战代码进行 HMAC-SHA256 哈希
    • 示例响应格式：
    1
2
3
4
    {
  "challengeCode": "890e4665-4dfe-4ab1-b689-ed553bceeed0",
  "challengeResponse": "27b1d19678542072a7f1d0ce845d0c78cec22567f413697e25648f44fa3d1514"
}

  7. 创建潜在客户通知订阅: - 使用 leadNotifications API 创建一个 webhook 订阅。 - 你可以创建不同级别的订阅：

    • 所有者级别：接收组织或赞助账户下所有表单的通知
    • 表单级别：仅接收特定表单的通知
    • 相关实体级别：接收与特定实体（广告、活动等）相关联的表单通知
    • 示例 API 调用：
    1
2
3
4
5
6
    POST https://api.linkedin.com/rest/leadNotifications
{
  "webhook": "https://your-n8n-instance.com/webhook/linkedin-leads",
  "owner": {"organization": "urn:li:organization:123456"},
  "leadType": "SPONSORED"
}

  8. 获取潜在客户表单回复: - 一旦设置了 webhook 通知，当有新的潜在客户提交时，你将会收到通知。 - 使用 leadFormResponses API 获取实际的潜在客户数据：

    1
    GET https://api.linkedin.com/rest/leadFormResponses?owner=(organization:urn%3Ali%3Aorganization%3A123456)&leadType=(leadType:SPONSORED)&q=owner

铅类型(Lead types)#

LinkedIn支持可以同步的不同类型的潜在客户：

🌐 LinkedIn supports different types of leads that can be synced:

  • 赞助：通过赞助广告收集的潜在客户
  • 公司：从公司页面收集的潜在客户
  • 活动：从活动页面收集的潜在客户
  • 组织产品：从组织产品页面收集的潜在客户

Webhook 验证(Webhook validation)#

LinkedIn 会每隔 2 小时定期重新验证 webhook 端点。如果连续 3 次验证失败，该端点将被阻止，事件将不再发送。请确保你的 webhook：

🌐 LinkedIn periodically re-validates webhook endpoints every 2 hours. If validation fails 3 times in a row, the endpoint will be blocked and events will no longer be sent. Ensure your webhook:

  • 在3秒内响应挑战请求
  • 对所有通知返回 2xx HTTP 状态码
  • 使用 HTTPS（不支持 HTTP URL）
  • 无需身份验证即可公开访问

安全(Security)#

要验证通知是否来自 LinkedIn：

🌐 To verify that notifications are from LinkedIn:

  1. 检查 POST 请求中的 X-LI-Signature 头
  2. 此头包含使用你的应用客户端密钥计算的 JSON 编码 POST 请求体的 HMAC-SHA256 哈希
  3. 在你那边计算相同的哈希并验证其是否匹配
  4. 丢弃任何签名不匹配的事件

有关更多信息，请参阅 LinkedIn 的 Lead Sync API 文档 和 Webhook 验证指南。

🌐 Refer to LinkedIn's Lead Sync API documentation and Webhook Validation guide for more information.

使用 OAuth2(Using OAuth2)#

仅将此方法用于旧版 LinkedIn 应用和用户账户。

🌐 Only use this method for older LinkedIn apps and user accounts.

Note for n8n Cloud users

Cloud users don't need to provide connection details. Select Connect my account to connect through your browser.

所有用户必须选择：

🌐 All users must select:

  • 组织支持：如果启用，凭证请求使用 w_organization_social 范围以组织身份发布权限。
  • 传统：如果启用，该凭证将使用 r_liteprofile 和 r_emailaddress 的传统权限范围，而不是较新的 profile 和 email 权限范围。

如果你正在自托管 n8n，你需要通过创建一个新的开发者应用从零配置 OAuth2：

🌐 If you're self-hosting n8n, you'll need to configure OAuth2 from scratch by creating a new developer app:

  1. 登录 LinkedIn 并点击此链接 创建新的开发者应用。
  2. 为你的应用输入一个应用名称，例如 n8n integration。
  3. 对于 LinkedIn 页面，请输入 LinkedIn 公司页面 或使用 创建新的 LinkedIn 页面 链接即时创建一个。有关更多信息，请参阅 将应用与 LinkedIn 页面关联。
  4. 添加应用图标。
  5. 勾选此框以同意法律协议。
  6. 选择 创建应用。
  7. 这应该会打开 产品 选项卡。选择你希望为应用启用的产品/API。为了使 LinkedIn 节点正常工作，你必须包含：
    • 分享到领英
    • 使用 OpenID Connect 通过 LinkedIn 登录
  8. 一旦你请求了所需产品的访问权限，请打开 Auth 标签。
  9. 复制 客户端 ID 并将其输入到你的 n8n 凭证中。10. 点击图标 复制 主要客户端密钥。将其作为 客户端密钥 输入到你的 n8n 凭证中。

从组织账号发布

要以组织身份发布，你需要让你的应用通过 LinkedIn 的社区管理应用审核流程。

有关范围和权限的更多信息，请参阅 获取 LinkedIn API 访问权限。

🌐 Refer to Getting Access to LinkedIn APIs for more information on scopes and permissions.