Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Condivisione dei lead
<a name="custom-lead-sharing"></a>

## In che modo AWS condivide i lead
<a name="how-aws-shares-leads"></a>

1. **Esportazioni incrementali**: Amazon Web Services (AWS) esporta nuovi lead (e aggiornamenti) a cui si fa riferimento AWS, su base oraria.

1. **Creazione di file**: AWS genera file lead che aderiscono a un formato specifico. Per le specifiche dettagliate dei file, fare riferimento a. [Definizioni dei campi](resources.md#custom-field-definitions)

1. **Caricamento del file**: i file principali vengono caricati nella `lead-outbound` cartella.

## Consumo di lead da AWS
<a name="consuming-leads-from-aws"></a>

Per utilizzare in modo efficace i lead provenienti da AWS, crea un'integrazione personalizzata con le seguenti funzionalità.

1. **Recupero dei file**:
   + Scansiona regolarmente la `lead-outbound` cartella utilizzando un processo pianificato a un intervallo scelto.
   + Recupera i file principali per l'elaborazione.

1. **Trasformazione e mappatura dei dati**:
   +  Dopo aver letto il contenuto di ogni file, trasformate e mappate i dati nei record principali del vostro sistema di gestione delle relazioni con i clienti (CRM). 
   + Per indicazioni sulla mappatura dei campi, fare riferimento a. [Mappatura dei campi](custom-field-mapping.md)

1. **Identificazione del lead**:
   + Identifica in modo univoco ogni lead utilizzando `partnerCrmLeadId` o`apnCrmUniqueIdentifier`.
   + Se `partnerCrmLeadId` è vuoto ed `apnCrmUniqueIdentifier` è presente, il lead è un nuovo referral di AWS Partner Network (APN) Customer Engagement (ACE).
   + Se sono presenti entrambi gli identificatori, il record viene considerato come un aggiornamento di ACE.

1. Ingestione di **piombo:**
   + Inserisci nuovi lead o aggiorna i lead esistenti nel sistema CRM.

1. **Gestione dei file**:
   + Dopo aver elaborato correttamente ogni lead e i dati completi del file, elimina i file dalla cartella in uscita.
   + Ogni file viene archiviato automaticamente nella cartella`lead-outbound-archive`.

**Integrazione e riferimento al codice:**
+ Per leggere i file caricati nel bucket Amazon Simple Storage Service (Amazon S3), puoi AWS Lambda utilizzare o leggere direttamente dal tuo sistema CRM.
+ Utilizza i codici di esempio seguenti per l'API REST di Lambda e Salesforce per convalidare e aggiornare i record CRM.
  + **Lambda per la convalida dei file**[: ace\$1read\$1s3.py.](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/ace_read_s3.py)
  + **API REST di 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)
+ Se utilizzi un sistema CRM diverso da Salesforce, devi fornire un codice specifico per il tuo sistema per aggiornare i dati.

## Condivisione degli aggiornamenti sui lead con AWS
<a name="sharing-updates-on-leads-with-aws"></a>

1. **Identifica i lead**: individua i lead con aggiornamenti da condividere AWS.

1. **Trasformazione dei dati**: converti i dati nel AWS formato, come indicato in[Definizioni dei campi](resources.md#custom-field-definitions).

1. **Creazione di file**:
   + Genera file lead in formato JSON.
   + Aggiungi un timestamp a ciascun file, assicurandoti che tutti i nomi dei file siano unici e seguano il formato:. `{name}_MMDDYYYY24HHMMSS.json`

1. **Autentica** e carica:
   + Effettua l'autenticazione nel bucket ACE Amazon S3.
   + Carica il file nella cartella. `lead-inbound` Tutti i file condivisi con AWS vengono archiviati automaticamente nella `lead-inbound-archive` cartella.
   + Quando carichi file su S3, assicurati di fornire l'accesso completo al proprietario del bucket.

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

     Guarda un esempio di risultato dell'esecuzione di questo comando in [«Results Sample file.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results-Success-Sample.json)».

1. Elaborazione **dei file**:
   + Al ricevimento, elabora AWS automaticamente i file.
   + I risultati dell'elaborazione vengono caricati `lead-inbound-processed-results` nella cartella del bucket Amazon S3. Ciò include lo stato dei successi e degli errori, nonché eventuali messaggi di errore per ogni lead.
   + Questi risultati elaborati vengono inoltre archiviati nella cartella`lead-inbound-processed-results-archive`.
   + Per ulteriori informazioni, fare riferimento a. [Domande frequenti tecniche: lead e opportunità](technical-faq-leads-and-opps.md)

1. **Gestione delle risposte**:
   + È necessario sviluppare una logica per utilizzare queste risposte, esaminare i record errati, correggere eventuali errori e inviare nuovamente i dati ad ACE.
   + Puoi trovare esempi di errori nelle sezioni Domande frequenti e Risoluzione dei problemi.
   + Per caricare un file su Amazon S3 da CRM:
     + Fai riferimento alla versione della firma. AWS 
     + Utilizza una richiesta HTTPS per caricare il file.
   + Come riferimento, usa i seguenti file per caricare un file nel bucket Amazon S3:
     + **[Per autenticare un bucket S3: S3\$1Authentication.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls)**
     + **[Per caricare file in un bucket S3: Sample\$1 .cls AceOutboundBatch](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls)**
   + **NOTA:** i file non devono superare 1 MB di dimensione e i file duplicati non verranno elaborati.