n8n 中文文档

LinkedIn 凭据

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

先决条件

  • 创建一个 LinkedIn{:target=_blank .external-link} 账户。
  • 创建一个 LinkedIn Company Page{:target=_blank .external-link}。

支持的认证方式

  • Community Management OAuth2:如果您是新的 LinkedIn 用户或正在创建新的 LinkedIn 应用程序,请使用此方法。
  • OAuth2:对于较旧的 LinkedIn 应用程序和用户账户,请使用此方法。

相关资源

参考 LinkedIn 的 Community Management API 文档{:target=_blank .external-link}了解有关该服务的更多信息。

此凭据适用于 API 版本 202404。

使用社区管理 OAuth2

如果您是新的 LinkedIn 用户或正在创建新的 LinkedIn 应用程序,请使用此方法。

要配置此凭据,您需要一个 LinkedIn 账户、一个 LinkedIn Company Page 公司页面,以及:

  • 一个Client ID 客户端 ID:在您创建新的开发者应用程序后生成。
  • 一个Client Secret 客户端密钥:在您创建新的开发者应用程序后生成。

要创建新的开发者应用程序并设置凭据:

  1. 登录 LinkedIn 并选择此链接以创建新的开发者应用程序。
  2. 为您的应用输入 App name 应用名称,例如 n8n integration。
  3. 对于 LinkedIn Page 领英页面,输入 LinkedIn 公司页面 或使用 Create a new LinkedIn Page 创建一个新的 LinkedIn 页面 链接即时创建一个。请参阅将应用程序与 LinkedIn 页面关联 了解更多信息。
  4. 添加App logo 应用程序徽标。
  5. 勾选复选框以同意 Legal agreement 法律协议。
  6. 选择 Create app 创建应用程序。
  7. 这应该打开 Products 产品展示 选项卡。选择您想要为您的应用程序启用的产品/API。为了使 LinkedIn 节点正常工作,您必须包含并配置:
    • Share on LinkedIn 在领英上分享
    • Sign In with LinkedIn using OpenID Connect 使用 OpenID Connect 登录 LinkedIn
    • Advertising API 广告API(如果将其用作组织帐户而不是个人帐户)
  8. 请求访问所需产品后,打开 Auth 授权 选项卡。
  9. 复制 Client ID 客户ID 并将其输入您的 n8n 凭证中。
  10. 选择Copy 复制 和Primary Client Secret 主要客户秘密 图标。在您的 n8n 凭证中输入 Client Secret 客户秘密。

提示

Posting from organization accounts 从组织帐户发帖

要以组织身份发布,您需要将您的应用程序通过 LinkedIn 的 社区管理应用程序审核 流程。

参考获取 LinkedIn API 的访问权限{:target=_blank .external-link}了解有关作用域和权限的更多信息。

使用主同步 API

LinkedIn 的 Lead Sync API 允许您使用 Webhooks 将来自 LinkedIn 广告和有机表单(公司页面、活动、产品)的潜在客户表单响应同步到您的 n8n 工作流程。这需要更多设置和 LinkedIn 批准。

先决条件

  • LinkedIn 开发者应用程序(使用上述步骤创建)
  • 您公司的 LinkedIn 帐户链接到您的开发者应用程序
  • 访问 Lead Sync API 产品(需要单独申请)
  • 可公开访问的 HTTPS Webhook URL(您的 n8n 工作流程 Webhook URL)

设置过程

  1. Create a LinkedIn developer app 创建 LinkedIn 开发者应用程序 按照上述社区管理 OAuth2 或 OAuth2 部分中的步骤操作。
  2. Link your company account 关联您的公司帐户:向 LinkedIn 提交请求,将您公司的 LinkedIn 帐户链接到您的开发者应用程序。这是通过 LinkedIn 开发者门户完成的。 3.Request Lead Sync API access 请求 Lead Sync API 访问权限: - 在您的 LinkedIn 开发者应用 中,导航到 Products 产品展示 选项卡。 - 请求访问 Lead Sync API 线索同步 API 产品。
  3. Configure permissions 配置权限:确保您的应用具有 r_marketing_leadgen_automation 权限,该权限允许您: - 访问经过身份验证的会员的广告表单和有机表单 - 访问表单回复(线索) - 管理潜在客户通知(网络钩子) 5.Set up webhook in n8n 在 n8n 中设置 webhook: - 在 n8n 中创建带有 Webhook 触发器节点的工作流程。 - 从 n8n 复制 webhook URL(必须是 HTTPS)。 - Webhook URL 必须可公开访问并接受 POST 请求,无需额外的授权要求。 6.Handle the challenge request 处理挑战请求: - 当您向 LinkedIn 注册 Webhook 时,LinkedIn 将发送带有 challengeCode 查询参数的 GET 请求。 - 您的 n8n 工作流程必须在 3 秒内响应 JSON 有效负载,其中包含:
    • challengeCode:LinkedIn 发送的代码
    • challengeResponse:使用应用程序的客户端密钥作为密钥的质询代码的 HMAC-SHA256 哈希
    • 响应格式示例: json { "challengeCode": "890e4665-4dfe-4ab1-b689-ed553bceeed0", "challengeResponse": "27b1d19678542072a7f1d0ce845d0c78cec22567f413697e25648f44fa3d1514" }
  4. Create lead notification subscription 创建潜在客户通知订阅: - 使用 leadNotifications API 创建 Webhook 订阅。 - 您可以创建不同级别的订阅:
    • Owner level 业主级别:接收组织或赞助帐户下所有表格的通知
    • Form level 表单级别:仅接收特定表单的通知
    • Associated entity level 关联实体级别:接收附加到特定实体(广告、事件等)的表单的通知
    • API 调用示例: bash 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.Fetch lead form responses 获取潜在客户表单回复:
    • 设置 Webhook 通知后,您将在提交新潜在客户时收到通知。
    • 使用 leadFormResponses API 获取实际线索数据: bash GET https://api.linkedin.com/rest/leadFormResponses?owner=(organization:urn%3Ali%3Aorganization%3A123456)&leadType=(leadType:SPONSORED)&q=owner

引线类型

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

  • SPONSORED:从搜索广告中收集的潜在客户
  • COMPANY:从公司页面收集的潜在客户
  • EVENT:从活动页面收集的线索
  • ORGANIZATION_PRODUCT:从组织产品页面收集的潜在客户

Webhook 验证

LinkedIn 每 2 小时定期重新验证 Webhook 端点。如果连续 3 次验证失败,端点将被阻止,并且不再发送事件。确保您的网络钩子:

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

安全

要验证通知是否来自 LinkedIn:

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

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

Using OAuth2

仅对较旧的 LinkedIn 应用程序和用户账户使用此方法。

提示

Note for n8n Cloud users n8n 云用户注意事项

云用户不需要提供连接详细信息。选择 Connect my account 连接我的帐户 通过浏览器进行连接。

所有用户必须选择:

  • Organization Support 组织支持:如果开启,凭据请求使用 w_organization_social 作用域以组织身份发布的权限。
  • Legacy 传统模式:如果开启,凭据使用传统作用域 r_liteprofile 和 r_emailaddress,而不是较新的 profile 和 email 作用域。

如果您是自托管 n8n,则需要通过创建新的开发人员应用程序从头开始配置 OAuth2:

  1. 登录 LinkedIn 并选择此链接来创建新开发者应用程序{:target=_blank .external-link}。
  2. 为您的应用程序输入 App name,如 n8n integration。
  3. 对于 LinkedIn Page,输入 LinkedIn Company Page{:target=_blank .external-link} 或使用 Create a new LinkedIn Page 链接来即时创建一个。参考将应用程序与 LinkedIn 页面关联{:target=_blank .external-link}了解更多信息。
  4. 添加 App logo。
  5. 勾选复选框同意 Legal agreement。
  6. 选择 Create app。
  7. 这应该会打开 Products 选项卡。选择您想为应用程序启用的产品/API。要使 LinkedIn 节点正常工作,您必须包括:
    • Share on LinkedIn 在领英上分享
    • Sign In with LinkedIn using OpenID Connect 使用 OpenID Connect 登录 LinkedIn
  8. 一旦您请求访问所需的产品,打开 Auth 选项卡。
  9. 复制 Client ID 并将其输入到您的 n8n 凭据中。
  10. 选择图标来 Copy Primary Client Secret。将其作为 Client Secret 输入到您的 n8n 凭据中。

提示

Posting from organization accounts 从组织帐户发帖

要以组织身份发布,您需要将您的应用程序通过 LinkedIn 的 社区管理应用程序审核 流程。

参考获取 LinkedIn API 的访问权限{:target=_blank .external-link}了解有关作用域和权限的更多信息。

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。