As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Compartilhamento de leads
<a name="custom-lead-sharing"></a>

## Como os AWS compartilhamentos lideram
<a name="how-aws-shares-leads"></a>

1. **Exportações incrementais**: a Amazon Web Services (AWS) exporta novos leads (e atualizações) referenciados por AWS, de hora em hora.

1. **Criação de arquivo**: AWS gera arquivos de leads aderentes a um formato específico. Para obter especificações detalhadas do arquivo, consulte[Definições de campo](resources.md#custom-field-definitions).

1. **Upload de arquivo**: os arquivos principais são enviados para a `lead-outbound` pasta.

## Consumindo leads de AWS
<a name="consuming-leads-from-aws"></a>

Para consumir leads de forma eficaz AWS, crie uma integração personalizada com as seguintes funcionalidades.

1. **Recuperação de arquivos**:
   + Examine regularmente a `lead-outbound` pasta usando um trabalho agendado em um intervalo que você escolher.
   + Recupere os arquivos principais para processamento.

1. **Transformação e mapeamento de dados**:
   +  Depois de ler o conteúdo de cada arquivo, transforme e mapeie os dados para os registros de leads em seu sistema de gerenciamento de relacionamento com o cliente (CRM). 
   + Para obter orientação sobre mapeamento de campo, consulte[Mapeamentos de campos](custom-field-mapping.md).

1. **Identificação do lead**:
   + Identifique cada lead de forma exclusiva usando um ou. `partnerCrmLeadId` `apnCrmUniqueIdentifier`
   + Se `partnerCrmLeadId` estiver em branco e `apnCrmUniqueIdentifier` estiver presente, o lead é uma nova indicação do AWS Partner Network (APN) Customer Engagement (ACE).
   + Se ambos os identificadores estiverem presentes, o registro será tratado como uma atualização da ACE.

1. **Ingestão de chumbo**:
   + Ingira novos leads ou atualize os leads existentes no sistema de CRM.

1. **Gerenciamento de arquivos**:
   + Depois de processar com sucesso cada lead e os dados completos do arquivo, exclua os arquivos da pasta de saída.
   + Cada arquivo é automaticamente arquivado na `lead-outbound-archive` pasta.

**Integração e referência de código**:
+ Para ler arquivos enviados para o bucket do Amazon Simple Storage Service (Amazon S3), você pode AWS Lambda usar ou ler diretamente do seu sistema de CRM.
+ Use os códigos de amostra abaixo para a API REST do Lambda e do Salesforce para validar e atualizar os registros do CRM.
  + **Lambda para validação de arquivos**[: ace\$1read\$1s3.py.](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/ace_read_s3.py)
  + **API REST do Salesforce**: [API\$1Capex\$1sample\$1rest\$1](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Apex_Sample_REST_API_Code.cls) ode.cls.
+ Se você usa um sistema de CRM diferente do Salesforce, você deve fornecer um código específico para seu sistema para atualizar seus dados.

## Compartilhando atualizações sobre leads com AWS
<a name="sharing-updates-on-leads-with-aws"></a>

1. **Identifique leads**: localize os leads com atualizações para serem compartilhadas AWS.

1. **Transformação de dados**: converta os dados no AWS formato, conforme descrito em[Definições de campo](resources.md#custom-field-definitions).

1. **Criação do arquivo**:
   + Gere arquivos de leads no formato JSON.
   + Anexe um carimbo de data/hora a cada arquivo, garantindo que todos os nomes de arquivo sejam exclusivos e sigam o formato:. `{name}_MMDDYYYY24HHMMSS.json`

1. **Autenticar e fazer upload**:
   + Autentique-se no bucket ACE Amazon S3.
   + Faça o upload do arquivo para a `lead-inbound` pasta. Todos os arquivos compartilhados AWS são automaticamente arquivados na `lead-inbound-archive` pasta.
   + Ao fazer upload de arquivos para o S3, certifique-se de fornecer acesso total ao proprietário do bucket.

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

     Veja um exemplo de resultado da execução desse comando em [“Results Sample file.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results-Success-Sample.json)”.

1. **Processamento de arquivos**:
   + Após o recebimento, processa AWS automaticamente os arquivos.
   + Os resultados do processamento são enviados para a `lead-inbound-processed-results` pasta no bucket do Amazon S3. Isso inclui o status de acertos e erros, bem como quaisquer mensagens de erro para cada lead.
   + Esses resultados processados também são arquivados na `lead-inbound-processed-results-archive` pasta.
   + Para obter mais informações, consulte [Perguntas frequentes técnicas — leads e oportunidades](technical-faq-leads-and-opps.md) o.

1. **Tratamento da resposta**:
   + Você deve desenvolver uma lógica para consumir essas respostas, revisar registros errôneos, corrigir quaisquer erros e reenviar os dados para a ACE.
   + Você pode encontrar exemplos de erros nas seções Perguntas frequentes e Solução de problemas.
   + Para fazer o upload de um arquivo do CRM para o Amazon S3:
     + Consulte a versão da AWS assinatura.
     + Use uma solicitação HTTPS para fazer o upload do arquivo.
   + Como referência, use os seguintes arquivos para fazer upload de um arquivo para o bucket do Amazon S3:
     + **[Para autenticar um bucket do S3: S3\$1Authentication.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls)**
     + **Para fazer upload de arquivos para um bucket do S3**[: Sample\$1 .cls AceOutboundBatch](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls)
   + **OBSERVAÇÃO:** os arquivos não devem exceder 1 MB e os arquivos duplicados não serão processados.