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 客户端密钥:在您创建新的开发者应用程序后生成。
要创建新的开发者应用程序并设置凭据:
- 登录 LinkedIn 并选择此链接以创建新的开发者应用程序。
- 为您的应用输入 App name 应用名称,例如
n8n integration。 - 对于 LinkedIn Page 领英页面,输入 LinkedIn 公司页面 或使用 Create a new LinkedIn Page 创建一个新的 LinkedIn 页面 链接即时创建一个。请参阅将应用程序与 LinkedIn 页面关联 了解更多信息。
- 添加App logo 应用程序徽标。
- 勾选复选框以同意 Legal agreement 法律协议。
- 选择 Create app 创建应用程序。
- 这应该打开 Products 产品展示 选项卡。选择您想要为您的应用程序启用的产品/API。为了使 LinkedIn 节点正常工作,您必须包含并配置:
- Share on LinkedIn 在领英上分享
- Sign In with LinkedIn using OpenID Connect 使用 OpenID Connect 登录 LinkedIn
- Advertising API 广告API(如果将其用作组织帐户而不是个人帐户)
- 请求访问所需产品后,打开 Auth 授权 选项卡。
- 复制 Client ID 客户ID 并将其输入您的 n8n 凭证中。
- 选择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)
设置过程
- Create a LinkedIn developer app 创建 LinkedIn 开发者应用程序 按照上述社区管理 OAuth2 或 OAuth2 部分中的步骤操作。
- Link your company account 关联您的公司帐户:向 LinkedIn 提交请求,将您公司的 LinkedIn 帐户链接到您的开发者应用程序。这是通过 LinkedIn 开发者门户完成的。 3.Request Lead Sync API access 请求 Lead Sync API 访问权限: - 在您的 LinkedIn 开发者应用 中,导航到 Products 产品展示 选项卡。 - 请求访问 Lead Sync API 线索同步 API 产品。
- 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" }
- Create lead notification subscription 创建潜在客户通知订阅:
- 使用
leadNotificationsAPI 创建 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 通知后,您将在提交新潜在客户时收到通知。
- 使用
leadFormResponsesAPI 获取实际线索数据: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作用域以组织身份发布的权限。- 要使用此选项,您必须让您的应用程序通过 LinkedIn 的 Community Management App Review{:target=_blank .external-link} 流程。
- Legacy 传统模式:如果开启,凭据使用传统作用域
r_liteprofile和r_emailaddress,而不是较新的profile和email作用域。
如果您是自托管 n8n,则需要通过创建新的开发人员应用程序从头开始配置 OAuth2:
- 登录 LinkedIn 并选择此链接来创建新开发者应用程序{:target=_blank .external-link}。
- 为您的应用程序输入 App name,如
n8n integration。 - 对于 LinkedIn Page,输入 LinkedIn Company Page{:target=_blank .external-link} 或使用 Create a new LinkedIn Page 链接来即时创建一个。参考将应用程序与 LinkedIn 页面关联{:target=_blank .external-link}了解更多信息。
- 添加 App logo。
- 勾选复选框同意 Legal agreement。
- 选择 Create app。
- 这应该会打开 Products 选项卡。选择您想为应用程序启用的产品/API。要使 LinkedIn 节点正常工作,您必须包括:
- Share on LinkedIn 在领英上分享
- Sign In with LinkedIn using OpenID Connect 使用 OpenID Connect 登录 LinkedIn
- 一旦您请求访问所需的产品,打开 Auth 选项卡。
- 复制 Client ID 并将其输入到您的 n8n 凭据中。
- 选择图标来 Copy Primary Client Secret。将其作为 Client Secret 输入到您的 n8n 凭据中。
提示
Posting from organization accounts 从组织帐户发帖
要以组织身份发布,您需要将您的应用程序通过 LinkedIn 的 社区管理应用程序审核 流程。
参考获取 LinkedIn API 的访问权限{:target=_blank .external-link}了解有关作用域和权限的更多信息。