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 oportunidades
<a name="custom-opportunity-sharing"></a>

## Como AWS compartilha oportunidades
<a name="how-aws-shares-opportunities"></a>

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

1. **Criação de arquivo**: AWS gera arquivos de oportunidades que aderem a um formato específico. Para obter especificações detalhadas do arquivo, consulte as [definições do campo Oportunidade](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv).

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

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

Para aproveitar as oportunidades de forma eficaz AWS, você precisa criar uma integração personalizada com essas funcionalidades.

1. **Recuperação de arquivos**:
   + Use um trabalho agendado para verificar regularmente a `opportunity-outbound` pasta, em um intervalo que você escolher.
   + Recupere os arquivos de oportunidades 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 oportunidades 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 da oportunidade**:
   + Identifique de forma exclusiva cada oportunidade usando um ou. `partnerCrmOpportunityId` `apnCrmUniqueIdentifier`
   + Se `partnerCrmOpportunityId` estiver em branco e `apnCrmUniqueIdentifier` estiver presente, a oportunidade é 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 oportunidades**: ingira novas oportunidades ou atualize oportunidades existentes no sistema de CRM.

1. **Gerenciamento de arquivos**:
   + Depois de processar com êxito cada oportunidade e os dados completos do arquivo, exclua os arquivos da pasta de saída.
   + Cada arquivo é automaticamente arquivado na `opportunity-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 de oportunidades com AWS
<a name="sharing-updates-to-opportunities-with-aws"></a>

1. **Identifique oportunidades**: localize as oportunidades com atualizações a 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 oportunidades 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 `opportunity-inbound` pasta. Todos os arquivos compartilhados AWS são automaticamente arquivados na `opportunity-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 [Opportunity Results Success Sample.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-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 as mensagens de erro de cada oportunidade.
   + Esses resultados processados também são arquivados na `opportunity-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.