对 AWS 合作伙伴中心 API 参考进行了重组。有关支持的 API 操作的更多信息，请参阅 [AWS 合作伙伴中心 API 参考](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html)。

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

# 使用管理线索 AWS Partner Central Selling API
<a name="working-with-your-leads"></a>

## 什么是线索？
<a name="what-is-a-lead"></a>

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

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

## 处理潜在客户邀请
<a name="working-with-lead-invitations"></a>

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

### 接收潜在客户邀请
<a name="receiving-lead-invitations"></a>

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

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

### 上市负责人邀请
<a name="listing-lead-invitations"></a>

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

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

潜在客户邀请可能处于以下状态：
+ **待定**：等待合作伙伴接受或拒绝
+ **已接受**：合作伙伴已接受邀请并获得了完整的潜在客户详细信息的访问权限
+ **已拒绝**：合作伙伴拒绝了邀请
+ **已过期**：邀请已过期但未采取任何操作

## 评估潜在客户邀请
<a name="evaluating-lead-invitations"></a>

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

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

**客户信息（可预验收）：**
+ 公司名称、行业和国家
+ 网站 URL
+ 细分市场（企业、大型、中型、小型、微型）
+ AWS 成熟度级别（评估， Single-Account， Multi-Account）

**客户互动：**
+ 来源类型和活动信息
+ 客户采取的行动（表单填写、网络研讨会出席等）
+ 客户提供的业务问题描述
+ 用例类别
+ 联系人标题（提供 BANT 资格认证的权威背景）

**重要**  
在邀请阶段看不到客户联系信息（姓名、电子邮件、电话号码）。只有在接受邀请后，才会提供联系方式，从而确保客户隐私并防止铅矿养殖行为。

## 接受潜在客户邀请
<a name="accepting-lead-invitations"></a>

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

验收后：
+ 合作伙伴被添加为项目成员
+ 客户联系信息可通过互动潜在客户上下文可见
+ 该潜在客户在系统中被归类为合作伙伴合格潜在客户 (PQL) AWS 
+ 线索出现在合作伙伴的活跃潜在客户列表中
+ 合作伙伴可以开始培养潜在客户并与客户建立联系

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

## 拒绝潜在客户邀请
<a name="rejecting-lead-invitations"></a>

如果潜在客户与合作伙伴的能力、能力或业务重点不一致，则合作伙伴可以使用 `RejectEngagementInvitation` API 操作拒绝邀请。拒绝潜在客户邀请时，合作伙伴应提供拒绝理由，以帮助 AWS 改善潜在客户的选择和匹配。常见的拒绝原因包括：
+ 缺乏地理覆盖范围
+ 该用例的技术专业知识不足
+ 当前的容量限制
+ 客户行业不匹配
+ 预算失调

被拒绝后：
+ 潜在客户已从合作伙伴的待处理邀请队列中移除
+ 永远不会与合作伙伴共享客户联系信息
+ 该线索在系统中 AWS 被归类为合作伙伴拒绝的线索 (PRL)
+ 该邀请在合作伙伴的拒绝邀请列表中仍然可见，以供参考

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

## 管理已接受的潜在客户
<a name="managing-accepted-leads"></a>

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

### 查看潜在客户详情
<a name="viewing-lead-details"></a>

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

Lead 上下文包括：

**完整的客户档案：**
+ 原始邀请中的所有公司信息
+ 所有客户互动的完整联系方式（姓名、电子邮件、电话、公司职务）
+ AWS 成熟度水平和细分市场

**互动历史：**
+ 将多个客户接触点整合到单个项目中
+ 每次互动都包括来源信息、客户操作、业务问题和联系方式
+ 互动按时间顺序列出，以提供完整的客户旅程视图

**资格状态：**
+ 潜在客户资格的当前状态（不合格、合格、取消资格或自定义状态）
+ 合作伙伴可以在资格认证流程的过程中更新此状态

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

### 列出活跃线索
<a name="listing-active-leads"></a>

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

清单回复包含关键信息，例如：
+ 参与 ID 和标题
+ 客户公司名称
+ 当前参与度分数
+ 资格状态
+ 互动次数
+ 创建和修改时间戳

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

### 用潜在客户见解丰富潜在客户
<a name="prospecting-leads"></a>

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

**开始探矿任务 **

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

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

**投票以获取结果 **

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

每个项目都是独立处理的，因此个人参与可以成功或失败，而不会影响同一任务中的其他参与者。对于每一次互动，结果包括：
+ **参与标识符**：已处理的互动。
+ **状态**：`PENDING``IN_PROGRESS`、`COMPLETED`、或`FAILED`。
+ **潜在客户环境标识符**：成功处理项目时填充。该标识符引用了添加到项目中的丰富探矿背景，可用于后续操作。
+ **原因代码和消息**：仅在项目失败时填充，提供枚举的失败代码和包含建议恢复步骤的人类可读描述。

**监视多项任务 **

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

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

### 更新潜在客户信息
<a name="updating-lead-information"></a>

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

合作伙伴可以更新：

**资格认证状态：**合作伙伴应在内部资格认证流程的进展中更新资格状态：
+ **不合格**：接受潜在客户后的默认状态；表示潜在客户需要评估
+ **合格**：潜在客户符合资格标准，并显示出很高的转化为机会的可能性
+ **取消资格**：潜在客户不符合标准或不适合合作伙伴的解决方案
+ **自定义状态**：合作伙伴可以定义自己的资格状态以匹配其内部流程

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

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

### 监控 AWS 更新
<a name="monitoring-aws-updates"></a>

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

这些更新可能包括：
+ 根据新客户活动精确的参与度分数
+ 来自新活动或接触点的其他客户互动
+ 更新的客户信息

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

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

## 将潜在客户转化为机会
<a name="converting-lead-to-opportunity"></a>

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

### 推荐方法：便利 API
<a name="recommended-approach-convenience-api"></a>

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

1. 使用来自潜在客户背景的初步信息创建机会草稿

1. 通过资源快照将机会与来源参与联系起来

1. 为互动添加 CustomerProject 背景信息

这种便捷的方法减少了所需的 API 调用次数，并确保了正确的归因跟踪。使用这种方法的合作伙伴仍然需要：
+ 使用以下方法填写机会详情 `UpdateOpportunity`
+ 助理合作伙伴解决方案使用 `AssociateOpportunity`
+ 准备就绪`StartEngagementFromOpportunityTask`时使用提交机会

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

### 替代方法： Step-by-step API
<a name="alternative-approach-step-by-step"></a>

**创建选秀机会 **

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

合作伙伴应利用潜在客户培育期间收集的信息填充机会，包括：
+ 客户账户详情
+ 项目信息和业务问题
+ 预期的客户支出
+ 目标截止日期
+ 资格审查期间收集的任何其他相关详细信息

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

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

创建草稿机会后，合作伙伴必须使用 `CreateResourceSnapshot` API 操作将其与来源潜在客户互动关联起来。此步骤对以下方面至关重要：
+ **归因跟踪**：建立从潜在客户邀请到机会关闭的来源链，从而实现营销活动和潜在客户来源的准确投资回报率计算。
+ **转化指标**：允许 AWS 合作伙伴衡量潜在客户转化率并确定成功的潜在客户来源。
+ **情境保存**：维护完整的客户旅程历史记录，包括所有原始互动和参与信号。

创建资源快照时，合作伙伴指定：
+ 互动 ID（来源潜在客户参与度）
+ 机会标识符
+ 资源类型（机会）

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

**填写机会详情 **

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

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

**提交机会 **

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

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

提交后：
+ 机会的`Lifecycle.ReviewStatus`变化是 `Submitted`
+ 该潜在客户在系统中被归类为合作伙伴销售合格潜在客户 (PSQL) AWS 
+ AWS 开始验证以确保机会详细信息准确和完整
+ 在审核过程完成之前，不能对机会进行任何更改

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