

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á.

# Configurando o conector para um CRM com integração com o Amazon S3
<a name="s3-config"></a>

**Importante**  
A partir de 2024, o AWS Partner Central tornou esse tipo de integração indisponível para novos usuários. 

**nota**  
Os tópicos desta seção pressupõem que você tenha concluído os pré-requisitos para uma integração com o AWS Partner Central, uma integração com o AWS Marketplace ou ambas. Para obter mais informações, consulte [Pré-requisitos de integração](crm-integration-setting-up.md) e veja as [Introdução](crm-integration-getting-started.md) versões anteriores deste guia.

O CRM obsoleto com a integração do Amazon S3 usa um bucket do Amazon S3 para transferir leads e oportunidades. Recomendamos usar a integração da API do Partner Central, conforme mostrado na seção anterior, para criar e gerenciar oportunidades. No entanto, você pode usar essa configuração se quiser usar o conector para gerenciar leads no Salesforce.

**Topics**
+ [Inserindo detalhes de autenticação de conexão](#apn-s3-authentication-details)
+ [Inserindo as configurações do sistema](#apn-s3-config-settings)
+ [Testar a conexão](#apn-s3-testing)
+ [Enviando e recebendo oportunidades e leads](#sending-receiving-opportunities-leads)
+ [Lista de verificação de produção](ace-production-checklist.md)
+ [Atualizando o conector AWS Partner CRM para o novo modelo de dados](connector-upgrade-plan.md)
+ [Teste em sandbox com a oportunidade ACE personalizada e os objetos principais do ACE](custom-ace-opportunity.md)
+ [Vinculando ofertas AWS Marketplace privadas a oportunidades da ACE](#linking-private-offers-to-ace)

## Inserindo detalhes de autenticação de conexão
<a name="apn-s3-authentication-details"></a>

Os parceiros iniciam o processo de integração inserindo os detalhes necessários para se conectar ao endpoint Amazon S3. Siga cada conjunto de etapas na ordem listada e conclua cada conjunto antes de prosseguir para o próximo.

As tarefas a seguir são executadas na guia de **configuração AWS guiada**. Para obter informações sobre como usar a guia, consulte o [Usando a configuração guiada](use-guided-setup.md) artigo anterior neste guia.

**Para inserir os detalhes de autenticação**

1. No Salesforce, abra a **AWS guia de configuração guiada**. Para obter informações sobre como abrir essa guia, consulte o [Usando a configuração guiada](use-guided-setup.md) artigo anterior neste guia. 

1. Expanda **Etapa 1: detalhes da autenticação de AWS conexão** e escolha **Iniciar.**

1. Na página **Credenciais nomeadas**, escolha **Novo anteriormente**.

1. No formulário **Nova credencial nomeada**, insira os valores da tabela a seguir.


| **Campo** | **Valor** | 
| --- | --- | 
| Rótulo | Conexão da API APN  | 
| URL | [https://s3.us-west-2.amazonaws.com](https://s3.us-west-2.amazonaws.com) | 
| Tipo de identidade | Diretor nomeado  | 
| Protocolo de autenticação | AWS assinatura versão 4  | 
| AWS ID de chave de acesso | O Cloud-Ops fornece o ID durante as etapas de pré-requisito  | 
| AWS chave de acesso secreta = "" | O Cloud-Ops fornece a chave de acesso durante as etapas de pré-requisito  | 
| AWS Região | us-west-2  | 
| AWS service | s3  | 
| Gerar cabeçalho de autorização | checked  | 
| Permitir campos de mesclagem no cabeçalho HTTP | não verificado  | 
| Permitir campos de mesclagem no corpo HTTP | não verificado  | 

1. Escolha **Salvar**. 

1. Volte para a página de **configuração AWS guiada**. Na seção **Detalhes da autenticação**, escolha **Revisar** e confirme as credenciais. 

1. Mantenha a página de **configuração AWS guiada** aberta e vá para as próximas etapas.

## Inserindo as configurações do sistema
<a name="apn-s3-config-settings"></a>

As etapas a seguir explicam como inserir as configurações corretas do sistema para a integração.

1. Expanda **Etapa 2: Configurações do sistema** e escolha **Iniciar.** 

1. Localize as **configurações do AWS Partner CRM Connector** e escolha **Gerenciar**. 

1. Escolha **Novo** e, em seguida, insira os valores necessários na tabela a seguir.     
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/partner-central/latest/crm/s3-config.html)

1. Escolha **Salvar**. 

1. Volte para a página de **configuração AWS guiada**. Na seção **Detalhes da autenticação**, escolha **Revisar** e confirme as credenciais. 

## Testar a conexão
<a name="apn-s3-testing"></a>

Antes de testar a conexão, certifique-se de concluir as etapas nas seções anteriores.

**Para testar a conexão com a**

1. Expanda **a Etapa 3: Teste a configuração da API da APN.**

1. Escolha **Testar**.

Se a conexão for bem-sucedida, você receberá uma mensagem de confirmação. 

## Enviando e recebendo oportunidades e leads
<a name="sending-receiving-opportunities-leads"></a>

Você envia e recebe oportunidades e leads sincronizando-os com o Partner Central. Para sincronizar uma oportunidade ou lead, você deve definir o campo **Sincronizar com o Partner Central** como **True**. Campos-chave adicionais para integração incluem a **Data da última sincronização do APN** e os campos **Elegíveis para sincronização com o APN.**

Esses campos estão incluídos para oportunidades e leads padrão. No entanto, você deve criá-los e mapeá-los para qualquer objeto de origem personalizado.
+ **Sincronize com o Partner Central** — incluído no aplicativo para oportunidades e leads padrão. Se a AWS Partner optar por mapear para objetos personalizados, um campo booleano personalizado deverá ser criado e mapeado nos mapeamentos de oportunidades e leads, respectivamente.
+ **Data da última sincronização com o APN** — Indica a última vez em que o registro foi enviado ou recebido com sucesso do APN. Esse campo é configurado automaticamente quando o registro é enviado com sucesso para o APN ou uma atualização é recebida do APN.
+ **Qualificado para sincronização com o APN** — Um campo de fórmula que determina se o registro está destinado a ser enviado ao APN no próximo trabalho agendado. Calculado com base no fato de o registro ter sido modificado desde a última vez em que a programação de saída foi executada e atualizado por um usuário que não seja o usuário de integração designado para a AWS Partner organização.

# Lista de verificação de produção
<a name="ace-production-checklist"></a>

Siga estas etapas para concluir a instalação de produção do seu conector de AWS Partner CRM.

1. Confirme se você concluiu o [processo de integração](https://docs.aws.amazon.com/partner-central/latest/crm/crm-integration-getting-started.html) do CRM. Na [etapa 6](https://docs.aws.amazon.com/partner-central/latest/crm/stage-6-production-approval.html) desse processo, você configura seu ambiente de produção e executa a migração de dados para poder gerenciar oportunidades e leads por meio da integração. 

1. Instale e configure o conector do CRM. Para obter mais informações, consulte [Instalando o conector](install-connector.md).

1.  Mapeie oportunidades e objetos principais escolhendo uma das seguintes opções de mapeamento. Para referência, consulte esta lista de [campos obrigatórios](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv) em GitHub.
   + Use o objeto personalizado de oportunidade AWS ACE fornecido com o conector AWS Partner CRM para registrar oportunidades e compartilhá-las com AWS. Usando essa opção, você pode mapear automaticamente AWS os campos para os campos do Salesforce.
   + Use o objeto padrão do Salesforce e mapeie os campos obrigatórios AWS .
   + Use um objeto de oportunidade personalizado ACE. Primeiro, você cria um fluxo de trabalho para preencher uma tabela intermediária de objetos de oportunidade ACE e, em seguida, mapeia os campos do Salesforce para. AWS

1. Para obter detalhes adicionais e orientações sobre as opções de mapeamento, consulte[Mapeando objetos ACE](crm-connector-mapping.md).

1. (Opcional) Configure agendas de sincronização de entrada e saída entre a Rede e o AWS Partner Salesforce. Para obter detalhes, consulte [Criação de agendamentos de sincronização](crm-connector-scheduling.md).

1. Para validar uma oportunidade de produção originada por um parceiro, crie um [caso de suporte](https://docs.aws.amazon.com/partner-central/latest/crm/crm-integration-faq.html#troubleshooting) com o Partner Central Operations (PCO) em sua conta do Partner Central. Nesse processo, você cria uma oportunidade fictícia, a sincroniza e pede ao agente de AWS suporte que confirme se AWS recebeu a oportunidade. AWS Ao final do teste, peça ao seu agente de AWS suporte que rejeite a solicitação de oportunidade para que você possa excluí-la do seu lado.

1. (Opcional) Execute o preenchimento de dados. Esse processo garante que as referências de oportunidades AWS originadas e originadas pelo parceiro possam ser identificadas durante futuras atualizações. Para obter mais informações, consulte [Etapa 6: aprovação da produção](https://docs.aws.amazon.com/partner-central/latest/crm/stage-6-production-approval.html) no processo de integração do CRM.

1. Ative a integração de produção para permitir a troca de arquivos por meio do bucket Amazon S3. Para obter detalhes, consulte [Estágio 7: Lançamento](https://docs.aws.amazon.com/partner-central/latest/crm/stage-7-launch.html).

# Atualizando o conector AWS Partner CRM para o novo modelo de dados
<a name="connector-upgrade-plan"></a>

**Importante**  
Teste e aprove a nova atualização do modelo de dados em sua organização sandbox da Salesforce antes de atualizar seu ambiente de produção. Para o novo modelo de dados e as mudanças entre os modelos antigo e novo, consulte o seguinte [partner-crm-integration-samplesaws-samples/](https://github.com/aws-samples/partner-crm-integration-samples/tree/main/opportunity-samples) on: GitHub  
**Oportunidade- FieldsAndStandardValues - DiffWithPrevVersion -V14.3.xlsx**
**Opportunity-Fields.xlsx**
**StandardValuesOportunidade\$1-\$1 .xlsx**

## Pré-requisitos
<a name="connector-upgrade-prereqs"></a>
+ Use definições de campo para novas diretrizes de modelo de dados da integração do ACE CRM e migre todas as oportunidades e leads abertos necessários para o novo modelo de dados.
+ Adicione ou remova colunas em seus objetos personalizados ou padrão (objetos usados no mapeamento).
+ Verifique se você está usando a versão 2.0 ou posterior do conector AWS Partner CRM.

**Para fazer o upgrade para o novo modelo de dados**

1. Entre na sua organização do Salesforce como administrador do sistema.

1. Desative todas as programações ativas.

1. Escolha **Configuração**, **Configurações personalizadas, Configurações do** **conector AWS Partner CRM** e, em seguida, atualize a versão para **2.0** ou posterior.
**nota**  
A partir da versão 2.0, o campo **Versão** é obrigatório. Esse campo especifica a versão da carga útil que os parceiros usam para interagir com a integração do CRM. Quando os parceiros migram para a versão 2.0, eles devem adotar totalmente suas especificações. Não é permitido reverter para versões anteriores.

1. Escolha a guia **Mapeamento ACE**.

1. Crie, revise e atualize todos os mapeamentos e detalhes de campo obrigatórios. Para testes em sandbox, use a oportunidade ACE personalizada e o objeto principal ACE para testar os novos recursos do modelo de dados. Para obter mais informações, consulte [Teste em sandbox com a oportunidade ACE personalizada e os objetos principais do ACE](custom-ace-opportunity.md).

1. Ative cronogramas para oportunidades e leads.

1. Analise os registros de sincronização do ACE em busca de erros de sincronização e faça as correções.

1. Analise as oportunidades e os leads sincronizados para garantir que a transformação dos dados seja precisa. Como alternativa, analise as oportunidades e os leads no ACE para garantir que as novas alterações do modelo de dados sejam capturadas com precisão.

1. Siga o processo de implantação do produto para migrar as alterações para o ambiente de produção do Salesforce.
**nota**  
Se precisar de ajuda, consulte[Como obter ajuda](getting-help.md).

# Teste em sandbox com a oportunidade ACE personalizada e os objetos principais do ACE
<a name="custom-ace-opportunity"></a>

**nota**  
Se você já for um usuário do conector de CRM, consulte. [Atualizando o conector AWS Partner CRM para o novo modelo de dados](connector-upgrade-plan.md)

1. Entre na sua organização do Salesforce como administrador do sistema.

1. Escolha **Configuração**, **Configurações personalizadas, Configurações do** **conector AWS Partner CRM** e atualize a versão para **2**.

1. Escolha a guia **Mapeamento ACE**.

1. Para **Opportunity**, mapeie-o para o objeto personalizado da **oportunidade ACE**.

1. Escolha o **objeto ACE do Auto Map**.
**nota**  
Se você quiser atualizar para a nova versão do conector CRM que deseja usar a oportunidade ACE personalizada e os objetos principais ACE do conector para testes em sandbox, recomendamos excluir manualmente todos os registros disponíveis do `Field Mappings` e `Field Mapping Details` objetos do banco de dados antes de usar o recurso de objeto ACE do Auto Map. Você só precisa fazer isso uma vez.

1. Revise os mapeamentos de campo e os valores de mapeamento de campo para lista de opções e lista múltipla.

1. Ative cronogramas para oportunidades e leads.

1. Revise os registros de sincronização do ACE em busca de erros de sincronização e faça as correções necessárias.

1. Analise as oportunidades e os leads sincronizados para garantir que a transformação dos dados seja precisa. Como alternativa, analise as oportunidades e os leads no ACE para garantir que as novas alterações do modelo de dados tenham sido capturadas com precisão.

## Visualizando registros detalhados do registro de sincronização para oportunidades de ACE
<a name="sync-log-detail-records"></a>

 Você pode ver os detalhes do registro de sincronização AWS de oportunidades ACE entregues na guia **Relacionados** no registro de oportunidades ACE. 

**nota**  
Essas etapas se aplicam somente aos objetos AWS de oportunidade ACE entregues. Se você mapear objetos padrão ou personalizados em sua organização do Salesforce, poderá visualizar os detalhes do registro de sincronização na guia Registro de **sincronização ACE**.

1. Faça login na sua organização do Salesforce.

1. No **Iniciador de aplicativos**, escolha Conector **AWS Partner CRM.**

1. Escolha a guia **Oportunidades ACE**.

1. Escolha um registro de oportunidade ACE.

1. Escolha a guia **Relacionado** para ver detalhes, incluindo **nome do registro de sincronização**, **status**, **mensagem de erro** e **data de criação**.

## Vinculando ofertas AWS Marketplace privadas a oportunidades da ACE
<a name="linking-private-offers-to-ace"></a>

Você pode vincular ofertas privadas diretamente da página de registro de oportunidades da ACE AWS entregue.

1. Faça login na sua organização do Salesforce.

1. No **Iniciador de aplicativos**, escolha Conector **AWS Partner CRM.**

1. Escolha a guia **Oportunidades ACE**.

1. Escolha um registro de oportunidade ACE.

1. Escolha **Link Private Offer**.

1. Em **Offer ID Look Up**, escolha a oferta privada.

1. Escolha **Salvar**.