Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Intercambio de clientes potenciales
<a name="custom-lead-sharing"></a>

## ¿Cómo AWS comparte los clientes potenciales
<a name="how-aws-shares-leads"></a>

1. **Exportaciones incrementales**: Amazon Web Services (AWS) exporta los nuevos clientes potenciales (y actualizaciones) referidos por AWS cada hora.

1. **Creación de archivos**: AWS genera archivos de clientes potenciales con un formato específico. Para obtener especificaciones detalladas de los archivos, consulte. [Definiciones de campo](resources.md#custom-field-definitions)

1. **Carga de archivos**: los archivos principales se cargan en la `lead-outbound` carpeta.

## Consumir clientes potenciales de AWS
<a name="consuming-leads-from-aws"></a>

Para consumir clientes potenciales de manera efectiva AWS, cree una integración personalizada con las siguientes funcionalidades.

1. **Recuperación de archivos**:
   + Escanee la `lead-outbound` carpeta con regularidad mediante un trabajo programado en el intervalo que elija.
   + Recupera los archivos principales para procesarlos.

1. **Transformación y mapeo de datos**:
   +  Después de leer el contenido de cada archivo, transforme y asigne los datos a los registros de clientes potenciales de su sistema de gestión de relaciones con los clientes (CRM). 
   + Para obtener orientación sobre el mapeo de campos, consulte[Asignación de campo](custom-field-mapping.md).

1. **Identificación de clientes potenciales**:
   + Identifique de forma única cada cliente potencial utilizando una de las `partnerCrmLeadId` siguientes `apnCrmUniqueIdentifier` opciones:
   + Si `partnerCrmLeadId` está en blanco y `apnCrmUniqueIdentifier` está presente, el cliente potencial es una nueva referencia de Customer Engagement AWS Partner Network (ACE) (APN).
   + Si ambos identificadores están presentes, el registro se considera una actualización de ACE.

1. **Ingestión de plomo**:
   + Ingiera nuevos clientes potenciales o actualice los existentes en el sistema CRM.

1. **Gestión de archivos**:
   + Tras procesar correctamente cada cliente potencial y los datos completos del archivo, elimine los archivos de la carpeta de salida.
   + Cada archivo se archiva automáticamente en la `lead-outbound-archive` carpeta.

**Integración y referencia de código:**
+ Para leer los archivos subidos al bucket de Amazon Simple Storage Service (Amazon S3), puede AWS Lambda utilizarlos o leerlos directamente desde su sistema CRM.
+ Utilice los códigos de ejemplo que aparecen a continuación para las API REST de Lambda y Salesforce para validar y actualizar los registros de CRM.
  + **Lambda para validar archivos**[: ace\$1read\$1s3.py.](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/ace_read_s3.py)
  + **API REST de Salesforce**[: APEX\$1Sample\$1REST\$1 ode.cls. API\$1C](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Apex_Sample_REST_API_Code.cls)
+ Si utiliza un sistema CRM que no sea Salesforce, debe proporcionar el código específico de su sistema para actualizar sus datos.

## Compartir actualizaciones sobre clientes potenciales con AWS
<a name="sharing-updates-on-leads-with-aws"></a>

1. **Identifique los clientes potenciales**: localice los clientes potenciales con las actualizaciones para compartirlos con ellos AWS.

1. **Transformación** de datos: convierta los datos al AWS formato descrito en[Definiciones de campo](resources.md#custom-field-definitions).

1. **Creación de archivos**:
   + Genere archivos de clientes potenciales en formato JSON.
   + Añada una marca de tiempo a cada archivo, asegurándose de que todos los nombres de los archivos sean únicos y sigan el formato:. `{name}_MMDDYYYY24HHMMSS.json`

1. **Autenticar** y cargar:
   + Autenticese en el bucket de Amazon S3 de ACE.
   + Cargue el archivo en la `lead-inbound` carpeta. Todos los archivos con los AWS que se comparte se archivan automáticamente en la `lead-inbound-archive` carpeta.
   + Cuando subas archivos a S3, asegúrate de proporcionar acceso completo al propietario del bucket.

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

     Consulta un ejemplo del resultado de la ejecución de este comando en [«Results Sample file.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results-Success-Sample.json)».

1. **Procesamiento de archivos**:
   + Al recibirlos, procesa AWS automáticamente los archivos.
   + Los resultados del procesamiento se cargan en la `lead-inbound-processed-results` carpeta del bucket de Amazon S3. Esto incluye el estado de los éxitos y errores, así como cualquier mensaje de error de cada cliente potencial.
   + Estos resultados procesados también se archivan en la `lead-inbound-processed-results-archive` carpeta.
   + Para obtener más información, consulte la[Preguntas frecuentes técnicas: clientes potenciales y oportunidades](technical-faq-leads-and-opps.md).

1. **Manejo de respuestas**:
   + Debe desarrollar una lógica para consumir estas respuestas, revisar los registros erróneos, corregir cualquier error y volver a enviar los datos a ACE.
   + Puede encontrar ejemplos de errores en las secciones de preguntas frecuentes y solución de problemas.
   + Para cargar un archivo a Amazon S3 desde CRM:
     + Haga referencia a la versión de la AWS firma.
     + Usa una solicitud HTTPS para cargar el archivo.
   + Como referencia, utilice los siguientes archivos para cargar un archivo en el bucket de Amazon S3:
     + **Para autenticar un bucket de S3**[: S3\$1Authentication.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls)
     + **Para cargar archivos a un bucket de S3**[: Sample\$1 .cls AceOutboundBatch](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls)
   + **NOTA:** Los archivos no deben tener un tamaño superior a 1 MB y los archivos duplicados no se procesarán.