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

# 潜在客户共享
<a name="custom-lead-sharing"></a>

## AWS 股票如何领先
<a name="how-aws-shares-leads"></a>

1. **增量导出**：Amazon Web Services (AWS) 每小时导出所 AWS提及的新潜在客户（和更新）。

1. **文件创建**： AWS 生成符合特定格式的潜在客户文件。有关详细的文件规格，请参阅[字段定义](resources.md#custom-field-definitions)。

1. **文件上传**：潜在客户文件上传到`lead-outbound`文件夹。

## 消耗来自的潜在客户 AWS
<a name="consuming-leads-from-aws"></a>

要有效地利用来自的潜在客户 AWS，请使用以下功能构建自定义集成。

1. **文件检索**：
   + 按照您选择的时间间隔使用计划作业定期扫描`lead-outbound`文件夹。
   + 检索潜在客户文件进行处理。

1. **数据转换和映射**：
   +  阅读每个文件的内容后，转换数据并将其映射到客户关系管理 (CRM) 系统中的潜在客户记录。
   + 有关字段映射的指导，请参阅[字段映射](custom-field-mapping.md)。

1. **线索识别**：
   + 使用`partnerCrmLeadId`或对每个潜在客户进行唯一标识`apnCrmUniqueIdentifier`。
   + 如果`partnerCrmLeadId`为空且`apnCrmUniqueIdentifier`存在，则潜在客户是 AWS Partner Network (APN) 客户互动 (ACE) 的新推荐人。
   + 如果两个标识符都存在，则该记录将被视为来自 ACE 的更新。

1. **铅摄入：**
   + 在 CRM 系统中获取新的潜在客户或更新现有潜在客户。

1. **文件管理**：
   + 成功处理每条线索和完整文件数据后，从出站文件夹中删除文件。
   + 每个文件都会自动存档到该`lead-outbound-archive`文件夹中。

**集成和代码参考**：
+ 要读取上传到亚马逊简单存储服务 (Amazon S3) 存储桶的文件， AWS Lambda 您可以使用您的 CRM 系统或直接从 CRM 系统读取。
+ 使用以下 Lambda 和 Salesforce REST API 的示例代码来验证和更新 CRM 记录。
  + **用于验证文件的 Lambda**[：ace\$1read\$1s3.py。](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/ace_read_s3.py)
  + **Salesforce REST API**：[apex API\$1C](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Apex_Sample_REST_API_Code.cls) \$1sample\$1rest\$1 ode.cls
+ 如果您使用的是 Salesforce 以外的 CRM 系统，则必须提供特定于您的系统的代码来更新数据。

## 与分享潜在客户的最新动态 AWS
<a name="sharing-updates-on-leads-with-aws"></a>

1. **识别潜在客户**：找到要与之共享的最新消息的潜在客户 AWS。

1. **数据转**换：将数据转换为 AWS 格式，如中所述[字段定义](resources.md#custom-field-definitions)。

1. **文件创建**：
   + 生成 JSON 格式的潜在客户文件。
   + 为每个文件附加时间戳，确保所有文件名都是唯一的，并遵循以下格式：。`{name}_MMDDYYYY24HHMMSS.json`

1. **进行身份验证并上传**：
   + 向 ACE Amazon S3 存储桶进行身份验证。
   + 将文件上传到文件`lead-inbound`夹。与之共享的所有文件 AWS 都会自动存档`lead-inbound-archive`到该文件夹中。
   + 将文件上传到 S3 时，请确保向存储桶所有者提供完全访问权限。

     ```
     aws s3 cp example.jpg s3://awsexamplebucket --acl bucket-owner-full-control
     ```

     在 “结果示例 [file.json” 中查看运行此命令的示例结果](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results-Success-Sample.json)。

1. **文件处理**：
   + 收到文件后， AWS 会自动处理文件。
   + 处理结果将上传到 Amazon S3 存储桶中的`lead-inbound-processed-results`文件夹。这包括成功和错误的状态，以及每条潜在客户的任何错误消息。
   + 这些处理后的结果也存档在`lead-inbound-processed-results-archive`文件夹中。
   + 有关更多信息，请参阅[技术常见问题解答——线索和机会](technical-faq-leads-and-opps.md)。

1. **响应处理**：
   + 您必须开发使用这些响应的逻辑，查看错误记录，更正所有错误，然后将数据重新发送给 ACE。
   + 您可以在 “常见问题解答” 和 “疑难解答” 部分找到错误示例。
   + 要从 CRM 将文件上传到 Amazon S3，请执行以下操作：
     + 引用 AWS 签名的版本。
     + 使用 HTTPS 请求上传文件。
   + 作为参考，请使用以下文件将文件上传到 Amazon S3 存储桶：
     + **用于对 S3 存储桶进行身份验证：s3\$1** [authentication.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls)
     + **要将文件上传到 S3 存储桶：S** [ample AceOutboundBatch](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls) \$1 .cls
   + **注意：**文件大小不得超过 1 MB，并且不会处理重复的文件。