对 AWS 合作伙伴中心 API 参考进行了重组。有关支持的 API 操作的更多信息，请参阅 AWS 合作伙伴中心 API 参考。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用管理线索 AWS Partner Central Selling API

什么是线索？

在企业对企业（B2B）销售中，潜在客户表示对公司的产品或服务感兴趣，但尚未完全具备销售机会资格的潜在客户。潜在客户是销售渠道的初始阶段，需要对其进行培育和资格认证，然后才能将其转化为积极的共同销售机会。 AWS

AWS 与合作伙伴共享的潜在客户基于客户参与信号，例如网络研讨会出席情况、活动参与情况或合作伙伴解决方案查询。这些线索包括宝贵的背景信息，例如客户公司信息、业务问题和参与细节，以帮助合作伙伴确定潜在机会的优先顺序并确定其有效性。

处理潜在客户邀请

AWS 当潜在客户表示对合作伙伴解决方案或服务感兴趣时，合作伙伴就会收到潜在客户邀请。潜在客户邀请流程允许合作伙伴在承诺参与之前评估潜在客户，从而确保有效的资源分配和更高的转化率。

接收潜在客户邀请

AWS 创建潜在客户邀请并通过销售 API 与合作伙伴共享。当有新的潜在客户邀请可用时， AWS 向符合条件的合作伙伴发送包含潜在客户上下文的参与邀请。

合作伙伴应使用亚马逊监控Engagement Invitation Created活动 EventBridge。此事件通知包括设置为的payloadType字段LeadInvitation，允许合作伙伴区分潜在客户邀请和机会邀请。收到活动后，合作伙伴可以检索邀请详细信息以评估潜在客户。

上市负责人邀请

合作伙伴可以使用 ListEngagementInvitations API 操作查看所有潜在客户邀请。此操作会检索主体是发件人或接收者的邀请。

要专门筛选潜在客户邀请，合作伙伴应使用带有值的payloadType过滤器LeadInvitation。此过滤器确保仅返回潜在客户邀请，不包括结果中的机会邀请。

潜在客户邀请可能处于以下状态：

评估潜在客户邀请

在接受潜在客户邀请之前，合作伙伴应使用 GetEngagementInvitation API 操作检索详细的邀请信息。这为做出知情的接受或拒绝决定提供了必要的背景。

潜在客户邀请有效载荷包括：

客户信息（可预验收）：

客户互动：

接受潜在客户邀请

当合作伙伴决定寻找潜在客户时，他们必须使用 AcceptEngagementInvitation API 操作接受邀请。此操作将合作伙伴添加到项目中，并允许访问完整的潜在客户详细信息，包括客户联系信息。

验收后：

合作伙伴可以通过调用每个邀请以编程方式接受多个潜在客户邀请，从而实现AcceptEngagementInvitation对高质量潜在客户的高效批量处理。

拒绝潜在客户邀请

如果潜在客户与合作伙伴的能力、能力或业务重点不一致，则合作伙伴可以使用 RejectEngagementInvitation API 操作拒绝邀请。拒绝潜在客户邀请时，合作伙伴应提供拒绝理由，以帮助 AWS 改善潜在客户的选择和匹配。常见的拒绝原因包括：

被拒绝后：

只要满足客户同意要求，被拒绝的线索可能有资格重新分配给其他合作伙伴。

管理已接受的潜在客户

接受潜在客户邀请后，合作伙伴可以访问完整的潜在客户信息，培养客户关系，并在资格认证阶段跟踪潜在客户。

查看潜在客户详情

合作伙伴使用 GetEngagement API 操作访问完整的潜在客户详细信息。该项目包含潜在客户背景信息，其中包含有关客户及其与之互动的全面信息 AWS。

Lead 上下文包括：

完整的客户档案：

互动历史：

资格状态：

这种全面的视图使合作伙伴能够了解客户在多个 AWS 活动和接触点上的完整互动历史记录，而不是将每次互动视为单独的线索。

列出活跃线索

合作伙伴可以使用contextType过滤器设置为ListEngagements的 API 操作检索所有活跃线索Lead。如果合作伙伴是成员且参与度包含潜在客户背景，则这将返回参与度。

清单回复包含关键信息，例如：

合作伙伴可以使用此列表来构建仪表板，跟踪潜在客户渠道的运行状况，并确定需要关注的潜在客户。

用潜在客户见解丰富潜在客户

合作伙伴可以为已接受的潜在客户提供 AWS 见解，以便在投资推广活动之前，更好地确定其优先顺序和资格认证。扩充是通过探矿任务异步进行的，这些任务通过 AWS衍生信号来增强潜在客户的参与度，以支持资格决策。

开始探矿任务

合作伙伴使用 StartProspectingFromEngagementTask API 操作启动扩展。此操作可在单个请求中接受多达 100 个互动标识符，从而允许合作伙伴批量丰富潜在客户。该任务异步运行并立即返回一个 TaskIdTaskArn，合作伙伴使用它来跟踪进度。首字母TaskStatus是、PENDINGIN_PROGRESSCOMPLETED、或之一FAILED。

合作伙伴可以选择提供一个TaskName来标记任务，并提供一个ClientToken来确保重试时的等性。

投票以获取结果

由于探矿是异步的，因此合作伙伴使用 GetProspectingFromEngagementTask API操作进行轮询以确定是否完成，并在开始时TaskId返回结果。响应会报告提交的每个标识符的总体任务状态和每次互动的结果。

每个项目都是独立处理的，因此个人参与可以成功或失败，而不会影响同一任务中的其他参与者。对于每一次互动，结果包括：

监视多项任务

为了跟踪许多潜在客户的充实情况，合作伙伴使用 ListProspectingFromEngagementTasks API 操作。此操作列出了由呼叫者账户发起的所有潜在客户任务，并支持按任务标识符、任务名称或开始时间范围进行可选筛选，并可配置排序。响应是分页的；使用每个响应的NextToken值来检索后续页面。

扩充成功完成后， AWS 见解将作为潜在客户背景添加到项目中。合作伙伴可以从中检索丰富的详细信息，GetEngagement并使用它们来设置潜在客户的资格状态，并决定哪些潜在客户可以晋升为转化率。

更新潜在客户信息

在合作伙伴培育潜在客户和收集更多信息时，他们可以使用 UpdateEngagementContext API 操作更新潜在客户的详细信息。此操作允许合作伙伴修改项目中的潜在客户上下文。

合作伙伴可以更新：

资格认证状态：合作伙伴应在内部资格认证流程的进展中更新资格状态：

潜在客户元数据：合作伙伴可以添加或更新与其资格认证和培育流程相关的其他信息。

更新资格状态有助于合作伙伴跟踪潜在客户进展，生成准确的渠道报告，并确定准备转化为机会的潜在客户。

监控 AWS 更新

AWS 可能会根据新的客户参与度信号或完善的参与度评分更新潜在客户信息。 AWS 更新参与度时，合作伙伴会通过亚马逊收到一个Engagement Updated活动 EventBridge。

这些更新可能包括：

合作伙伴应监控这些事件并致电GetEngagement以获取最新的潜在客户详细信息。这样可以确保合作伙伴获得最新的信息，以确定潜在客户的优先顺序和培育潜在客户。

该Engagement Updated活动包括该contextTypes字段，允许合作伙伴专门筛选潜在客户（与潜在客户情境的互动）。

将潜在客户转化为机会

当潜在客户获得资格并表现出认真的购买意向时，合作伙伴可以将其转化为与 AWS之进行正式共同销售合作的机会。这种转变标志着从潜在客户培养（主要由合作伙伴驱动）向机会管理（与之合作）的过渡。 AWS

推荐方法：便利 API

合作伙伴可以使用StartOpportunityFromEngagementTask便捷的 API 操作来简化机会的创建和关联流程。此任务 API 会自动协调多个操作：

这种便捷的方法减少了所需的 API 调用次数，并确保了正确的归因跟踪。使用这种方法的合作伙伴仍然需要：

便利 API 对于拥有自动销售线索到机会工作流程且希望最大限度地降低集成复杂性的合作伙伴特别有用。

替代方法： Step-by-step API

创建选秀机会

转换潜在客户的第一步是使用 CreateOpportunity API 操作创建草稿机会。如果Lifecycle.ReviewStatus设置为，这会创造机会Pending Submission。在此阶段，该机会尚未提交 AWS 进行验证。

合作伙伴应利用潜在客户培育期间收集的信息填充机会，包括：

草稿机会允许合作伙伴在提交之前准备完整的信息 AWS，从而确保更高的批准率和更快的验证。

将机会与潜在客户参与度联系起来

创建草稿机会后，合作伙伴必须使用 CreateResourceSnapshot API 操作将其与来源潜在客户互动关联起来。此步骤对以下方面至关重要：

创建资源快照时，合作伙伴指定：

此操作会自动为互动添加 CustomerProject 背景信息，表明潜在客户已转化为活跃机会。现在，该项目既包含原始的潜在客户背景（保留历史记录），也包含新的 CustomerProject 上下文（表示活跃的机会）。

填写机会详情

机会创建并关联后，合作伙伴必须先完成其他机会要求，然后才能提交。有关详细信息，请参阅 AssociateOpportunity API 操作。

更新项目详情：合作伙伴可以使用 UpdateOpportunity API 操作来完善项目信息、客户业务问题、预期支出以及在潜在客户资格认证期间收集的其他相关详细信息。

提交机会

完成所有必填信息后，合作伙伴将提交使用StartEngagementFromOpportunityTask便利 API 进行 AWS 验证的机会。这使机会从草稿状态过渡到 AWS 审核流程。

验证要求：项目在提交前必须有 CustomerProject 背景信息。当使用将机会与互动关联时CreateResourceSnapshot，会自动创建此上下文。如果缺少此上下文，则提交将失败。

提交后：

然后，机会遵循 “利用您的机会” 文档中描述的标准验证工作流程，逐步完成 “需要采取行动” In-Review、“已批准” 或 “取消资格” 等状态。