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á.
# O que é o conector AWS Partner CRM para Salesforce?
Os tópicos desta seção explicam como instalar e usar o conector AWS Partner CRM, uma solução sem código para integrar o Salesforce com o AWS Partner Central e. AWS Marketplace
**Topics**
+ [Visão geral do conector CRM](connector-overview.md)
+ [Recursos disponíveis](crm-connector-feature-list.md)
+ [Instalando o conector](install-connector.md)
+ [Atualizando o conector para a versão mais recente](upgrading-from-previous-versions.md)
+ [Configurando notificações em tempo real para o AWS Partner Central e AWS Marketplace eventos](set-up-real-time-notifications.md)
+ [Mapeando objetos ACE](crm-connector-mapping.md)
+ [Configurando o conector do CRM](configure-crm-connector.md)
+ [Usando o conector CRM no Salesforce](using-the-connector.md)
+ [Usando um CRM anterior com integração com o Amazon S3](custom-integration-using-amazon-s3.md)
+ [Como obter ajuda](getting-help.md)
+ [AWS Partner Perguntas frequentes sobre o conector CRM](crm-connector-faq.md)
+ [Notas da versão](crm-connector-release-notes.md)
# Visão geral do conector CRM
O conector de AWS Partner CRM permite que você integre sua organização do Salesforce com a Central de Parceiros da AWS e. AWS Marketplace A integração permite que você conclua a Central de Parceiros da AWS e AWS Marketplace as tarefas no Salesforce, como a sincronização bidirecional de oportunidades do ACE e a associação de ofertas às oportunidades.
O conector CRM está disponível gratuitamente e não requer codificação.
Os tópicos a seguir explicam os conceitos e os processos de uso do conector.
**Topics**
+ [Benefícios do conector](#connector-benefits)
+ [Usuários pretendidos](#connector-audience)
+ [Visão geral da instalação e do uso](#connector-process)
## Benefícios do conector
O conector AWS Partner CRM oferece os seguintes benefícios:
+ **Integração com a Central de Parceiros da AWS** — Gerenciamento simplificado de oportunidades. Você pode usar o Salesforce para enviar e receber oportunidades de AWS vendas e de outros parceiros. O conector também permite que você envie leads para AWS.
**nota**
Os parceiros que recebem leads de AWS continuam usando suas integrações com o Amazon S3. Para obter mais informações, consulte:
[Configurando o conector para um CRM com integração com o Amazon S3](s3-config.md)mais adiante nesta seção.
[Usando um CRM anterior com integração com o Amazon S3](custom-integration-using-amazon-s3.md)mais adiante neste guia.
+ **AWS Marketplace integração** — Use o Salesforce para gerenciar ofertas privadas, autorizações de revenda e concluir outras tarefas. AWS Marketplace
## Usuários pretendidos
O conector CRM deve ser usado pelos seguintes grupos:
+ Parceiros que buscam agilizar o processo de venda conjunta.
+ Fornecedores independentes de software (ISVs) que vendem produtos em. AWS Marketplace
+ AWS Parceiros de consultoria que gerenciam engajamentos e oportunidades com clientes.
## Visão geral da instalação e do uso
O processo de instalação e uso do conector AWS Partner CRM segue estas etapas gerais:
1. Preencha [Pré-requisitos de integração](crm-integration-setting-up.md).
1. Instale o conector a partir do Salesforce AppExchange. Consulte[Instalando o conector](install-connector.md), posteriormente nesta seção, as etapas de instalação.
1. Configure o conector para trocar dados com o AWS Partner Central e integrações anteriores do Amazon S3. AWS Marketplace Os tópicos em [Configurando o conector do CRM](configure-crm-connector.md) questão explicam como configurar o conector para cada tipo de integração.
# Recursos disponíveis
Os tópicos a seguir descrevem os recursos fornecidos pelo conector do AWS Partner CRM. Os recursos oferecem suporte ao engajamento de clientes AWS Partner (APN), gerenciam oportunidades e leads e integram o Salesforce com o. AWS Marketplace Você pode habilitar qualquer combinação dos recursos conforme necessário para atender às suas necessidades comerciais e modelos de AWS engajamento.
**Topics**
+ [Recursos da API do Partner Central](#partner-central-api-features)
+ [CRM com recursos do Amazon S3](#apn-customer-engagements)
+ [AWS Marketplace features](#feature-list-aws-marketplace)
## Recursos da API do Partner Central
A API do AWS Partner Central fornece os seguintes recursos:
+ Um conjunto de botões que os parceiros podem usar para ajudar a acelerar suas operações:
+ **Compartilhe com AWS** — Crie e atualize uma oportunidade.
+ **Status de aprovação** — Aceite ou rejeite as oportunidades AWS indicadas.
+ **Associar ou desassociar** — associe ou desassocie uma oportunidade com soluções, AWS produtos e AWS Marketplace ofertas de parceiros em todo o ciclo de vida da oportunidade.
+ **Atribuir** — reatribua uma oportunidade a outro usuário em sua conta do Partner Central.
+ No conector, os parceiros podem usar a guia **Oferta de soluções** para ver uma lista das soluções disponíveis.
+ Os parceiros podem usar a guia de **AWS Marketplace notificações** para visualizar os eventos gerados pela Amazon EventBridge. Os eventos incluem *oportunidade criada*, *oportunidade atualizada*, convite de engajamento *aceito* e convite de engajamento *rejeitado*.
**nota**
Para começar a usar a API do AWS Partner Central, consulte a [Referência da API do AWS Partner Central](https://docs.aws.amazon.com/partner-central/latest/crm/aws-partner-crm-integration.html).
Para migrar de um CRM anterior com a integração do Amazon S3 para a API AWS do Partner Central, consulte [Atualização de um CRM com integração do Amazon S3 para a API do Partner Central](upgrade-crm-api.md) antes de continuar.
A integração do conector do CRM com a API do AWS Partner Central faz o seguinte:
+ Permite a sincronização bidirecional quase em tempo real dos registros do ACE Opportunity.
+ Substitui a integração de CRM baseada no Amazon S3. AWS suporta as integrações anteriores, mas parou de aceitar novas integrações em 2024.
+ Os parceiros que recebem leads do ACE AWS continuam usando suas integrações baseadas no Amazon S3.
Depois de instalar o conector do AWS Partner CRM, você o configura para uso com uma integração de API do AWS Partner Central. Para obter mais informações sobre configuração, consulte [Configurando o conector para uma integração da API do Partner Central](p-c-api-integration.md) mais adiante nesta seção.
Para obter informações sobre como criar uma integração personalizada da API da Central de Parceiros da [AWS, consulte a Referência de API da Central de Parceiros](https://docs.aws.amazon.com/partner-central/latest/APIReference/aws-partner-central-api-reference-guide.html) da AWS.
## CRM com recursos do Amazon S3
O conector CRM fornece os seguintes recursos quando você o configura para um CRM anterior com integração com o Amazon S3.
+ **AWS oportunidades originadas** — No Salesforce, você pode trocar oportunidades de covenda com o departamento de vendas. AWS Você recebe oportunidades quando o AWS departamento de vendas identifica um cliente que poderia se beneficiar de sua solução.
+ **Oportunidades originadas por parceiros** — No Salesforce, você pode trocar oportunidades de coselling com outros parceiros. Você pode criar oportunidades e vinculá-las às relevantes Serviços da AWS. Isso pode ajudar a simplificar os esforços de colaboração.
+ **AWS referências de leads** — Isso permite que você receba leads AWS que podem ser uma boa opção para suas ofertas. Esses leads podem ser clientes em potencial que expressam interesse em suas soluções.
+ **Painel** — Uma visão geral centralizada no Salesforce de suas atividades de coselling. Dependendo de como você configura o conector, isso pode incluir oportunidades e leads.
Para obter mais informações sobre como configurar o conector do CRM, consulte [Configurando o conector do CRM](configure-crm-connector.md) mais adiante neste guia.
## AWS Marketplace features
**Várias contas de AWS Marketplace vendedor** — No Salesforce, você pode gerenciar ofertas privadas, autorizações de revenda e outras funções para suas contas de vendedor. AWS Marketplace
**Tipos de AWS Marketplace produtos compatíveis** — O conector é compatível com os seguintes tipos de produtos:
+ SaaS
+ AMI
+ Contêineres
**Painéis** — Uma visão geral consolidada de suas ofertas privadas no Salesforce.
### Recursos de fornecedor independente de software (ISV)
O conector CRM fornece os seguintes recursos para ISVs.
**Recursos gerais**
+ No Salesforce, visualize suas listas de AWS Marketplace produtos e gerencie portfólios de produtos e atividades de covenda.
+ No Salesforce, crie e gerencie ofertas privadas para seus produtos listados AWS Marketplace . Crie cronogramas de pagamento flexíveis para todas as ofertas privadas suportadas. Para ofertas de SaaS e contratos, crie contratos com data futura.
+ Acelere o processo de adoção do conector importando ofertas privadas.
**Recursos de gerenciamento de ofertas privadas**
+ **Criar/publicar** — Use o Salesforce para publicar ofertas privadas.
+ **Rascunho** — Salve ofertas privadas como rascunhos antes de publicá-las.
+ **Modificar** — Altere a data de expiração de uma oferta privada.
+ **Cancelar** — Remova as ofertas privadas publicadas.
+ **Clonar** — Crie uma cópia de uma oferta privada como ponto de partida para uma nova oferta.
**Recursos de gerenciamento de contratos**
+ **Exibir** — Acesse AWS Marketplace contratos no Salesforce.
+ **Importar** — Importe contratos de AWS Marketplace dentro do conector.
**Recursos para ofertas baseadas em contratos**
+ **Ofertas baseadas em contratos — Use contratos para criar ofertas** direcionadas aos clientes. Isso ajuda a simplificar o processo de cotação e compra.
**Recursos de autorização de revenda**
+ **Criar/publicar** — Crie autorizações de revenda e permita que parceiros de AWS Marketplace canal revendam seus produtos.
+ **Rascunho** — Salve as solicitações de autorização de revenda para análise antes de enviá-las.
+ **Desativar** — Use o conector para desativar as autorizações de revenda que você não precisa mais.
+ **Clonar** — clone uma autorização de revenda para acelerar a criação de uma nova autorização de revenda.
**Características do parceiro de canal**
Se você se inscreveu como parceiro de AWS Marketplace canal, pode usar autorizações de revenda compartilhadas para simplificar o processo de revenda de produtos para seus parceiros de canal. O conector permite que você faça o seguinte:
+ Veja as autorizações de revenda compartilhadas no Salesforce.
+ **Use as mesmas funções de gerenciamento das ofertas privadas: **criar/publicar**, **modificar**, **cancelar** e clonar.**
# Instalando o conector
Os conjuntos de etapas a seguir explicam como instalar e desinstalar o conector AWS Partner Customer Relationship Management (CRM).
**Topics**
+ [Instalando o conector](#first-install)
+ [Confirmação da instalação](#confirm-the-installation)
+ [Desinstalar o conector](#uninstall-connector)
+ [Entendendo os limites do administrador do Salesforce](#connector-limits)
## Instalando o conector
As etapas a seguir explicam como instalar o conector CRM em uma organização do Salesforce. Siga estas etapas para instalar o conector pela primeira vez e instalar novas versões do conector.
**nota**
Para concluir essas etapas, você deve ter o seguinte:
Uma edição Enterprise, Professional ou Unlimited do Salesforce.
Acesso administrativo à sua organização do Salesforce.
**Para instalar uma nova versão**
1. Navegue até o **AWS Partner CRM Connector **AppExchange****e pesquise por ele.
—OU—
Vá para [ https://appexchange.salesforce.com/appxListingDetail? IYfListingId=A0N4V00000](https://appexchange.salesforce.com/appxListingDetail?listingId=a0N4V00000IYf0nUAD) 0NUAD.
1. Escolha **Adquirir agora**.
1. Na página **Onde você deseja instalar este pacote**, escolha **Instalar na sandbox**.
1. Na página **Detalhes de confirmação da instalação**, marque a caixa de seleção **Eu li os termos e condições e** escolha **Confirmar e instalar**.
1. Faça login no Salesforce.
**nota**
Certifique-se de fazer login no domínio correto. Conforme necessário, escolha **Usar domínio personalizado** e insira o nome de domínio correto.
1. Escolha a opção **Instalar somente para administradores** e, em seguida, escolha **Instalar**.
1. Escolha a caixa de seleção **Sim, conceder acesso a esses sites de terceiros** e escolha **Continuar**.
## Confirmação da instalação
Para confirmar a instalação do pacote, escolha **Início**, **Aplicativos**, **Empacotamento**, **Pacotes instalados**.
Se a nova versão do conector não aparecer na lista de pacotes instalados, siga as etapas [Como obter ajuda](getting-help.md) para entrar em contato com o suporte.
**nota**
Depois de confirmar a instalação, conclua as etapas listadas [Atualizando o conector para a versão mais recente](upgrading-from-previous-versions.md) para instalar os recursos mais recentes.
## Desinstalar o conector
Antes de desinstalar o conector AWS Partner Customer Relationship Management (CRM), remova todos os conjuntos de permissões de [integração ACE e conjuntos de permissões](crm-connector-pemissions-sets.md) de [AWS Marketplace integração](mkt-permissions-sets.md) do usuário.
**Como desinstalar o conector**
1. No Salesforce, escolha **Início**, **Aplicativos**, **Empacotamento, Pacotes** **instalados**.
1. Clique em **Desinstalar**.
## Entendendo os limites do administrador do Salesforce
Ao implementar o AWS Partner CRM Connector, esteja ciente dos limites do administrador do Salesforce, especialmente em relação ao consumo de consultas SOQL. Esses limites podem afetar significativamente sua lógica comercial personalizada e o desempenho geral do sistema. Recomendamos revisar a documentação oficial da Salesforce sobre os limites do administrador e as melhores práticas para otimização de consultas. Para obter orientação detalhada, consulte os seguintes recursos do Salesforce:
+ [Visão geral dos limites do administrador do Salesforce no Guia do](https://developer.salesforce.com/docs/atlas.en-us.apexcode.meta/apexcode/apex_gov_limits.htm) desenvolvedor do *Apex*
+ [Melhores práticas para SQLS e SOSL](https://developer.salesforce.com/docs/atlas.en-us.apexcode.meta/apexcode/apex_gov_limits.htm?q=SOSL+SOQL+best+practices+limits)
# Atualizando o conector para a versão mais recente
Os tópicos a seguir explicam como atualizar o conector do AWS Partner CRM para a versão mais recente. A atualização envolve a adição de botões, detalhes do registro de sincronização e valores de mapeamento aos seus registros de oportunidades.
**nota**
Para obter informações sobre como atualizar uma integração com o Amazon S3, consulte [Atualização de um CRM com integração do Amazon S3 para a API do Partner Central](upgrade-crm-api.md) mais adiante neste guia.
**Topics**
+ [Adicionando o botão Autorização de Importação de Revenda](#add-resale-authorization)
+ [Adicionando o botão Importar oferta](#import-offer-btn)
+ [Adicionando o botão Importar Contrato](#import-agreements-btn)
+ [Adicionando detalhes do registro de sincronização à página de registro de oportunidades do ACE](#add-sync-log-details-ace)
+ [Adicionar valores de mapeamento ao rótulo Motivo perdido fechado](#map-closed-lost)
## Adicionando o botão Autorização de Importação de Revenda
As etapas a seguir explicam como adicionar o botão **Autorização de Importação de Revenda** à seção de **Autorização de Revenda** de uma oportunidade. O botão permite que você importe autorizações de revenda de. AWS Marketplace
**Para adicionar o botão**
1. Entre na sua organização do Salesforce como administrador do sistema.
1. Escolha **Configuração, Gerenciador de objetos** e, em seguida, escolha **Autorização de revenda**.
1. No painel de navegação esquerdo, escolha **Layout do botão de exibição de lista**.
1. Escolha **Editar** para abrir o editor de exibição de lista.
1. Na seção **Botões personalizados**, na coluna **Botões disponíveis**, escolha **Importar autorização de revenda**.
1. Escolha o botão de seta para a direita para adicionar a **Autorização de Importação de Revenda** à lista de **Botões Selecionados**.
1. Escolha **Salvar**.
Depois de atualizar para a versão 2.2 ou posterior, faça o seguinte:
+ Para garantir que as informações do produto estejam atualizadas, atualize seus produtos na guia **Atualizar produtos**.
+ Siga os procedimentos nesta seção para concluir a transição para a versão 2.2.
## Adicionando o botão Importar oferta
As etapas a seguir explicam como adicionar o botão **Importar oferta**.
**Para adicionar o botão**
1. Entre na sua organização do Salesforce como administrador do sistema.
1. Escolha **Configuração, Gerenciador de objetos**.
1. Escolha a **oferta privada**.
1. No painel de navegação esquerdo, escolha **Layout do botão de exibição de lista** e escolha **Editar** para abrir o editor de exibição de lista.
1. Na seção **Botões personalizados**, na coluna **Botões disponíveis**, escolha **Importar oferta**.
1. Escolha o botão de seta para a direita para adicionar a **Oferta de Importação** à lista de **Botões Selecionados**.
1. Escolha **Salvar**.
## Adicionando o botão Importar Contrato
As etapas a seguir explicam como adicionar o botão **Importar contrato** à seção **Contratos** de um registro de oportunidade.
**Para adicionar o botão**
1. Entre na sua organização do Salesforce como administrador do sistema, escolha **Configuração** e depois Gerenciador de **objetos**.
1. Escolha **Contrato** e, na seção **Detalhes**, escolha **Editar**.
1. Escolha **Permitir pesquisa**.
1. Escolha **Salvar**.
1. No painel de navegação esquerdo, escolha **Layout do botão de exibição de lista**.
1. Na seção **Botões personalizados**, na coluna **Botões disponíveis**, escolha **Importar contrato** e, em seguida, escolha o botão de seta para a direita para adicionar **contrato de importação** à lista **Botões selecionados**.
1. Escolha **Salvar**.
## Adicionando detalhes do registro de sincronização à página de registro de oportunidades do ACE
As etapas a seguir explicam como adicionar detalhes do log de sincronização a uma página ACE Opportunity Record.
**Para adicionar os detalhes do registro**
1. Entre na sua organização do Salesforce como administrador do sistema.
1. Escolha **Configuração, Gerenciador de objetos**.
1. Escolha **ACE Opportunity**.
1. No painel de navegação esquerdo, escolha **ACE Opportunity Layout**.
1. Escolha **Listas relacionadas**.
1. Escolha e mova **Detalhes do registro de sincronização** para a seção **Listas relacionadas** do layout da página.
1. Escolha **Salvar**.
1. Personalize listas relacionadas para **detalhes do registro de sincronização** e adicione campos de **data de criação**, **mensagens de erro** e **status** às **listas relacionadas**. Para obter mais informações, consulte [Personalizar listas relacionadas](https://help.salesforce.com/s/articleView?id=sf.customizing_related_lists.htm) na ajuda do Salesforce.
1. Escolha **Salvar**.
**nota**
A versão 2.2 do conector CRM apresenta um caminho para oportunidades AWS de ACE oferecidas. Para obter informações sobre a visualização desse caminho, consulte [Habilitar caminhos](https://help.salesforce.com/s/articleView?id=sf.emergency_response_create_paths.htm) na ajuda do Salesforce.
## Adicionar valores de mapeamento ao rótulo Motivo perdido fechado
As etapas a seguir explicam como adicionar valores de mapeamento automático de campo ao rótulo **Closed Lost Reason** dos objetos de oportunidade ACE.
**Para adicionar os valores de mapeamento**
1. Entre na sua organização do Salesforce como administrador do sistema.
1. Escolha a guia **Mapeamentos ACE**.
1. Na barra de navegação, escolha **Oportunidade**.
1. No **Seletor de objetos**, escolha **ACE Opportunity**.
1. Para o rótulo **Motivo da perda fechada**, escolha **Editar valores**.
1. Escolha **Mapa automático**.
1. Escolha **Próximo**.
1. Escolha **Salvar**.
# Configurando notificações em tempo real para o AWS Partner Central e AWS Marketplace eventos
Os tópicos a seguir explicam como configurar EventBridge notificações em tempo real para a AWS Partner Central e AWS Marketplace os eventos. Você pode configurar notificações no Salesforce configurando um aplicativo conectado ou pode usar modelos. AWS CloudFormation
**Topics**
+ [Configurando um aplicativo conectado ao Salesforce](#configuring-salesforce-connected-app)
+ [Usando uma AWS CloudFormation pilha para configurar notificações](#configuring-aws-components)
## Configurando um aplicativo conectado ao Salesforce
As etapas a seguir explicam como configurar um aplicativo conectado no Salesforce. Você deve criar um aplicativo conectado para usar a OAuth autenticação nas conexões de destino. Para obter mais informações, consulte[Criação manual de componentes de notificação](#manual-creation-of-aws-components), posteriormente neste guia.
1. Entre na sua organização do Salesforce como administrador do sistema.
1. Em **Configuração**, na caixa **Busca rápida****apps**, digite e selecione **Gerenciador de aplicativos**.
1. Na página do **Lightning Experience App Manager**, escolha **Novo aplicativo conectado**, escolha **Criar um aplicativo conectado** e escolha **Continuar**.
A página **Novo aplicativo conectado** é exibida.
1. Faça o seguinte:
1. Na caixa **Nome do aplicativo conectado**, insira um nome para o aplicativo.
1. Na caixa **E-mail de contato**, insira seu endereço de e-mail.
1. (Opcional) Preencha os campos restantes conforme descrito em [Definir as configurações básicas do aplicativo conectado](https://help.salesforce.com/s/articleView?id=sf.connected_app_create_basics.htm), na documentação do Salesforce.
1. Marque a caixa de seleção **Ativar OAuth configurações** e faça o seguinte:
1. Marque a caixa de seleção **Ativar para fluxo de dispositivos**. Você pode ignorar o URL de retorno de chamada resultante.
1. Em ** OAuth Escopos disponíveis**, selecione **Gerenciar dados do usuário via APIs** e use o botão **Adicionar** para mover o escopo para a lista de escopos selecionados.
1. Selecione as seguintes caixas de seleção:
+ **Exigir chave de prova para extensão de troca de código (PKCE) para fluxos de autorização compatíveis**
+ **Exigir segredo para o fluxo do servidor Web**
+ **Exigir segredo para atualizar o fluxo do token**
+ **Ativar fluxo de credenciais do cliente**
1. Na mensagem que aparece depois de selecionar **Ativar fluxo de credenciais do cliente**, escolha **OK**.
1. Navegue até o final da página e escolha **Salvar**.
1. Escolha **Continuar** e, em seguida, escolha **Gerenciar detalhes do consumidor**.
A página **Verificar sua identidade** é exibida e o sistema envia um código de verificação para seu endereço de e-mail de contato.
1. Insira o código de verificação na caixa **Código de verificação** e escolha **Verificar**.
A página do seu aplicativo conectado é exibida.
1. Em **Detalhes do consumidor**, escolha os botões **Copiar** para a chave do consumidor e o segredo do cliente.
1. Em **Configuração**, na caixa **Busca rápida**, insira **Aplicativos**, selecione **Gerenciar aplicativos conectados** e escolha o aplicativo conectado que você acabou de criar.
1. Escolha **Editar políticas** e faça o seguinte:
1. Na lista **Usuários permitidos**, escolha **Todos os usuários podem se autoautorizar.**
1. Na lista de **relaxamento de IP**, escolha **Impor restrições de IP**.
1. Na lista **Executar como**, selecione o usuário de *execução, o usuário* ao qual você atribui o fluxo de credenciais do cliente. O Salesforce exige que o usuário de execução retorne tokens de acesso em nome do usuário.
1. Escolha **Salvar**.
## Usando uma AWS CloudFormation pilha para configurar notificações
Os tópicos a seguir explicam como usar AWS CloudFormation modelos para configurar EventBridge notificações em tempo real. As etapas se aplicam somente à versão 3.0 e posterior do conector AWS Partner CRM.
Para o conector AWS Partner CRM versão 3.0 e posterior, você pode usar um CloudFormation modelo para configurar os AWS componentes para a EventBridge integração com a Amazon ou criar os componentes manualmente. Para usar CloudFormation, baixe os modelos em:
**Topics**
+ [Encontrando o URL do seu domínio](#find-domain-url)
+ [Usando a CloudFormation pilha](#downloading-templates)
+ [Criação manual de componentes de notificação](#manual-creation-of-aws-components)
+ [Exemplos de regras](#example-rules)
### Encontrando o URL do seu domínio
O CloudFormation modelo usa o URL do seu domínio como um dos parâmetros obrigatórios.
**Para encontrar o URL**
1. Faça login no Salesforce.
1. Na seção **Configuração**, na caixa **Busca rápida**, digite**my domain**.
1. No painel esquerdo, em **Configurações da empresa**, escolha o link **Meu domínio**.
1. Copie o endereço na caixa **URL atual do meu domínio**.
**nota**
Você deve usar o prefixo https://ao inserir o URL no CloudFormation modelo.
### Usando a CloudFormation pilha
As etapas nos tópicos a seguir explicam como criar e implantar uma CloudFormation pilha que configura notificações em tempo real.
1. Faça o download dos seguintes modelos:
**nota**
Você implanta cada modelo separadamente e segue as mesmas etapas para ambos.
+ Integração da API do Partner Central: [https://servicecatalogconnector.s3.amazonaws.com/APIDestinationCFT\$1PCAPI.json](https://servicecatalogconnector.s3.amazonaws.com/APIDestinationCFT_PCAPI.json)
+ AWS Marketplace Integração (opcional): [https://servicecatalogconnector.s3.amazonaws.com/APIDestinationAWSMPCFT\$1](https://servicecatalogconnector.s3.amazonaws.com/APIDestinationCFT_AWSMP.json) .json
1. No AWS console, faça login na sua conta de AWS Marketplace vendedor e verifique se ela funciona na **Virgínia do Norte**. EventBridge opera somente nessa região.
1. Ainda no console, pesquise **cloudformation** e abra o CloudFormation console.
1. Na página **Pilhas**, escolha **Criar pilha**.
1. **Selecione os botões de opção Escolher um modelo existente** e **Carregar um arquivo de modelo**.
1. Selecione **Escolher arquivo** para abrir o modelo baixado e escolha **Avançar**.
1. Na página **Especificar detalhes da pilha**, insira o seguinte:
+ **Nome da pilha** — insira um nome para a pilha.
+ **ID do cliente** — insira a chave do consumidor que você anotou ao criar o aplicativo conectado.
+ **Segredo do cliente** — insira o segredo do consumidor que você anotou ao criar o aplicativo conectado.
+ **URL do domínio** — Use o seguinte formato: **https://*domain\$1URL*.**
Quando terminar, escolha **Next** (Próximo).
1. **Na página **Configurar opções de pilha**, vá até o final, marque a caixa de seleção **Eu reconheço que AWS CloudFormation pode criar recursos do IAM** e escolha Avançar.**
1. Selecione **Enviar**.
Quando implantados com sucesso, os modelos criam o destino da API, a conexão, as regras de eventos e a fila de letras mortas.
### Criação manual de componentes de notificação
As etapas a seguir explicam como criar manualmente os componentes para EventBridge notificações.
**Topics**
+ [Crie um destino e uma conexão de EventBridge API da Amazon](#manual-destination-connection)
+ [Criar uma EventBridge regra e conectá-la ao destino da API](#create-connect-ev-rule)
+ [Criação de eventos do conjunto de alterações](#change-set-events)
+ [Criação de ofertas e eventos lançados](#offer-released-events)
+ [Criação de eventos de oportunidades](#opportunity-events)
+ [Tipos de eventos](#types-of-events)
+ [Exemplo de evento do](#example-event)
#### Crie um destino e uma conexão de EventBridge API da Amazon
Para criar um destino de API e uma conexão em EventBridge, crie um destino de API que use uma nova conexão. Nesse caso, o destino da API é uma chamada da API REST para o Salesforce para publicar um evento novamente. A conexão contém as informações de autenticação para a chamada da API. A conexão aceita vários métodos de autorização.
**Pré-requisitos**
Para usar a OAuth autorização para a conexão de destino da API, crie um aplicativo conectado no Salesforce. Para fazer isso, siga as etapas em [Configurar um aplicativo conectado para o fluxo de credenciais do cliente OAuth 2.0](https://help.salesforce.com/s/articleView?id=sf.connected_app_client_credentials_setup.htm), na documentação do Salesforce. Você usa a chave do consumidor e o segredo do aplicativo conectado para a conexão de destino da API.
Para criar um destino de API no EventBridge console:
+ Siga as etapas em [Criar um destino de API](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-api-destinations.html#eb-api-destination-create) no *Guia do EventBridge usuário da Amazon*.
+ Defina as configurações específicas do Salesforce.
No Salesforce, na página **Meu domínio**, em **Configuração**, anote o nome de domínio da sua organização. Você o usa para configurar o destino e a conexão da API no EventBridge console. As etapas a seguir explicam como.
**Para criar o destino e a conexão**
1. Abra o EventBridge console em e [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/), no painel de navegação esquerdo, escolha **destinos de API**.
1. Role para baixo até a tabela de **destinos da API** e escolha **Criar destino da API**.
A página **Criar destino da API** é exibida.
1. Insira as seguintes informações:
1. Um **nome** para o destino da API. Você pode usar até 64 letras maiúsculas ou minúsculas, números, pontos (.), traços (-) ou caracteres de sublinhado (\$1).
O nome deve ser exclusivo na sua conta na sua região atual.
1. (Opcional) Insira uma **descrição** do destino da API.
1. Para o **endpoint de destino da API**, use este URL:**https://*my-salesforce-domain-name*.my.salesforce.com/services/data/v58.0/sobjects/*event-api-name***.
1. Em **Método HTTP**, selecione **POST**.
1. Em **Configuração de conexão**, selecione **Criar uma nova conexão** e faça o seguinte:
1. Insira um nome e uma descrição opcional.
1. Em **Tipo de destino**, escolha **Outro**.
1. Escolha **Credenciais OAuth do cliente**.
1. Para o **endpoint de autorização**, aceite o endpoint pré-preenchido.
—OU—
se você usa uma organização de produção, substitua o endpoint preenchido por esta URL:
**https://*my-salesforce-domain-name*.my.salesforce.com/services/oauth2/token**
1. Em **Método HTTP**, selecione **POST**.
1. Em **Client ID**, insira a chave do consumidor do aplicativo conectado no Salesforce.
1. Em **Segredo do cliente**, insira o segredo do consumidor do aplicativo conectado no Salesforce.
1. Adicione os seguintes OAuth valores:
+ **Parâmetro**: Campo corporal
+ **Chave**: grant\$1type
+ **Valor**: client\$1credentials
1. Escolha **Criar**.
**nota**
Se sua organização do Salesforce usa autenticação multifatorial para acesso à API, os usuários devem concluir um segundo desafio de autenticação para acessar o Salesforce. APIs Para obter mais informações, consulte [Definir requisitos de login com autenticação multifator para acesso à API na documentação](https://help.salesforce.com/s/articleView?id=sf.security_require_2fa_api.htm&language=en_US&type=5) do Salesforce.
Depois de criar o destino da API, você pode criar uma regra que usa o alvo como destino.
#### Criar uma EventBridge regra e conectá-la ao destino da API
EventBridge as regras roteiam eventos do barramento de eventos para o destino da API, o que resulta na realização de uma chamada REST para publicar um evento de volta no Salesforce.
Para obter mais informações sobre EventBridge regras, consulte [Criação de EventBridge regras da Amazon que reagem a eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) no *Guia EventBridge do usuário da Amazon*.
#### Criação de eventos do conjunto de alterações
As etapas a seguir explicam como criar eventos do conjunto de alterações.
1. Na [Amazon EventBridge](https://docs.aws.amazon.com/marketplace/latest/userguide/seller-eventbridge.html#events-changesets), escolha **Regras**.
1. Na lista, selecione o ônibus de eventos desejado.
1. Na seção **Regras**, selecione **Criar regra**.
1. Insira um nome para a regra e escolha **Avançar**.
1. Em **Padrão de evento**, selecione **Padrões personalizados (editor JSON)** e insira o filtro a seguir. Você pode usar qualquer combinação de tipos de detalhes.
```
{
"source": [
"aws.marketplacecatalog"
],
"detail-type": [
"Change Set Succeeded",
"Change Set Failed",
"Change Set Cancelled"
]
}
```
Para obter mais informações sobre a correspondência de padrões de eventos, consulte [Filtragem de conteúdo nos padrões de EventBridge eventos da Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns-content-based-filtering.html) na AWS documentação.
1. Escolha **Próximo**.
1. Em **Selecionar destinos**, em **Alvo 1**, selecione **Destino EventBridge da API**.
1. Na lista, selecione o destino da API que você acabou de criar.
1. Expanda **Additional settings** (Configurações adicionais).
1. Em **Configurar entrada de destino**, selecione **Transformador de entrada** e **Configurar transformador de entrada**. Isso garante que somente os campos de eventos do Salesforce da seção de detalhes do evento original sejam enviados.
O caminho de entrada deve ser:
```
{
"Name": "$.detail-type",
"awsapn__Account_Number__c": "$.account",
"awsapn__EntityId__c": "$.detail.ChangeSetId"
}
```
O modelo deve ser:
```
{
"Name": Name,
"awsapn__Account_Number__c": awsapn__Account_Number__c,
"awsapn__EntityId__c": awsapn__EntityId__c
}
```
1. Escolha **Avançar** e, em seguida, **Avançar**.
1. Revise a regra e escolha **Criar regra**.
**nota**
Para solucionar problemas de um destino de API, você pode usar o console do Amazon SQS para adicionar uma fila de letras mortas ao destino. A fila recebe mensagens que não puderam ser entregues, além dos erros. No console do Amazon SQS, você pode pesquisar mensagens na fila em busca de erros. *Para obter mais informações, consulte [Uso de filas de cartas mortas para processar eventos não entregues e Receber e excluir uma mensagem no EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rule-dlq.html) [Amazon SQS no Guia do usuário do Amazon SQS](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-using-receive-delete-message.html).*
#### Criação de ofertas e eventos lançados
As etapas a seguir explicam como criar eventos de lançamento de oferta.
1. No EventBridge console da [Amazon](https://docs.aws.amazon.com/marketplace/latest/userguide/seller-eventbridge.html#events-changesets), escolha **Regras**.
1. Selecione o ônibus de eventos desejado na lista.
1. Na seção **Regras**, selecione **Criar regra**.
1. Insira um nome para sua regra e escolha **Avançar**.
1. Em **Padrão de evento**, selecione **Padrões personalizados (editor JSON)** e insira o seguinte filtro:
```
{
"source": [
"aws.marketplacecatalog"
],
"detail-type": [
"Offer Released"
]
}
```
Para obter mais informações sobre a correspondência de padrões de eventos, consulte [Filtragem de conteúdo em padrões de EventBridge eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns-content-based-filtering.html) da Amazon no Guia EventBridge do usuário da Amazon.
1. Escolha **Próximo**.
1. Em **Selecionar destinos**, em **Alvo 1**, selecione **Destino da EventBridge API**, abra a lista e selecione o destino da API que você acabou de criar.
1. Expanda **Additional settings** (Configurações adicionais).
1. Em **Configurar entrada de destino**, selecione **Transformador de entrada** e selecione **Configurar transformador de entrada**. Essa etapa impede que os campos de eventos de nível superior da Amazon sejam enviados ao Salesforce. Somente a parte contendo os campos de eventos do Salesforce da seção de detalhes do evento original é enviada.
Use o seguinte caminho de entrada:
```
{
"Name":"$.detail-type",
"awsapn__Account_Number__c":"$.account",
"awsapn__EntityId__c":"$.detail.offer.id",
"awsapn__Manufacturer_Account_Id__c":"$.detail.manufacturer.accountId",
"awsapn__Product_Id__c":"$.detail.product.id",
"awsapn__Seller_Account_Id__c":"$.detail.sellerOfRecord.accountId"
}
```
Use o modelo a seguir:
```
{
"Name": Name,
"awsapn__Account_Number__c": awsapn__Account_Number__c,
"awsapn__EntityId__c": awsapn__EntityId__c,
"awsapn__Seller_Account_Id__c": awsapn__Seller_Account_Id__c,
"awsapn__Manufacturer_Account_Id__c": awsapn__Manufacturer_Account_Id__c,
"awsapn__Product_Id__c": awsapn__Product_Id__c
}
```
1. Escolha **Avançar** e, em seguida, **Avançar**.
1. Revise a regra e escolha **Criar regra**.
**nota**
Para ajudar a solucionar problemas de execução do destino da API, adicione uma fila de letras mortas do Amazon SQS ao destino. A fila recebe as mensagens que não puderam ser entregues junto com os erros. Em seguida, você pode pesquisar as mensagens para ver os erros. Para obter mais informações, consulte [Política de repetição de eventos e uso de filas de mensagens sem saída](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rule-dlq.html) e [Recebimento e exclusão de mensagens (console)](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-using-receive-delete-message.html) na documentação. AWS
#### Criação de eventos de oportunidades
Os eventos de oportunidade fornecem notificações em tempo real sobre mudanças no status ou nos detalhes das oportunidades
Você também pode criar e gerenciar EventBridge regras de forma programática usando o. [AWS SDKs](https://docs.aws.amazon.com/partner-central/latest/selling-api/opportunity-events.html#aws-eventbridge)
#### Tipos de eventos
A lista a seguir descreve os tipos de eventos gerados quando os parceiros trabalham com oportunidades. Os links levam você à documentação da API de cada evento.
+ [Oportunidade criada:](https://docs.aws.amazon.com/partner-central/latest/selling-api/selling-api-events.html#opportunity-created) — Acionada quando uma nova oportunidade é criada.
+ [Oportunidade atualizada](https://docs.aws.amazon.com/partner-central/latest/selling-api/selling-api-events.html#opportunity-updated) — acionada quando uma oportunidade é atualizada.
+ [Convite de engajamento criado](https://docs.aws.amazon.com/partner-central/latest/selling-api/selling-api-events.html#invitation-created) — acionado quando uma oportunidade é criada.
+ [Convite de engajamento aceito](https://docs.aws.amazon.com/partner-central/latest/selling-api/selling-api-events.html#invitation-accepted) — acionado quando um parceiro aceita um convite de AWS engajamento, confirmando seu interesse em colaborar com a AWS oportunidade.
+ [Convite de engajamento rejeitado](https://docs.aws.amazon.com/partner-central/latest/selling-api/selling-api-events.html#invitation-rejected) — acionado quando uma oportunidade é rejeitada.
#### Exemplo de evento do
```
{
"version": "1",
"id": ""d1example-0c9c-4655-15bf-c5exampleb08",
"source": "aws.partnercentral-selling",
"detail-type": "Opportunity Created",
"time": ""2023-10-28T13:31:05Z",
"region": ""us-east-1",
"account": ""123456789123",
"detail": {
"schemaVersion": "1",
"catalog": "AWS",
"opportunity": {
"identifier": ""O1234567",
"url": "Partner Central Opportunity Page URL"
}
}
}
```
### Exemplos de regras
A tabela a seguir lista exemplos das EventBridge regras que você pode usar com os eventos listados na seção anterior. As regras direcionam eventos do barramento de eventos para o destino da API, o que resulta em uma chamada REST para publicar um evento de volta no Salesforce.
| Tipo de evento | Exemplo |
| --- | --- |
| **Oportunidade criada** | {
"source": ["aws.partnercentral-selling"],
"detail-type": ["Opportunity Created"],
"detail": {
"catalog": ["AWS"]
}
} |
| **Oportunidade atualizada** | {
"source": ["aws.partnercentral-selling"],
"detail-type": ["Opportunity Updated"],
"detail": {
"catalog": ["AWS"]
}
} |
| **Convite de engajamento criado** | {
"source": ["aws.partnercentral-selling"],
"detail-type": ["Engagement Invitation Created"],
"detail": {
"catalog": ["AWS"]
}
} |
| **Convite de compromisso aceito** | {
"source": ["aws.partnercentral-selling"],
"detail-type": ["Engagement Invitation Accepted"],
"detail": {
"catalog": ["AWS"]
}
} |
| **Convite de compromisso rejeitado** | {
"source": ["aws.partnercentral-selling"],
"detail-type": ["Engagement Invitation Rejected"],
"detail": {
"catalog": ["AWS"]
}
} |
| **Todos os eventos** | {
"source": ["aws.partnercentral-selling"],
"detail": {
"catalog": ["AWS"]
}
} |
# Mapeando objetos ACE
O conector CRM fornece a página de **mapeamentos ACE**. A página permite mapear objetos e campos entre sua organização do Salesforce e AWS Partner Network (APN).
As seções a seguir explicam como criar mapeamentos de objetos.
**Topics**
+ [Usando a página Mapeamentos ACE](mapping-page.md)
+ [Mapeamento de vários objetos](multi-object-mappings.md)
+ [Mapeamento da lista de opções](picklist-mapping.md)
+ [Mapeando objetos ACE e Salesforce](#mapping-guidance)
+ [Sincronize registros e relatórios](crm-connector-sync-logs-and-reports.md)
# Usando a página Mapeamentos ACE
AWS O Partner Central fornece as seguintes formas de navegar até a página de **mapeamentos ACE**:
+ No Iniciador de aplicativos, pesquise e escolha o conector **AWS Partner CRM.**
+ Escolha a guia **Mapeamentos ACE**.
—OU—
Escolha a guia **Configuração guiada** e, na seção **Mapear leads e oportunidades**, escolha **Iniciar** ou **Revisar**.
Na página **Mapeamentos ACE**, use o painel de navegação esquerdo para alternar entre mapeamentos de oportunidades e leads. Use o **Seletor de objetos** para escolher o objeto de origem para mapear leads e oportunidades do APN. O seletor de objetos oferece suporte ao mapeamento de oportunidades padrão, objetos principais e objetos personalizados. Use os filtros **Mapping View** e **Type View** para alternar entre campos mapeados, campos não mapeados, campos obrigatórios e campos opcionais.
Na página **Mapeamentos ACE**, a coluna **AWS Campos do objeto indica os campos** APN de destino correspondentes. Os campos **do Salesforce são campos** de origem do objeto selecionado na organização do parceiro. Os **campos do Salesforce** são filtrados para mostrar somente os tipos de dados aplicáveis disponíveis na organização a serem mapeados para o campo APN correspondente. Por exemplo, um campo de texto no APN só pode ser mapeado para um campo de texto (string) na organização do parceiro.
Os parceiros podem controlar as atualizações recebidas nos campos mapeados se não quiserem que um campo seja atualizado pela APN. **Para fazer isso, defina a **opção Ativar atualizações de entrada** como False.**
Para one-to-one mapeamento, selecione o campo de origem relevante e escolha **Salvar**.
# Mapeamento de vários objetos
O mapeamento de vários objetos permite que os parceiros mapeiem AWS campos para um objeto de origem primária, como uma oportunidade ou lead, e para os objetos do Salesforce relacionados à fonte primária.
**nota**
Lembre-se do seguinte ao usar o mapeamento de vários objetos:
Ao usar o `Account` objeto Salesforce multi-object-mapping com um objeto de oportunidade, você deve definir as `Default Account` [configurações personalizadas do ACE](guided-setup-apis.md#api-sys-config-settings) para receber oportunidades.
Ao receber uma oportunidade, se você mapear para um objeto diferente do `Opportunity` objeto escolhido, certifique-se de vincular o objeto relacionado ao seu registro de oportunidade.
Por exemplo, ao receber uma AWS recomendação pela primeira vez, a oportunidade inserida não tem nenhum objeto mapeado relacionado, a IDs *menos que* você defina as configurações personalizadas `Default Account` do ACE. Se você configurar a conta padrão, a indicação terá a IDs oportunidade escolhida ou os objetos da conta. Caso contrário, o valor do campo mapeado não será inserido. Nesse caso, você deve modificar a oportunidade de adicionar o ID do objeto relacionado e escolher **Sincronizar com AWS**. Quando AWS envia a oportunidade de volta para o Salesforce, o campo do objeto mapeado é atualizado porque tem uma referência ao ID relacionado ao objeto.
Selecione a opção **Clonar conta padrão** nas configurações personalizadas. Isso permite AWS clonar a conta padrão quando necessário, especialmente se você mapear os campos da conta para seu objeto principal.
**Para mapear objetos relacionados**
1. No Salesforce, navegue até a guia **Mapeamentos ACE** e escolha uma oportunidade ou lead.
1. **No seletor de objetos**, escolha seu objeto de origem.
A coluna **Salesforce Fields** aparece e exibe o símbolo **>** no final de qualquer campo que contenha objetos relacionados.
1. Selecione um símbolo **>** para expandir a lista de objetos relacionados para esse campo.
1. Escolha o campo que você deseja mapear para o AWS campo.
1. Escolha **Salvar**.
# Mapeamento da lista de opções
A caixa de diálogo da lista de opções permite mapeamentos limitados e estendidos entre o campo da lista de opções do parceiro e o APN. A página **Mapeamentos ACE** também tem uma função de mapeamento automático se estiver usando o objeto de **oportunidade ACE personalizado** fornecido. Para obter mais informações sobre o objeto, consulte [Usando um objeto padrão do Salesforce ou um objeto personalizado](crm-connector-mapping.md#custom-ace-opportunity-object) mais adiante neste guia.
Se for encontrada uma correspondência exata entre os valores de campo do parceiro e o APN, esses valores serão mapeados automaticamente. A opção de mapeamento estendido permite que os parceiros mapeiem um único valor de APN para várias fontes, configurem mapeamentos de destino adicionais e definam mapeamentos padrão.
## Mapeamento limitado
1. Na página **Mapeamentos ACE**, selecione um campo de origem e escolha **Mapear** Valores.
A caixa de diálogo de mapeamento é exibida.
1. **Para **Etapa 1: Valores primários do APN**, escolha **Mapa automático** ou o valor do Salesforce para o gerenciador de pipeline ACE correspondente e, em seguida, escolha Salvar.**
1. Repita as etapas 1 e 2 conforme necessário para mapear todos os valores do gerenciador de pipeline ACE.
1. Para fechar a caixa de diálogo de mapeamento, escolha **Fechar**.
Os parceiros recebem uma mensagem de confirmação de que os mapeamentos de valores foram salvos.
## Mapeamento estendido
1. Se o mesmo valor de origem for mapeado para vários valores de APN, continue com o mapeamento conforme descrito anteriormente.
1. Na guia **Valores primários de APN**, escolha o mesmo mapeamento de valores para vários valores de APN.
1. Se existirem valores não mapeados na organização do parceiro, a guia **Valor adicional do APN** permite mapear valores adicionais para o APN. Isso ajuda os parceiros a garantir que todos os valores aplicáveis em sua organização sejam mapeados de acordo com os valores apropriados da APN.
1. Se um único valor na organização do parceiro for mapeado para mais de um valor de APN, use a guia **Valores secundários de APN** para definir o valor padrão para integrações externas.
## Mapeando objetos ACE e Salesforce
As seções a seguir explicam como mapear objetos personalizados do ACE e do Salesforce em mapas de objetos.
### Usando um objeto personalizado de oportunidade AWS ACE
A versão 2.0 e posterior do conector CRM inclui um objeto de oportunidade personalizado ACE. Você pode usar o objeto para gerenciar AWS oportunidades no Salesforce.
Ao usar o objeto personalizado na página de **mapeamentos ACE, os parceiros podem mapear** automaticamente os AWS campos para os campos do Salesforce. Além disso, o objeto de oportunidade personalizado está alinhado com o novo modelo de dados ACE e tem validações incorporadas à interface do usuário que ajudam os usuários a enviar novas oportunidades.
Para usar um objeto de oportunidade ACE personalizado, conclua as seguintes etapas:
1. No Salesforce, navegue até a página **Mapeamentos ACE** e escolha **Oportunidade** no painel de navegação esquerdo.
1. Em **Seletor de objetos**, escolha **ACE Opportunity**.
1. Para mapear campos do Salesforce em AWS campos, escolha o botão de **objeto ACE de mapeamento automático**.
### Usando um objeto padrão do Salesforce ou um objeto personalizado
Os parceiros podem usar o objeto de oportunidade padrão do Salesforce ou seu próprio objeto de oportunidade personalizado. Para evitar falhas na sincronização do ACE, certifique-se de que o objeto de oportunidade personalizado contenha todos os campos obrigatórios ou campos condicionalmente obrigatórios do ACE relevantes. O tipo de dados do AWS campo mapeado deve ser o mesmo do campo do Salesforce criado no objeto personalizado. Se o tipo de dados não corresponder, o campo não aparecerá na tela de mapeamento ACE. Por exemplo, o campo de texto **customerCompanyName**pode ser mapeado somente para um campo de texto (string) no objeto de oportunidade padrão ou personalizado. Para obter os tipos de dados necessários, consulte os campos de oportunidade do ACE.
Para usar um objeto padrão do Salesforce ou um objeto personalizado, conclua as seguintes etapas:
1. Navegue até a página **Mapeamentos ACE** e escolha **Oportunidade** no painel de navegação esquerdo.
1. Em **Seletor de objetos**, escolha seu objeto.
1. **Conclua o mapeamento selecionando os campos obrigatórios do Salesforce em relação aos AWS campos correspondentes e, em seguida, escolha Salvar.**
**nota**
O recurso Mapa Automático está disponível somente para objetos personalizados da oportunidade ACE.
# Sincronize registros e relatórios
Os tópicos a seguir explicam como usar registros e relatórios de sincronização no aplicativo conector do AWS Partner CRM. Os tópicos também listam os tipos de registro e relatório e os dados que eles contêm.
**Topics**
+ [Registros de sincronização](#sync-logs)
+ [Relatórios](#reports)
## Registros de sincronização
No aplicativo conector, a guia **Registro de sincronização** exibe o status dos registros de sincronização para sincronização de APN de entrada e saída. Você usa a guia para verificar uma sincronização bem-sucedida e solucionar erros de sincronização.
Use as exibições de lista incluídas para alternar entre os registros de sincronização de **entrada** e **saída**.
+ **Orquestração de entrada** — Indica o trabalho que verifica os registros de entrada disponíveis do APN.
+ **Recuperação de registros de orquestração de entrada** — Indica a tarefa que coleta e processa os registros de entrada pendentes da APN.
+ **Orquestração de saída** — Indica o trabalho que envia transações de saída pendentes da sua organização para a APN.
A página de **registro do registro de sincronização** mostra o status da tarefa de sincronização, o número de registros na carga, o número de registros processados com êxito e o número de registros com erro.
Os detalhes do **Registro de Sincronização** relacionados mostram os detalhes de registros individuais processados como parte da tarefa de sincronização, além de seus status individuais. As tabelas a seguir explicam cada tipo de arquivo de log e seus conteúdos relacionados.
### Tipos de log
| **Finalidade** | **Definição** |
| --- | --- |
| Recuperação de arquivos de saída | Criado quando a tarefa de saída é executada com base na frequência e na necessidade de sincronizar um novo conjunto de registros pendentes. AWS Os registros são criados somente quando os registros precisam corresponder à seguinte especificação de filtro para a sincronização de saída: `Updates for AWS` é `true` e `Last Sync Date` é nulo, ou `Last Sync Date` é anterior ao `Last Modified Date` e `Last Modified By` é o usuário que agendou os trabalhos de sincronização. |
| Recuperação de arquivos de entrada | Criado com base na sua programação de sincronização de entrada. O registro lista os callouts que verificam as transações de entrada pendentes de. AWS |
| Recuperação de registros de entrada | Criado somente quando o trabalho principal de recuperação de arquivos de entrada identifica transações de entrada pendentes de. AWS O registro contém os detalhes do arquivo AWS que contém os registros de oportunidades ou leads. |
### Resultados da recuperação do arquivo de saída
| **Direção** | **Finalidade** | **Status** | **Definição** |
| --- | --- | --- | --- |
| De AWS | Recuperação de arquivos de entrada | API Success | Uma chamada de lista para o bucket foi bem-sucedida. A chamada verificou a existência de registros de entrada pendentes que devem ser processados. |
| De AWS | Recuperação de arquivos de entrada | Error | A chamada da lista falhou, normalmente devido a credenciais inválidas ou a um problema de permissão. |
### Resultados da recuperação do arquivo de entrada
| **Direção** | **Finalidade** | **Status** | **Definição** |
| --- | --- | --- | --- |
| De AWS | Recuperação de registros de entrada | API success | Foi feita uma get chamada para recuperar o arquivo listado da Inbound File Retrieval operação, se um ou mais arquivos existirem e aguardarem processamento. |
| De AWS | Recuperação de registros de entrada | Partial | O arquivo foi recuperado, mas o processamento falhou em alguns registros. Revise o log de sincronização para solucionar a falha. |
| De AWS | Recuperação de registros de entrada | Error | O processamento falhou em todos os registros devido a um dos seguintes motivos: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/partner-central/latest/crm/crm-connector-sync-logs-and-reports.html) |
| De AWS | Recuperação de registros de entrada | API success | Se um ou mais arquivos estiverem presentes e aguardando processamento, uma get chamada será feita para recuperar o arquivo listado da Inbound File Retrieval operação. |
| De AWS | Recuperação de registros de entrada | Partial | O arquivo foi recuperado, mas o processamento falhou em alguns dos registros. Revise o log de sincronização para solucionar a falha. |
| De AWS | Recuperação de registros de entrada | Error | O processamento falhou em todos os registros devido a um dos seguintes motivos: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/partner-central/latest/crm/crm-connector-sync-logs-and-reports.html) |
| De AWS | Recuperação de registros de entrada | Processed | O processamento foi bem-sucedido e os registros foram inseridos em seu objeto mapeado. |
## Relatórios
O pacote de conectores do AWS Partner CRM inclui relatórios que permitem que você acompanhe o status da sincronização entre sua organização e o APN.
**Para visualizar relatórios para sincronização**
1. No aplicativo do conector AWS Partner CRM, escolha a guia **Relatórios**.
1. Escolha **Todas as pastas e**, em seguida, **conector AWS Partner CRM**.
Os relatórios disponíveis incluem o seguinte:
+ **Registros de sincronização de entrada** — falhas no registro `Error: Inbound` de sincronização por dia.
+ Registros de **sincronização de entrada — registros** de sucesso `Success: Inbound` de sincronização por dia.
+ **Registros de sincronização de saída** — falhas no registro `Error: Outbound` de sincronização por dia.
+ Registros de **sincronização de saída — registros** de sucesso `Success: Outbound` de sincronização por dia.
+ **Resumo da sincronização** — Resumo dos trabalhos de sincronização de entrada e saída por dia.
# Configurando o conector do CRM
**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.
Depois de instalar o conector, você o configura para funcionar com os seguintes tipos de integrações e AWS serviços de CRM:
+ Uma integração de API da AWS Partner Central
+ Um CRM com integração com o Amazon S3, mas somente se você tiver criado a integração antes de 2024
+ AWS Marketplace
As configurações permitem que você use o Salesforce com o Partner Central e. AWS Marketplace Os tópicos a seguir explicam como configurar o conector do CRM.
**Topics**
+ [Usando a configuração guiada](use-guided-setup.md)
+ [Configurando o conector para uma integração da API do Partner Central](p-c-api-integration.md)
+ [Configurando o conector para AWS Marketplace](aws-marketplace-integration.md)
+ [Personas para conjuntos de permissões de conectores de CRM](permission-sets.md)
# Usando a configuração guiada
Você sempre usa o Salesforce para configurar o conector do CRM e começa na guia Configuração **guiada**. As etapas a seguir explicam como iniciar a guia:
**Para iniciar a guia**
1. Faça login no Salesforce como administrador do sistema.
1. No Iniciador de aplicativos, pesquise e selecione o conector **AWS Partner CRM.**
1. Escolha a guia **Configuração AWS guiada**.
# Configurando o conector para uma integração da API do Partner Central
As seções a seguir explicam como configurar o conector CRM para uso com o AWS Partner Central APIs.
Para criar e gerenciar oportunidades no Salesforce, configure o conector CRM para uso com uma integração de API do Partner Central.
**nota**
O gerenciamento de leads requer um CRM anterior com a integração do Amazon S3. Para obter mais informações, consulte [Configurando o conector para um CRM com integração com o Amazon S3](s3-config.md) mais adiante neste guia.
**Topics**
+ [Inserindo detalhes de autenticação de conexão](#config-p-c-apis)
+ [Inserindo as configurações do sistema](#p-c-api-system-settings)
+ [Testar a conexão](#p-c-apis-testing)
+ [Usando modelos de fluxo](flow-templates.md)
## Inserindo detalhes de autenticação de conexão
Os parceiros iniciam o processo de integração inserindo os detalhes necessários para se conectar ao endpoint de vendas do Partner Central. Siga cada conjunto de etapas na ordem listada e conclua cada conjunto antes de prosseguir para o próximo.
**Para inserir detalhes de autenticação de conexã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 **a Etapa 1: detalhes da autenticação da 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.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/partner-central/latest/crm/p-c-api-integration.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.
## Inserindo as configurações do sistema
As etapas a seguir explicam como inserir as configurações corretas do sistema para a integraçã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 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 da tabela a seguir.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/partner-central/latest/crm/p-c-api-integration.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
Antes de testar a conexão, verifique se você concluiu todas as etapas acima.
**Para testar a conexão da API do AWS Partner Central**
1. Expanda **a Etapa 4: Teste a configuração da integração da API do Partner Central**.
1. Escolha **Testar**.
Se a conexão for bem-sucedida, você receberá uma mensagem de confirmação.
# Usando modelos de fluxo
Os modelos de fluxo são fluxos pré-criados do Salesforce que integram o Salesforce com o AWS Partner Central usando o método de integração da API do AWS Partner Central. Esses modelos incluem sincronização de dados, mapeamento de campo e configurações de tratamento de erros.
## Modelos disponíveis
**Modelo de fluxo de sincronização de oportunidades padrão unificado**
O modelo de fluxo Unified Standard-ACE Opportunity Sync mapeia campos de oportunidade padrão do Salesforce para campos de oportunidade ACE, converte formatos de estado e país e evita entradas duplicadas. Ele inclui valores padrão para os campos obrigatórios.
+ A receita, as datas de fechamento e as próximas etapas são sincronizadas entre a Salesforce e a Central de Parceiros da AWS.
+ Por padrão, a sincronização é acionada quando “Criar ACE” é adicionado à descrição da oportunidade. Você pode modificar esse mecanismo de acionamento usando uma caixa de seleção ou um botão.
+ Esse modelo fornece uma base para o desenvolvimento de fluxos que se alinham aos requisitos de negócios e aos mapeamentos de campo.
+ Esse modelo é para uso somente com a integração da API do AWS Partner Central e não é compatível com outros métodos de integração.
Encontre esse modelo no Salesforce Flow Builder pesquisando por “Modelo de fluxo de sincronização de oportunidades Unified Standard-ACE”.
**Pré-requisitos**
Esse modelo exige uma integração ativa da API do AWS Partner Central. Você deve ter as permissões apropriadas no Salesforce e os campos configurados nos dois sistemas. É recomendável familiarizar-se com o Salesforce Flow e a API do AWS Partner Central.
**Acessando o modelo**
Para localizar o modelo de fluxo:
1. **Em sua organização do Salesforce, escolha Configuração.**
1. Pesquise **fluxos**.
1. Na página Fluxos, pesquise o modelo “Unified Standard-ACE Opportunity Sync Flow”.
Crie uma cópia do modelo para personalizar de acordo com suas necessidades. Teste as modificações em um ambiente sandbox antes de implantá-las na produção.
**Recursos principais**
O modelo inclui mapeamento de campo entre objetos Standard Opportunity e ACE Opportunity, conversão de formato de estado e país e prevenção de entrada duplicada. Você pode configurar acionadores personalizados e tratamento de valores padrão para os campos obrigatórios.
**Considerações de implementação**
+ Siga as melhores práticas ao personalizar os modelos de fluxo.
+ Teste as modificações e considere o impacto nos processos existentes.
+ As personalizações comuns incluem a adição de campos personalizados ou o ajuste de mecanismos de gatilho.
+ Teste minuciosamente em um ambiente sandbox antes de implantar na produção.
+ Considere as implicações de desempenho ao lidar com grandes volumes de dados ou lógica comercial complexa.
# Configurando o conector para AWS Marketplace
**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.
Você pode configurar o conector do CRM para se conectar a várias contas de AWS vendedor e integrar o Salesforce a várias funções. AWS Marketplace Os tópicos a seguir explicam como configurar o conector para uso com AWS Marketplace.
Para obter mais informações sobre AWS Marketplace, consulte [O que é AWS Marketplace?](https://docs.aws.amazon.com/marketplace/latest/userguide/what-is-marketplace.html) no *Guia do AWS Marketplace usuário*. Para obter mais informações sobre os AWS Marketplace recursos que o conector CRM suporta, consulte. [AWS Marketplace features](crm-connector-feature-list.md#feature-list-aws-marketplace)
**nota**
Use a guia de **configuração AWS guiada** no Salesforce para concluir as tarefas a seguir. Para obter informações sobre como usar essa guia, consulte o [Usando a configuração guiada](use-guided-setup.md) artigo anterior neste guia.
**Topics**
+ [Integração de uma conta de AWS vendedor](onboard-seller-account.md)
+ [Inserindo as configurações do sistema](mkt-system-config.md)
+ [Inserindo configurações personalizadas](mkt-custom-settings.md)
# Integração de uma conta de AWS vendedor
As etapas a seguir explicam como integrar contas de AWS vendedor ao conector de CRM.
1. **No Salesforce, na [guia Configuração guiada](use-guided-setup.md), expanda **Etapa 1: Configurar o acesso ao Portal de AWS Marketplace Gerenciamento (AMMP)** 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.
**nota**
Para*unique\$1account\$1prefix*, use um descritor para a AWS conta, como sellerA; sellerB. Por exemplo, .**AWS\$1SELLER\$1CATALOG\$1sellerA** Sempre use o mesmo prefixo para as credenciais nomeadas relacionadas à conta do AWS vendedor.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/partner-central/latest/crm/onboard-seller-account.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.
Repita as etapas acima para cada tipo das **Credenciais Nomeadas** listadas na tabela a seguir. Use os valores na tabela abaixo para substituir os valores correspondentes na **Etapa 3** acima
| **Etiqueta de credencial nomeada** | **Nome da credencial nomeada** | **Ponto final da API** | **AWS Região** | **AWS serviço** |
| --- | --- | --- | --- | --- |
| AWS VENDEDOR Amazon S3 | AWS\$1SELLER\$1S3\$1 unique\$1account\$1prefix | [https://s3.amazonaws.com/](https://s3.amazonaws.com/) | us-east-1 | s3 |
| AWS VENDEDOR AWS STS | AWS\$1SELLER\$1STS\$1 unique\$1account\$1prefix | [https://sts.us-east-1.amazonaws.com/](https://sts.us-east-1.amazonaws.com/) | us-east-1 | sts |
| AWS VENDEDOR Amazon SQS | AWS\$1SELLER\$1SQS\$1 unique\$1account\$1prefix | [https://sqs.us-east-1.amazonaws.com/](https://sqs.us-east-1.amazonaws.com/) | us-east-1 | sqs |
| AWS CONTRATO DO VENDEDOR | AWS\$1SELLER\$1ACORDO\$1 unique\$1account\$1prefix | [https://agreement-marketplace.us-east-1.amazonaws.com/](https://agreement-marketplace.us-east-1.amazonaws.com/) | us-east-1 | aws-marketplace |
Repita as etapas acima para cada conta de AWS vendedor que você deseja adicionar à AWS Marketplace integração.
Depois de integrar as credenciais nomeadas, acesse a guia **AWS Contas** no **aplicativo AWS Partner CRM Connector** e conclua as etapas nas próximas seções.
# Inserindo as configurações do sistema
Depois de integrar uma conta de AWS vendedor, você insere várias configurações do sistema. Siga estas etapas.
1. **No Salesforce, na [guia Configuração guiada](use-guided-setup.md), expanda **Etapa 2: Concluir as configurações do sistema** e escolha Revisar.**
1. Na página **Configurações personalizadas**, localize **as Configurações de AWS Marketplace integração** e escolha **Gerenciar.**
1. Escolha **Editar** para adicionar **valores** de **nível de organização padrão** 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/mkt-system-config.html)
1. Escolha **Salvar**.
# Inserindo configurações personalizadas
Depois de inserir as configurações do sistema, você insere as configurações do bucket Amazon S3 usado para carregar e armazenar itens personalizados. EULAs
1. **No Salesforce, na [guia Configuração guiada](use-guided-setup.md), retorne à página **Configurações personalizadas, localize Configurações do** **S3 Bucket e escolha** Gerenciar.**
1. Escolha **Novo**.
1. Insira valores para as configurações a seguir.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/partner-central/latest/crm/mkt-custom-settings.html)
1. Escolha **Salvar**.
1. Para cada conta de AWS vendedor configurada, repita as etapas de 2 a 4 para adicionar as configurações do Amazon S3.
# Personas para conjuntos de permissões de conectores de CRM
Depois de instalar e configurar o conector do AWS Partner CRM, você atribui usuários do Salesforce a uma ou mais personas em um conjunto de *permissões, um conjunto* de configurações e permissões que fornecem acesso a várias ferramentas e funções. Os tópicos a seguir listam e descrevem as personas disponíveis.
Para obter mais informações sobre como atribuir usuários do Salesforce a conjuntos de permissões, consulte [Gerenciamento de atribuições de conjuntos de permissões na ajuda](https://help.salesforce.com/s/articleView?id=platform.perm_sets_manage_assignments.htm) do Salesforce.
**Topics**
+ [AWS Partner Network conjuntos de permissões](crm-connector-pemissions-sets.md)
+ [AWS Marketplace conjuntos de permissões](mkt-permissions-sets.md)
+ [Guias e conjuntos de permissões do conector CRM](permission-set-table.md)
# AWS Partner Network conjuntos de permissões
O conector CRM oferece suporte às seguintes AWS Partner Network personas principais:
**Topics**
+ [Administrador de negócios (administrador de negócios da APN)](#business-administrator)
+ [Usuário de integração (usuário de integração do APN)](#integration-user)
+ [Usuário corporativo (usuário comercial da APN)](#business-user)
+ [Concedendo permissões para visualizar relatórios](#report-permissions)
+ [Ativando usuários de fluxo](#activate-flow-user)
## Administrador de negócios (administrador de negócios da APN)
+ Atribua a um administrador do sistema ou a um administrador comercial para configurar a configuração e o mapeamento dos registros.
+ Oferece acesso total ao aplicativo de administração do Salesforce AWS Partner Network CRM.
+ Pode criar, visualizar e editar mapeamentos de campo.
+ Pode visualizar todos os registros detalhados do registro de sincronização.
+ Não permite que o usuário agende uma integração, apenas defina configurações.
+ Não fornece acesso básico à configuração do Salesforce.
+ Algumas configurações no Salesforce exigem acesso adicional. Especificamente, credenciais nomeadas e configurações personalizadas que AWS Partner devem fornecer ao usuário. No entanto, os parceiros podem associar esse conjunto de permissões a um perfil de administrador do sistema Salesforce e habilitar todas as permissões necessárias para configurar o aplicativo. Para obter mais informações sobre credenciais nomeadas, consulte [Configurar credenciais nomeadas](set-up-api-credentials.md)
## Usuário de integração (usuário de integração do APN)
+ Atribua a um usuário do sistema responsável pelo processamento da integração.
+ Para agendar uma integração, um administrador do sistema Salesforce faz login como esse usuário e invoca o cronograma de integração do sistema.
+ Permite que os administradores configurem os mapeamentos e invocem os cronogramas de integração.
+ A integração pode ser interrompida se essa permissão não for definida para o usuário que executa a integração.
+ Além desse conjunto de permissões, o usuário designado para processar a integração deve ter acesso em nível de campo a todos os campos mapeados. Caso contrário, os mapeamentos não serão sincronizados conforme atribuído.
+ As tarefas de saída foram projetadas para ignorar as atualizações feitas no contexto do usuário de integração para evitar uma condição de corrida, com o mesmo registro atualizado durante a integração de entrada sendo sinalizado para ser enviado para integração de saída.
## Usuário corporativo (usuário comercial da APN)
+ Atribua aos usuários corporativos que talvez queiram ver os detalhes do registro de sincronização relacionados às suas oportunidades. Isso permite a solução de problemas do usuário final se os dados não estiverem sincronizados corretamente.
+ Não fornece visibilidade aos registros do log de sincronização e só dá acesso ao objeto e aos campos.
+ Recomendamos definir os registros de registro de sincronização como privados, pois eles contêm informações confidenciais de oportunidades.
+ Se você configurar um modelo privado, os usuários corporativos do APN poderão acessar somente os registros se o administrador parceiro da Salesforce configurar o compartilhamento de registros com os usuários.
## Concedendo permissões para visualizar relatórios
Para permitir que um usuário visualize relatórios na guia **Início** do conector AWS Partner CRM, um administrador deve conceder as seguintes permissões:
+ Crie e personalize relatórios
+ Editar meus relatórios
+ Gerenciar relatórios em pastas públicas
+ Executar relatórios
+ Exibir relatórios em pastas públicas
Para obter mais informações, consulte [Conceder aos usuários acesso a relatórios e painéis](https://help.salesforce.com/s/articleView?id=sfdo.PMM_Folder_Sharing_Reports_Dash.htm) na ajuda do Salesforce.
## Ativando usuários de fluxo
A ativação de usuários como usuários de fluxo permite que eles executem fluxos e usem o botão de **oferta privada Link** em uma oportunidade ACE.
1. Certifique-se de que o administrador do sistema tenha permissão para atribuir um usuário de fluxo. Para obter mais informações, consulte [Adicionar permissões de fluxos de execução](https://help.salesforce.com/s/articleView?id=sf.wcc_setup_add_run_flows_perms.htm) na ajuda do Salesforce.
1. Escolha **Configuração**, **Usuários**.
1. Escolha um usuário.
1. Escolha o **usuário do Flow**.
# AWS Marketplace conjuntos de permissões
O conector CRM oferece suporte às seguintes AWS Partner personas principais. Os parceiros habilitam as personas dando ao usuário do Salesforce o conjunto de permissões correspondente incluído no aplicativo.
**Topics**
+ [AWS Administrador do Marketplace](#aws-marketplace-administrator)
+ [AWS Usuário do Marketplace](#aws-marketplace-user)
+ [AWS Usuário parceiro de canal](#aws-channel-partner-user)
## AWS Administrador do Marketplace
Atribua essa persona a um administrador de sistemas ou de negócios para realizar a configuração e gerenciar os agendamentos. Essa persona fornece acesso total à integração do AWS Marketplace no conector Salesforce.
Essa persona pode fazer o seguinte:
+ Leia, grave e visualize registros de todos os objetos relacionados à integração com o AWS Marketplace.
+ Veja todos os registros de log de sincronização do AWS Marketplace.
+ Crie agendas relacionadas às entidades do AWS Marketplace.
**nota**
Certas configurações no Salesforce exigem acesso adicional, credenciais especificamente nomeadas e configurações personalizadas que AWS Partner devemos fornecer aos usuários. No entanto, se os parceiros associarem esse conjunto de permissões a um perfil de administrador de sistemas da Salesforce, todas as permissões necessárias para configurar totalmente o aplicativo deverão funcionar.
## AWS Usuário do Marketplace
Atribua essa persona ao usuário que cria e gerencia ofertas privadas e autorização de revenda.
O usuário do AWS Marketplace pode fazer o seguinte:
+ Sincronize produtos, ofertas e autorizações de revenda do AWS Marketplace.
+ Modifique as datas de expiração e cancele e clone ofertas e autorizações de revenda.
+ Acesse o painel do AWS Marketplace.
## AWS Usuário parceiro de canal
O usuário do AWS Channel Partner pode fazer o seguinte:
+ Veja as autorizações de revenda compartilhadas disponíveis criadas pelo vendedor do Fornecedor Independente de Software (ISV).
+ Visualize e crie ofertas privadas de parceiros de AWS canal a partir de autorizações de revenda compartilhadas.
# Guias e conjuntos de permissões do conector CRM
Quando você usa o aplicativo conector CRM no Salesforce, aparece um conjunto de guias. As guias que você vê variam, dependendo das suas configurações de permissão. A tabela a seguir lista as guias fornecidas pelo aplicativo conector e os conjuntos de permissões permitidos para usar cada guia.
| **Aba do aplicativo Connector** | **Conjuntos de permissões** |
| --- | --- |
| **AWS Configuração guiada** | Administrador de negócios da APN Usuário de integração da APN Usuário comercial da APN? AWS Marketplace Administrador |
| **Relatórios** | Usuário comercial da APN AWS Marketplace Usuário (AWS Marketplace ISV) AWS Usuário parceiro de canal |
| **Mapeamentos ACE** | Administrador de negócios da APN Usuário comercial da APN? |
| **Programações** | Administrador de negócios da APN Usuário de integração da APN AWS Marketplace Usuário (AWS Marketplace ISV) |
| **Registros de sincronização ACE** | Administrador de negócios da APN Usuário de integração da APN Usuário comercial da APN |
| **ACE lidera** | Administrador de negócios da APN? -> Disponível Usuário de integração da APN? Usuário comercial da APN |
| **Oportunidades ACE** | Administrador de negócios da APN? -> Disponível Usuário de integração da APN? Usuário comercial da APN |
| **Ofertas de soluções** | Administrador de negócios da APN Usuário comercial da APN |
| **AWS Contas** | AWS Marketplace Administrador AWS Marketplace Usuário (AWS Marketplace ISV) AWS Usuário parceiro de canal |
| **Produtos** | AWS Marketplace Administrador AWS Marketplace Usuário (AWS Marketplace ISV) |
| **Ofertas privadas** | AWS Marketplace Administrador? -> Disponível AWS Marketplace Usuário (AWS Marketplace ISV) AWS Usuário parceiro de canal |
| **Autorizações de revenda** | AWS Marketplace Administrador? -> Disponível AWS Marketplace Usuário (AWS Marketplace ISV) AWS Usuário parceiro de canal |
| **Autorizações de revenda compartilhadas** | AWS Marketplace Administrador? -> Disponível AWS Usuário parceiro de canal |
| **Registros de sincronização do Marketplace** | AWS Marketplace Administrador AWS Marketplace Usuário (AWS Marketplace ISV) AWS Usuário parceiro de canal |
| **Contratos** | AWS Marketplace Usuário (AWS Marketplace ISV) AWS Usuário parceiro de canal |
| **AWS Marketplace Notificações** | Administrador de negócios da APN Usuário comercial da APN AWS Marketplace Administrador AWS Marketplace Usuário (AWS Marketplace ISV) AWS Usuário parceiro de canal |
| **Mapeamentos de campo** | Administrador de negócios da APN? Usuário de integração da APN? |
| **Dimensões da oferta** | AWS Marketplace Administrador? AWS Marketplace Usuário (AWS Marketplace ISV) AWS Usuário parceiro de canal |
| **Cronogramas de pagamento** | AWS Marketplace Administrador? AWS Marketplace Usuário (AWS Marketplace ISV) AWS Usuário parceiro de canal |
| **Dimensões do produto** | AWS Marketplace Administrador? AWS Marketplace Usuário (AWS Marketplace ISV) |
| **Logs** | Administrador de negócios da APN Usuário comercial da APN |
# Usando o conector CRM no Salesforce
Os tópicos a seguir explicam como usar o Salesforce e o conector CRM para gerenciar interações com clientes e como gerenciar AWS Marketplace atividades como ofertas privadas e autorizações de revenda. Os tópicos pressupõem que você configurou o conector para o AWS Partner Central AWS Marketplace e.
**Topics**
+ [Gerenciando oportunidades de ACE](manage-ace-opportunities.md)
+ [Gerenciando oportunidades em uma integração de API do Partner Central](manage-aws-opportunities.md)
+ [Gerenciando oportunidades em um CRM com integração com o Amazon S3](manage-s3-opportunities.md)
+ [Gerenciando AWS Marketplace atividades](crm-manage-marketplace.md)
# Gerenciando oportunidades de ACE
Os tópicos a seguir explicam como usar o conector AWS Partner CRM para gerenciar oportunidades de ACE.
**Topics**
+ [Criação de oportunidades originadas por parceiros](create-partner-opportunity.md)
+ [Visualizando registros de oportunidades](viewing-opportunities.md)
+ [Atualizando o estágio de uma oportunidade](update-opportunity-stage.md)
+ [Clonando uma oportunidade](clone-opportunity.md)
# Criação de oportunidades originadas por parceiros
As etapas a seguir explicam como criar uma oportunidade originada por um parceiro.
1. Entre na sua organização do Salesforce como usuário de vendas.
1. Escolha **Iniciador de aplicativos** e, em seguida, pesquise e escolha o conector **AWS Partner CRM.**
1. Abra a guia **Oportunidades ACE**.
1. Escolha **Novo**.
1. Preencha os campos. Certifique-se de preencher todos os campos obrigatórios.
1. Escolha **Salvar**.
1. Quando estiver pronto, na página de registro da oportunidade, escolha **Compartilhar com AWS** para onde enviar a oportunidade AWS.
# Visualizando registros de oportunidades
As etapas a seguir explicam como visualizar registros de oportunidades no aplicativo CRM Connector.
1. Entre na sua organização do Salesforce como usuário de vendas.
1. No **Iniciador de aplicativos**, pesquise e escolha o conector **AWS Partner CRM.**
1. Abra a guia **Oportunidades ACE**.
1. Visualize uma oportunidade selecionando o **nome da oportunidade ACE**.
# Atualizando o estágio de uma oportunidade
As etapas a seguir explicam como atualizar o estágio de uma oportunidade.
1. Entre na sua organização do Salesforce como usuário de vendas.
1. Escolha **Iniciador de aplicativos** e, em seguida, pesquise e selecione **AWS Partner CRM Connector.**
1. Na guia **Oportunidades ACE**, abra o registro da oportunidade.
1. Execute um destes procedimentos:
No **caminho do estágio**, escolha o estágio desejado.
—OU—
No campo **Estágio**, insira o estágio necessário.
—OU—
Escolha **Marcar estágio como concluído**.
1. Escolha **Salvar**.
# Clonando uma oportunidade
A clonagem permite criar uma nova oportunidade que contém detalhes de uma oportunidade existente. As etapas a seguir explicam como.
1. Entre na sua organização do Salesforce como usuário de vendas.
1. Escolha **Iniciador de aplicativos** e, em seguida, pesquise e selecione **AWS Partner CRM Connector.**
1. Na guia **Oportunidades ACE**, abra o registro da oportunidade.
1. Escolha o botão **Clonar**.
1. Remova o valor do **identificador exclusivo do APN CRM** e atualize os outros campos conforme necessário.
1. Escolha **Salvar**.
# Gerenciando oportunidades em uma integração de API do Partner Central
Os tópicos a seguir explicam como concluir as tarefas específicas de uma integração da API do Partner Central.
**Topics**
+ [Aceitar ou rejeitar oportunidades AWS originadas](accept-reject-aws-opportunity.md)
+ [Atribuindo uma oportunidade a outro usuário](assign-opportunity.md)
+ [Associando ou dissociando uma oportunidade](associate-disassociate-opportunity.md)
+ [Aceitando várias oportunidades](accepting-multiple-opportunities.md)
+ [Atribuição de várias oportunidades](assigning-multiple-opportunities.md)
# Aceitar ou rejeitar oportunidades AWS originadas
As etapas a seguir explicam como aceitar ou rejeitar uma oportunidade originada do AWS setor de vendas.
1. Abra o registro de oportunidades.
1. Escolha o botão **Status de aprovação**.
1. No campo **Status de aceitação do parceiro**. Escolha **Aceito** ou **Rejeitado**.
Se você escolher **rejeitado**, abra a lista de **motivos da rejeição** e escolha um motivo.
1. Escolha **Salvar**.
# Atribuindo uma oportunidade a outro usuário
As etapas a seguir explicam como atribuir uma oportunidade a outro usuário em sua conta do Partner Central.
**Importante**
Você só pode atribuir uma oportunidade AWS originada depois que ela for aceita.
1. Abra o registro de oportunidades.
1. Escolha o botão **Atribuir**.
1. Na caixa de diálogo **Atribuir oportunidade**, preencha todos os campos.
1. Escolha **Salvar**.
# Associando ou dissociando uma oportunidade
As etapas a seguir explicam como associar e dissociar uma oportunidade das soluções, AWS produtos ou AWS Marketplace ofertas de parceiros. Você pode associar e desassociar uma oportunidade a qualquer momento durante o ciclo de vida da oportunidade.
**Para associar uma oportunidade**
1. Abra o registro de oportunidades.
1. Escolha o botão **Associar ou Desassociar**.
1. **Na caixa de diálogo **Associar ou Desassociar Oportunidades**, escolha a (s) **Solução (s)**, o (s) **AWS produto (s)**, a **(s)AWS Marketplace oferta (s)** necessários ou insira um valor em Outros**
1. Escolha **Salvar**.
**Para dissociar uma oportunidade**
1. Abra o registro de oportunidades.
1. Escolha o botão **Associar ou Desassociar**.
1. Escolha o **X** ao lado da **(s) Solução** **(s),AWS produto (s)** ou ** AWS Marketplace oferta (s)** que você deseja remover.
1. Escolha **Salvar**.
# Aceitando várias oportunidades
Você pode aceitar várias oportunidades AWS originadas simultaneamente usando a funcionalidade de aceitação em massa. Esse recurso simplifica o processo de aceitação de oportunidades, reduzindo o esforço manual.
1. No AWS Partner CRM Connector, abra a guia **ACE Opportunities**.
1. Selecione as oportunidades que você deseja aceitar marcando a caixa na primeira coluna.
1. Escolha o botão **Aceitar oportunidades** no canto superior direito. Se o botão não estiver visível, escolha a seta para baixo e escolha **Aceitar oportunidades**.
1. Na página **Aceitar oportunidades**, somente as oportunidades que não foram aceitas serão selecionadas.
1. Confirme as oportunidades selecionadas e escolha **Aceitar oportunidades**.
1. A próxima tela mostrará o progresso do trabalho Aceitar Oportunidades.
1. Quando concluída, a tela **Aceitar oportunidades** mostrará o número de itens processados e quaisquer erros.
1. Escolha **Fechar** para voltar à guia **Oportunidades ACE**.
# Atribuição de várias oportunidades
Você pode atribuir várias oportunidades a outro usuário em sua conta do Partner Central simultaneamente usando a funcionalidade de atribuição em massa. Esse recurso simplifica o processo de atribuição de oportunidades, reduzindo o esforço manual.
**Importante**
Antes de atribuir oportunidades a um usuário, a oportunidade deve ser compartilhada com AWS. Oportunidades não compartilhadas AWS falharão no processamento ou serão desmarcadas durante o assistente de atribuição.
1. No AWS Partner CRM Connector, abra a guia **ACE Opportunities**.
1. Selecione as oportunidades que você deseja atribuir marcando a caixa na primeira coluna.
1. Escolha o botão **Atribuir oportunidades** no canto superior direito. Se o botão não estiver visível, escolha a seta para baixo e escolha **Atribuir oportunidades**.
1. Na página **Atribuir oportunidades**, insira os campos obrigatórios: **nome**, **sobrenome**, **e-mail** e **título da empresa**.
1. Em **Oportunidades selecionadas**, somente as oportunidades compartilhadas AWS serão selecionadas. Todas as oportunidades com as quais não foram compartilhadas AWS serão desmarcadas.
1. Confirme as oportunidades selecionadas e escolha **Atribuir oportunidades selecionadas**.
1. A próxima tela mostrará o progresso do trabalho Atribuir oportunidades.
1. Quando concluída, a tela **Atribuir oportunidades** mostrará o número de itens processados e quaisquer erros.
1. Escolha **Fechar** para voltar à guia **Oportunidades ACE**.
# Gerenciando oportunidades em um CRM com integração com o Amazon S3
Os tópicos a seguir explicam como usar o conector CRM com um CRM com integração com o Amazon S3.
**Topics**
+ [Importação de soluções para o Salesforce](import-solutions-tab.md)
+ [Aceitar ou rejeitar oportunidades AWS originadas](accept-reject-opportunities.md)
+ [Sincronizando dados de oportunidades e leads](send-receive-opportunities-leads.md)
+ [Vinculando ofertas AWS Marketplace privadas a oportunidades da ACE](link-private-offer-to-opportunity.md)
+ [Visualizando registros detalhados do registro de sincronização para oportunidades de ACE](view-ace-details.md)
# Importação de soluções para o Salesforce
As soluções de parceiros são produtos de software ou práticas de consultoria que AWS os parceiros criam e fornecem. Eles foram projetados para ajudar os clientes a resolver desafios comerciais específicos ou atingir metas específicas usando AWS serviços. Para obter mais informações, consulte [Como criar uma solução](https://docs.aws.amazon.com/partner-central/latest/builder-guide/creating-a-solution.html) no *Guia do AWS Partner Central Builder*.
As etapas a seguir explicam como importar as soluções do Partner Central para o Salesforce. Em seguida, você pode associar as soluções às oportunidades.
**Para importar soluções**
1. Faça login no Salesforce como usuário de vendas.
1. Escolha **Iniciador de aplicativos** e, em seguida, pesquise e selecione **AWS Partner CRM Connector.**
1. Abra a guia **Ofertas de soluções**.
1. Escolha o botão **Atualizar soluções**.
1. Escolha **Continuar** para confirmar que você deseja importar soluções do Partner Central.
# Aceitar ou rejeitar oportunidades AWS originadas
As etapas a seguir explicam como aceitar ou rejeitar oportunidades em uma integração com o Amazon S3 da APN.
1. Abra o registro de oportunidades.
1. Abra a lista de **status de aceitação do parceiro** e escolha **Aceito** ou **Rejeitado**.
Se você escolher **Rejeitado**, abra a lista de **motivos da rejeição** e escolha um motivo.
1. Escolha **Salvar**.
# Sincronizando dados de oportunidades e leads
Para sincronizar uma oportunidade ou lead com a APN, você deve definir o campo **Sincronizar com o Partner Central** como **True**. Campos adicionais para integração incluem os campos **Data da última sincronização do APN** e **Qualificado para sincronização com o APN.** Oportunidades e leads padrão incluem esses campos. No entanto, você deve criar e mapear os campos para o objeto correspondente se os objetos de origem estiverem definidos como personalizados.
+ **Sincronize com o Partner Central** — incluído no aplicativo para oportunidades e leads padrão. Se você optar por mapear para objetos personalizados, deverá criar e mapear esse campo como booleano.
+ **Data da última sincronização com o APN** — Indica a última vez em que o registro foi enviado com sucesso para o APN ou recebido do APN. Esse campo é definido 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 organização do AWS parceiro.
# Vinculando ofertas AWS Marketplace privadas a oportunidades da ACE
Você pode vincular ofertas privadas diretamente da página de registro de oportunidades do ACE AWS entregue no Salesforce.
1. Faça login na sua organização do Salesforce.
1. No **App Launcher**, escolha o 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**.
# Visualizando registros detalhados do registro de sincronização para oportunidades de ACE
Você pode ver os detalhes do registro de sincronização AWS de oportunidades ACE entregues na seção **Relacionados** do 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 seção **Registro de sincronização do ACE**.
1. Faça login na sua organização do Salesforce.
1. No **App Launcher**, escolha o conector **AWS Partner CRM.**
1. Na seção **Oportunidades ACE**, escolha um registro de oportunidade ACE.
1. A seção **Relacionado** exibe detalhes, incluindo **nome do registro de sincronização**, **status**, **mensagem de erro** e **data de criação**.
# Gerenciando AWS Marketplace atividades
Os tópicos a seguir explicam como usar o conector CRM para gerenciar AWS Marketplace atividades de dentro do Salesforce.
**Topics**
+ [Sincronizando o Salesforce com seus produtos AWS Marketplace](crm-sync-salesforce.md)
+ [Gerenciando ofertas privadas](crm-manage-private-offers.md)
+ [Gerenciando AWS Marketplace contratos](crm-manage-agreements.md)
+ [Gerenciando AWS Marketplace autorizações de revenda](crm-resale-authorizations.md)
# Sincronizando o Salesforce com seus produtos AWS Marketplace
Antes de trabalhar com AWS Marketplace produtos, você deve primeiro sincronizá-los com o Salesforce. A sincronização garante que você tenha os detalhes mais recentes do produto.
**Para sincronizar**
1. Faça login no Salesforce como administrador do sistema.
1. Escolha **Iniciador de aplicativos** e, em seguida, pesquise e selecione **AWS Partner CRM Connector.**
1. Escolha a guia **Produtos** e, em seguida, escolha **Atualizar produtos**.
1. Para o prompt **Deseja extrair a lista de produtos do AWS Marketplace**, escolha **Continuar**.
Quando o processo de sincronização terminar, você poderá usar o aplicativo conector para criar e gerenciar **ofertas privadas e autorizações** de **revenda**. As seções a seguir explicam como.
# Gerenciando ofertas privadas
Os tópicos a seguir explicam como usar o Salesforce para criar e gerenciar ofertas privadas para seus AWS Marketplace produtos. Os tópicos incluem criar, modificar e rastrear ofertas privadas, criar cronogramas de pagamento flexíveis, criar contratos com data futura e gerenciar todo o ciclo de vida de suas ofertas privadas.
**Topics**
+ [Acessando suas ofertas privadas](#crm-view-private-offers)
+ [Criação de ofertas privadas](#crm-create-private-offer)
## Acessando suas ofertas privadas
Para criar e gerenciar ofertas AWS Marketplace privadas de dentro do Salesforce, você usa a guia de **ofertas privadas** no conector do **AWS Partner CRM**. As etapas a seguir explicam como iniciar a guia.
1. Faça login na organização do Salesforce como usuário. AWS Marketplace
1. No Iniciador de aplicativos, pesquise e escolha o conector **AWS Partner CRM.**
1. Escolha a guia **Ofertas privadas**.
## Criação de ofertas privadas
Os tópicos a seguir explicam como criar ofertas AWS Marketplace privadas a partir do Salesforce. Expanda cada seção para saber mais.
### Etapas para criar ofertas privadas
**nota**
Ao criar uma oferta privada, os campos dinâmicos aparecem com base no produto escolhido e nas suas seleções à medida que você avança no processo de criação.
As etapas a seguir explicam como criar uma oferta privada. Você deve completar [Campos obrigatórios para ofertas privadas](#private-offer-required-fields) o. Opcionalmente, você pode criar um cronograma de pagamento flexível e um contrato com data futura, dependendo do tipo de produto selecionado. Além disso, você pode salvar a oferta como rascunho ou publicá-la na conta do comprador.
1. Na guia **Ofertas privadas**, escolha **Novo**.
1. Na página **Criar uma oferta**, no mínimo, preencha as informações [Campos obrigatórios para ofertas privadas](#private-offer-required-fields) listadas na próxima seção.
1. Faça algumas ou todas as ações a seguir:
+ **Para criar um cronograma de pagamento flexível**
1. Na seção **Produto e compradores**, escolha **Ativar unidades fixas e permita que os compradores paguem por esse produto em parcelas.**
1. Configure pagamentos na seção **Cronograma de pagamentos**.
+ **Para criar um contrato com data futura**
1. Na seção **Duração do serviço**, escolha **Nova oferta a partir de uma data futura**.
1. Insira **a data de início** do **serviço e a data de término** do serviço (se necessário).
1. Escolha **Criar oferta** para publicar a oferta para o comprador.
—OU—
Escolha **Salvar como rascunho** para salvar a oferta como rascunho e concluí-la posteriormente sem liberá-la para o comprador.
### Campos obrigatórios para ofertas privadas
Para criar uma oferta AWS Marketplace privada, você deve preencher os campos na lista a seguir, incluindo todas as opções.
**Produtos e compradores**
**ISV — Self**
**Produtos** — Escolha na lista de produtos sincronizados por meio do conector.
**Contas de compradores** — insira sua própria conta de teste de vendedor para validar a integração.
**Detalhes da oferta**
**Nome da oferta** — Insira um nome personalizado.
**Descrição da oferta** — insira uma descrição personalizada da oferta.
**Duração do serviço ou duração do contrato**
Escolha **Nova oferta** e escolha um serviço emprestado, como 12 meses.
**Dimensões da oferta**
Escolha o tipo de direito que você deseja oferecer.
Adicione tarifas de oferta ou atualize as tarifas existentes das dimensões escolhidas.
Para enviar uma oferta na qual qualquer uma das taxas de dimensão esteja definida em \$10, escolha **Quero ativar o preço de zero dólar**.
**Contrato de Licença de Usuário Final (EULA)**
Escolha **Contrato padrão AWS Marketplace** ou **EULA personalizado**.
Se você escolher o **EULA personalizado**, deverá configurar um bucket do Amazon S3 para armazenar o EULA personalizado ao integrar a conta do vendedor. AWS Para obter mais informações, consulte [Como criar seu primeiro bucket do Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/GetStartedWithS3.html#creating-bucket) no Guia do *usuário do Amazon Simple Storage Service*.
**Renovações**
Para **Esta oferta tem como objetivo renovar uma assinatura paga existente com um cliente existente para o mesmo produto subjacente**? , escolha **Sim** ou **Não**.
**Informações de expiração**
Insira a data de expiração da oferta. Para produtos do tipo assinatura, insira a data de término da assinatura.
### Visualizando e atualizando o status da oferta
1. Abra a guia **Ofertas privadas**.
1. Na lista de **ofertas privadas**, escolha o **nome da oferta privada**.
1. Escolha **Atualizar status da oferta**. O status da oferta aparece na parte inferior da página. Valores disponíveis: **PREPARAÇÃO**, **APLICAÇÃO**, **SUCESSO** ou **FALHA**.
**nota**
O status pode levar até duas horas para ser alterado para **BEM-SUCEDIDO**.
### Modificando a data de expiração de uma oferta
1. Abra a guia **Ofertas privadas**.
1. Na lista de **ofertas privadas**, escolha o **nome da oferta privada**.
1. Escolha **Modificar expiração/validade**.
1. Escolha a nova **data de expiração da oferta.**
1. Escolha **Modificar expiração/validade** para salvar sua seleção.
### Modificando a data de expiração de uma oferta privada
Depois de cancelar uma oferta privada, nenhum novo cliente poderá se inscrever nela. Clientes com assinaturas existentes permanecerão inscritos até que os termos da oferta expirem.
1. Abra a guia **Ofertas privadas**.
1. Na lista de **ofertas privadas**, escolha o **nome da oferta privada**.
1. Escolha **Cancelar oferta** e, em seguida, escolha **Cancelar oferta** novamente para confirmar o cancelamento.
### Copiar o URL de uma oferta privada
1. Abra a guia **Ofertas privadas**.
1. Na lista de **ofertas privadas**, escolha o **nome da oferta privada**.
1. Localize a seção **Status da oferta** na parte inferior da página.
1. Escolha **Copiar URL**.
### Clonando uma oferta privada
A clonagem de uma oferta privada cria uma nova oferta que contém dados da oferta clonada. Se você ativar a configuração **Adicionar conta do vendedor à lista de compradores** do conector, o conector inserirá automaticamente o número da conta do AWS vendedor na lista de **contas do comprador**. Isso ajuda o vendedor a se referir à oferta privada do ponto de vista do comprador.
1. Abra a guia **Ofertas privadas**.
1. Na lista de **ofertas privadas**, escolha o **nome da oferta privada**.
1. Escolha **Clone Offer**.
1. Edite a seção **Detalhes da oferta** clonada conforme necessário.
1. Se necessário, recarregue o EULA.
1. Escolha **Criar oferta**.
### Usando o utilitário FPS para preencher os cronogramas de pagamento
Ao criar uma oferta AWS Marketplace privada, use o utilitário FPS para preencher os cronogramas de pagamento com custos fixos e lacunas de pagamento iguais.
**Para usar o FPS**
1. Na guia **Programação de Pagamento**, escolha **Sim** para gerar um plano de pagamento com custo fixo e lacunas de pagamento iguais.
1. Escolha uma **frequência de pagamento** de 15, 30, 90 ou 365 dias.
1. Escolha as **opções restantes**. **Para colocar o restante do pagamento desigual no primeiro pagamento, escolha Frontload.** Para colocar o restante no último pagamento, escolha **Backend**.
1. Em **Opções de calendário**, para configurar a frequência de pagamento para incluir dias de fim de semana, escolha **Dia do calendário**. Para não incluir dias de fim de semana, escolha **Dia útil**.
1. Insira o valor do pagamento (soma de todos os pagamentos), a data de início do pagamento (primeiro pagamento) e a data aproximada de término do pagamento.
1. Escolha **Gerar agendamento**.
1. Revise e edite os valores de pagamento e as datas da fatura conforme necessário.
# Gerenciando AWS Marketplace contratos
Os tópicos a seguir explicam como AWS vendedores e parceiros de canal podem usar o conector CRM para acessar contratos e visualizar detalhes do contrato.
**Topics**
+ [](#crm-refresh-agreements)
##
Como prática recomendada, atualize sua lista de contratos antes de tomar qualquer outra ação.
**Para atualizar contratos**
1. Entre na sua organização do Salesforce como usuário. AWS Marketplace
1. Escolha o **App Launcher** e, em seguida, pesquise e selecione o conector **AWS Partner CRM.**
1. Escolha a guia **Acordos**.
1. Escolha **Atualizar contrato**.
1. Na caixa de diálogo **Atualizar contratos**, escolha **Continuar**.
O sistema sincroniza os contratos de todas as ofertas privadas e os exibe na guia **Contratos**.
### Criação de ofertas baseadas em contratos
AWS Marketplace vendedores e parceiros de canal podem criar ofertas baseadas em contratos e usá-las para gerar novas ofertas privadas com base nos contratos existentes. As ofertas baseadas em contratos estão sujeitas a certas limitações. Para obter mais informações, consulte [Alteração de contratos AWS Marketplace no](marketplace/latest/userguide/private-offers-upgrades-and-renewals.html) *Guia do AWS Marketplace usuário*.
**nota**
Como prática recomendada, atualize os dados na guia **Autorização de revenda compartilhada** antes de criar uma oferta baseada em contrato.
**Para criar uma oferta baseada em contrato**
1. Entre na sua organização do Salesforce como usuário. AWS Marketplace
1. No App Launcher, pesquise e escolha o conector **AWS Partner CRM.**
1. Escolha a guia **Acordos**.
1. Na lista de **contratos**, escolha o nome do contrato.
1. Escolha **Criar oferta baseada em contrato**.
1. No formulário **Criar uma oferta**, preencha os campos obrigatórios.
1. Escolha **Criar oferta**.
# Gerenciando AWS Marketplace autorizações de revenda
Como ISV, você pode autorizar um parceiro de AWS canal a revender seus produtos criando uma autorização de revenda diretamente no Salesforce usando o Partner CRM Connector. AWS O conector permite que você especifique uma taxa fixa por dimensão do produto, o que cria um preço de atacado para o parceiro de AWS canal. O parceiro de canal pode então aumentar o preço de atacado ao criar ofertas privadas para compradores. O conector permite que você gerencie todo o ciclo de vida das autorizações de revenda, da criação e modificação à desativação e clonagem, para que você possa lidar com todos os aspectos de seus relacionamentos com parceiros de canal sem sair da Salesforce.
**Topics**
+ [Usando a guia Autorização de revenda](#crm-resale-auth-tab)
+ [Criação de uma autorização AWS Marketplace de revenda](#crm-resale-auth-creation-steps)
+ [Campos obrigatórios para autorizações de revenda](#crm-required-resale-fields)
+ [Desativando uma autorização de revenda](#crm-deactivate-resale-auth)
+ [Clonando autorizações de revenda](#crm-clone-resale-auth)
+ [Visualizando e atualizando o status da autorização de revenda](#crm-view-refresh-auth-status)
## Usando a guia Autorização de revenda
Você usa a guia **Autorização de revenda** no conector do AWS Partner CRM para criar e gerenciar autorizações de revenda.
**Para iniciar a guia**
1. Entre na sua organização do Salesforce como usuário. AWS Marketplace
1. Escolha **Iniciador de aplicativos** e, em seguida, pesquise e selecione **AWS Partner CRM Connector.**
1. Escolha a guia **Autorização de revenda**.
## Criação de uma autorização AWS Marketplace de revenda
**nota**
Ao criar uma autorização de revenda, os campos dinâmicos aparecerão com base no produto escolhido e nas seleções feitas durante o processo de criação.
As etapas a seguir explicam como criar uma autorização de AWS Marketplace revenda. Você tem a opção de criar um cronograma de pagamento flexível e um contrato com data futura com base no tipo de produto selecionado. Você pode criar uma autorização de revenda e publicá-la para um parceiro de canal ou salvar uma autorização como rascunho sem divulgá-la.
1. **Na guia **Autorizações de revenda**, escolha Novo.**
1. Na página **Criar uma autorização de revenda**, preencha os campos obrigatórios.
1. (Opcional) Crie um cronograma de pagamento flexível
1. Na seção **Produto e compradores**, escolha **Ativar unidades fixas e permita que os compradores paguem por esse produto em parcelas.**
1. Configure pagamentos na seção **Cronograma de pagamentos**.
1. Escolha **Criar autorizações de revenda** para publicar a oferta para o parceiro de canal.
—OU—
Escolha **Salvar como rascunho** para concluir a oferta mais tarde, sem divulgá-la para o parceiro de canal.
## Campos obrigatórios para autorizações de revenda
Você deve preencher os campos a seguir e todas as opções listadas aqui.
**Produtos e compradores**
**Produtos** — Escolha na lista de produtos disponíveis sincronizados por meio do conector CRM.
**Contas de compradores**
Uma lista separada por vírgulas das contas do comprador-alvo para oferta.
**Detalhes da autorização de revenda**
Nome da **autorização de revenda — Insira um nome**
**Descrição** — Insira uma descrição (visível pelo parceiro de AWS canal)
**Conta de revendedor** — insira o número da AWS conta de 12 dígitos do revendedor.
**Nome da autorização de revenda**
Insira um nome.
**Descrição**
Insira uma descrição (visível pelo parceiro de AWS canal).
**Conta de revendedor**
Insira o número da AWS conta de 12 dígitos do revendedor.
**Duração do contrato (se aplicável)**
**Padrão**
**Duração personalizada** — Ao escolher essa opção, insira **Duração do serviço personalizada**.
**Preços do produto (se aplicável)**
+ As opções incluem **modelo de uso** ou **modelo de contrato**.
+ Para o **modelo de contrato**, você pode ativar o FPS na seção **Compradores e produtos**.
**Termos legais**
+ Escolha **Contrato padrão para AWS Marketplace** ou **EULA personalizado para contrato de licença de usuário final** para o comprador.
+ Opcionalmente, escolha Contrato de **Revendedor para AWS Marketplace ou Contrato** **Personalizado para Contrato de Revendedor**.
+ Para **EULA personalizado (comprador)** e **contrato personalizado (revendedor)**, certifique-se de ter configurado o bucket do Amazon Simple Storage Service para a conta do vendedor para armazenar o EULA personalizado.
**Dimensões do produto**
Adicione ou atualize as taxas de oferta e as unidades às dimensões escolhidas.
**Escolha **Quero habilitar preços de zero dólares** para criar uma autorização de revenda na qual qualquer uma das taxas de dimensão seja definida como \$10.**
**Duração da autorização de revenda**
Escolha o **tipo de duração** e forneça detalhes sobre a **data de expiração da autorização de revenda**, conforme necessário.
**Renovações**
Para **Esta oferta tem como objetivo renovar uma assinatura paga existente com um cliente existente para o mesmo produto subjacente**? , escolha **Sim** ou **Não** e insira os detalhes necessários.
## Desativando uma autorização de revenda
1. **Na guia **Autorizações de revenda**, escolha Novo**
1. Em **Nome da autorização de revenda**, escolha o nome da autorização que você deseja desativar.
1. Escolha **Desativar autorização de revenda**.
1. Escolha **Atualizar status de autorização de revenda**.
O status da autorização muda para **Restrito** quando a desativação é bem-sucedida.
## Clonando autorizações de revenda
Você clona uma autorização de revenda quando precisa alterar os detalhes de uma autorização existente. Por exemplo, você clona uma autorização quando precisa fornecer um EULA diferente a um parceiro.
**Para clonar uma autorização de revenda**
1. **Na guia **Autorizações de revenda**, escolha Novo**
1. Na lista de autorizações de revenda, escolha o Nome da autorização de **revenda**.
1. Escolha a autorização de **revenda de clones**
1. Revise e edite a seção **Detalhes da autorização de revenda** da autorização clonada. Se você usar um EULA personalizado ou um contrato personalizado (contrato de revendedor) na autorização clonada, deverá reenviar os termos legais.
1. Escolha **Criar autorização de revenda**.
## Visualizando e atualizando o status da autorização de revenda
1. **Na guia **Autorizações de revenda**, escolha Novo**
1. Na lista **Autorizações de Revenda**, escolha o Nome da Autorização de **Revenda**.
1. Escolha **Atualizar status de autorização de revenda**.
1. Escolha **Continuar**.
1. Repita as etapas 5 e 6 até que o status da autorização de revenda mude para **BEM-SUCEDIDO**.
Aguarde 30 segundos antes de escolher novamente o botão **Atualizar status da autorização de revenda**. Isso garante que cada solicitação de atualização seja totalmente processada e preserva a integridade dos dados, evitando a possível duplicação de registros.
# Usando um CRM anterior com integração com o Amazon S3
**Importante**
O AWS Partner Central parou de aceitar novas solicitações para esse tipo de integração em 2024. Esta seção se aplica somente aos parceiros que usam o Amazon S3.
Para começar com uma nova integração personalizada de CRM, consulte a [Referência de API do AWS Partner Central](https://docs.aws.amazon.com/partner-central/latest/APIReference/aws-partner-central-api-reference-guide.html).
**Topics**
+ [Atualização de um CRM com integração do Amazon S3 para a API do Partner Central](upgrade-crm-api.md)
+ [Configurando o conector para um CRM com integração com o Amazon S3](s3-config.md)
+ [Recursos de integração](resources.md)
+ [Compartilhamento de leads](custom-lead-sharing.md)
+ [Compartilhamento de oportunidades](custom-opportunity-sharing.md)
+ [Mapeamentos de campos](custom-field-mapping.md)
+ [Criação de agendamentos de sincronização](crm-connector-scheduling.md)
+ [Práticas recomendadas](best-practices.md)
+ [Cotas](quotas.md)
+ [Histórico de versões](version-history.md)
+ [FAQs](faqs.md)
# Atualização de um CRM com integração do Amazon S3 para a API do Partner Central
**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.
As etapas nas seções a seguir explicam como fazer o upgrade de um CRM anterior com a integração do Amazon S3 para a API do AWS Partner Central. A atualização elimina a necessidade de vários requisitos do ACE, como a necessidade de um usuário de integração e a necessidade de configurar agendamentos de sincronização.
**Topics**
+ [Recursos de atualização](api-upgrade-features.md)
+ [Configurar credenciais nomeadas](set-up-api-credentials.md)
+ [Adicione o botão Status de aprovação à página de registro do Opportunity Lightning](add-approval-status-button.md)
+ [Adicione os botões restantes](add-remaining-buttons.md)
+ [Atualize a guia Ofertas de soluções](refresh-the-solutions-from-the-solution-offerings-tab.md)
# Recursos de atualização
A atualização fornece os seguintes recursos:
+ Você não precisa mais de um conjunto de permissões de usuário de integração ACE no Salesforce.
+ Você não precisa mais criar um cronograma para oportunidades de ACE no Salesforce.
+ A API Partner Central também fornece um conjunto de botões que permitem as seguintes ações em sua página de **registro do Opportunity Lightning**:
+ **Status de aprovação** — Aceite ou rejeite AWS oportunidades recomendadas.
**nota**
Esse botão substitui a lista de **status de aceitação do parceiro**. Você deve usar o botão para aceitar oportunidades AWS originadas.
+ **Compartilhe com AWS** — Crie e atualize oportunidades.
+ **Associar ou desassociar** — associe ou desassocie uma oportunidade com soluções, AWS produtos e AWS Marketplace ofertas de parceiros em todo o ciclo de vida da oportunidade.
+ **Atribuir** — reatribua uma oportunidade a outro usuário em sua conta do Partner Central.
Você adiciona os botões depois de configurar as credenciais nomeadas. Os tópicos a seguir explicam como concluir essas tarefas.
# Configurar credenciais nomeadas
Para fazer o upgrade para a API do Partner Central, primeiro você configura as credenciais nomeadas. O conector do CRM usa as credenciais da sua organização do Salesforce para se autenticar no Partner Central.
**Para configurar credenciais**
1. Faça login no Salesforce como administrador do sistema.
1. Em **Credenciais nomeadas**, escolha **Novo mais cedo**.
1. No formulário **Nova credencial nomeada**, insira os valores da tabela a seguir.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/partner-central/latest/crm/set-up-api-credentials.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.
# Adicione o botão Status de aprovação à página de registro do Opportunity Lightning
As etapas a seguir explicam como adicionar o botão **Status de aprovação** à sua página de registro do Opporuntiy Lightning. O botão permite que você veja o status de suas oportunidades à medida que elas passam pelo processo de aprovação.
**Para adicionar o botão**
1. Entre na sua organização do Salesforce como administrador do sistema.
1. Navegue até a página de **registro do Opportunity Lightning**.
1. Escolha o painel destacado para abrir o painel de propriedades.
1. Selecione **Atualizar agora**.
1. Selecione **Migrar ações existentes** e, em seguida, selecione o layout de página a partir do qual você deseja atualizar as ações.
—OU—
Comece do zero e adicione as ações manualmente.
1. Na lista **Ações**, escolha **Status de aprovação**.
1. Escolha **Salvar**.
**nota**
Você só precisa concluir as etapas 4 e 5 uma vez.
O botão **Status de aprovação** só aparece na página de **registro do Opportunity Lightning** para oportunidades AWS indicadas.
# Adicione os botões restantes
Você pode adicionar alguns ou todos os botões listados nas etapas a seguir.
**Para adicionar os botões**
1. Entre na sua organização do Salesforce como administrador do sistema.
1. Navegue até a **página de registro do Opportunity Lightning**.
1. Escolha o painel destacado para abrir o painel de propriedades.
1. **Escolha Atribuir em Ações** e selecione alguns ou todos os itens a seguir:
+ **Compartilhe com AWS**
+ **Associar ou desassociar**
+ **Atribuir**
Para obter mais informações sobre o que cada botão faz, consulte o [Recursos de atualização](api-upgrade-features.md) artigo anterior neste guia.
1. Escolha **Salvar**.
# Atualize a guia Ofertas de soluções
As etapas a seguir explicam como atualizar os dados na guia **Ofertas de soluções**.
1. Entre na sua organização do Salesforce como administrador do sistema.
1. Navegue até a guia **Ofertas de soluções**.
1. Selecione **Atualizar soluções**.
# Configurando o conector para um CRM com integração com o Amazon S3
**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
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
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
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
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
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
**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
+ 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
**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
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
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**.
# Recursos de integração
AWS fornece os seguintes recursos para ajudá-lo a criar uma integração personalizada.
**Topics**
+ [Definições de campo](#custom-field-definitions)
+ [Valores padrão](#standard-values)
+ [Amostra de arquivos de entrada](#sample-inbound-files)
+ [Amostra de arquivos de saída](#sample-outbound-files)
+ [Amostra de resultados processados](#sample-processed-results)
+ [Exemplos de casos de teste](#sample-test-cases)
+ [Exemplos de trechos de código](#sample-code-snippets)
## Definições de campo
Os links nas seções a seguir listam todos os campos, explicando seus tipos de dados, uso e quaisquer restrições ou regras de formatação aplicáveis. Eles servem como referência para garantir que, quando parceiros e AWS trocam dados, eles sejam formatados e compreendidos corretamente.
Os links a seguir levam você para GitHub.
+ [Oportunidade](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv)
+ [Chumbo](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Leads-Fields.csv)
## Valores padrão
Essas listas descrevem os valores padrão e as enumerações para vários campos. Eles ajudam a manter a consistência nos dados trocados e garantem que ambas as partes tenham um entendimento comum dos valores usados.
Os links a seguir levam você para GitHub.
+ [Oportunidade](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity_-_StandardValues.csv)
+ [Chumbo](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead_-_StandardValues.csv)
## Amostra de arquivos de entrada
Os arquivos de amostra a seguir mostram a estrutura da carga JSON de um arquivo enviado de um parceiro para o. AWS
Os links a seguir levam você para GitHub.
+ [Oportunidade](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Create-Inbound-Sample.json)
+ [Chumbo](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Update-Inbound-Sample.json)
## Amostra de arquivos de saída
Os arquivos de amostra a seguir mostram a estrutura da carga JSON de um arquivo enviado de um AWS parceiro.
Os links a seguir levam você para GitHub.
+ [Oportunidade](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Outbound-Sample.json)
+ [Chumbo](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Outbound-Sample.json)
## Amostra de resultados processados
Os arquivos a seguir mostram um resultado típico após o AWS processamento de uma carga enviada por um parceiro.
Os links a seguir levam você para GitHub.
+ [Oportunidade](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results-Success-Sample.json)
+ [Chumbo](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results-Success-Sample.json)
## Exemplos de casos de teste
Os links a seguir levam você para GitHub.
+ [Oportunidade](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity%20-%20Testing%20Scenarios.xlsx)
+ [Chumbo](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead%20-%20Testing%20Scenarios.xlsx)
## Exemplos de trechos de código
Os links a seguir levam você para GitHub.
+ [ace\$1read\$1s3.py](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/ace_read_s3.py)
+ [Apex\$1sample\$1rest\$1 API\$1C node.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Apex_Sample_REST_API_Code.cls)
+ [S3\$1Autenticação.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls)
+ [Amostra\$1 .cls AceOutboundBatch](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls)
+ [SFDC apex s3 sample.txt](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/SFDC_apex_s3_sample.txt)
+ [Apex\$1get\$1files\$1from\$1S3\$1ACE\$1partner\$1test.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Apex_get_files_from_s3_ace_partner_test.cls)
+ [s3\$1ace\$1partner\$1test.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/s3_ace_partner_test.cls)
# Compartilhamento de leads
## Como os AWS compartilhamentos lideram
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
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
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.
# Compartilhamento de oportunidades
## Como AWS compartilha oportunidades
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
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
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.
# Mapeamentos de campos
O mapeamento de campo é uma etapa essencial no processo de integração em que os parceiros alinham os campos do sistema de gerenciamento de relacionamento com o cliente (CRM) com os definidos pela Amazon Web Services (AWS). Isso garante que ambas as partes troquem e entendam os dados com precisão. Abaixo estão as diretrizes para auxiliar nesse processo.
## Mapeamento de campo obrigatório
+ Mapeie cada campo obrigatório para o campo correspondente em seu sistema de CRM. É essencial para uma troca de dados bem-sucedida quando você garante que todos os campos obrigatórios sejam mapeados. Para obter mais informações, consulte [Definições de campo](resources.md#custom-field-definitions)
+ [Oportunidade](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv)
+ [Chumbo](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Leads-Fields.csv)
## Manipulando campos opcionais
+ Entenda a função dos campos opcionais no processo de integração. Decida se você deseja mapear esses campos com base nos requisitos de sua empresa e esteja ciente das possíveis implicações de deixá-los não mapeados.
## Mapeamento de valores
+ Alinhe cada valor de campo em seu CRM com o valor obrigatório AWS Partner Network (APN) da lista Customer Engagement (ACE), conforme especificado em. [Definições de campo](resources.md#custom-field-definitions) Isso é importante para manter a consistência e a integridade dos dados.
## Validação de tipo e formato de dados
+ Verifique se os tipos e formatos de dados dos campos em seu sistema CRM estão alinhados com os especificados nas definições de AWS *campo*. É essencial manter a consistência nos tipos e formatos de dados para evitar a corrupção dos dados e garantir uma integração perfeita.
## Comprimento e limitações do campo
+ Observe as restrições de tamanho do campo e outras limitações. Certifique-se de que os dados do seu sistema de CRM se encaixem nos campos correspondentes AWS sem serem truncados ou causarem erros.
## Validação de tipo e formato de dados
+ Verifique se os tipos e formatos de dados de campo em seu sistema CRM estão alinhados com os especificados em. [Definições de campo](resources.md#custom-field-definitions) É crucial evitar a corrupção de dados e garantir uma integração perfeita com consistência nos tipos e formatos de dados.
## Revisão e atualização periódicas
+ Revise e atualize regularmente seus mapeamentos de campo para acomodar mudanças no sistema ou nos requisitos do CRM. AWS Essa abordagem proativa garante precisão e eficiência contínuas na troca de dados.
## Documentação de mapeamento de campo
+ Mantenha uma documentação abrangente de mapeamento de campo. Essa prática ajuda na solução de problemas, nas futuras atualizações e na garantia de clareza na forma como os dados são transferidos entre sistemas.
## Teste e validação
+ Realize testes completos de mapeamento de campo para validar se os dados estão sendo transferidos e transformados com precisão. Resolva quaisquer discrepâncias ou problemas imediatamente para garantir a integridade dos dados.
## Lidando com substituições indesejadas
+ Para evitar que AWS os dados substituam campos específicos do CRM, considere o seguinte:
+ Criação de um campo CRM personalizado para os dados que você deseja proteger.
+ Ter esse campo personalizado revisado por um representante de vendas.
+ Depois que o campo personalizado for aprovado, adicione-o ao registro da oportunidade e ao pipeline.
+ Isso é particularmente importante para campos como `MRR` ou`Stage`, especialmente se eles significarem que um produto foi lançado.
## Gerenciando dependências posteriores
+ Se houver dependências posteriores em seu sistema que dependam da troca de dados, considere o seguinte:
+ Criação de novos campos em seu CRM para acomodar os AWS dados.
+ Realinhando seus processos de negócios conforme necessário para garantir a integração perfeita e o fluxo de dados.
# Criação de agendamentos de sincronização
**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.
Você pode criar programações de sincronização de entrada e saída entre o Salesforce e o AWS Partner Central. As etapas nas seções a seguir explicam como.
**Topics**
+ [Pré-requisitos](#scheduling-prerequisites)
+ [Criar uma programação](#creating-a-schedule)
+ [Desativando um trabalho agendado](#deactivating-a-scheduled-job)
+ [Visualizando todas as programações](#viewing-all-schedules)
## Pré-requisitos
Certifique-se de concluir o seguinte antes de criar uma agenda de sincronização:
+ [Mapeie](crm-connector-mapping.md) todos os campos obrigatórios em pelo menos um objeto, oportunidade ou lead.
+ Crie um [usuário de integração de sistema](#system-integration-user) no Salesforce.
### Criação de um usuário de integração de sistemas
Antes de criar um cronograma de sincronização, você deve usar o Salesforce para criar um usuário de integração do sistema com permissões de integração do APN. Para criar agendas de sincronização, você deve entrar no Salesforce como usuário de integração do sistema. Criar um cronograma sem as permissões do usuário da integração com o APN pode interromper a integração com o APN.
**Para criar um usuário de integração do sistema**
1. Entre na sua organização do Salesforce como administrador do sistema.
1. Crie um usuário em sua organização do Salesforce. Atribua um perfil ao usuário com acesso aos objetos necessários em sua organização do Salesforce. Para obter mais informações, consulte [Adicionar um único usuário](https://help.salesforce.com/s/articleView?id=sf.adding_new_users.htm).
1. Atribua ao usuário o conjunto de permissões de **usuário de integração do APN**. Para obter mais informações, consulte [Atribuir conjunto de permissões aos usuários](https://help.salesforce.com/s/articleView?id=sf.assign_permission_set_to_user.htm).
## Criar uma programação
Depois de concluir os [pré-requisitos](#scheduling-prerequisites), você pode criar agendas de sincronização entre o Salesforce e o APN.
**Para criar uma agenda de sincronização com o APN**
1. Faça login no Salesforce como usuário com permissões de usuário de integração do sistema.
1. Na guia **Programações**, escolha **Novo**.
1. Escolha os objetos a serem programados. Você pode configurar cronogramas para leads e oportunidades ou para um único objeto.
1. Escolha a frequência da programação, de no mínimo a cada cinco minutos a no máximo uma vez por dia.
1. Escolha **Schedule (Programação)**
**nota**
Somente um agendamento por objeto pode estar ativo por vez. A criação de uma nova agenda para o mesmo objeto desativa a agenda existente.
Para desativar a integração de entrada ao criar uma agenda, escolha **Desativar integração de entrada,** Programar.
Criar um cronograma sem as permissões do usuário da integração com o APN pode interromper a integração com o APN.
## Desativando um trabalho agendado
1. Na página **Agendamento**, escolha **Desativar todos os trabalhos** para desativar qualquer agendamento ativo.
1. Vá até a tela de confirmação para desativar a programação de sincronização.
## Visualizando todas as programações
**Na guia **Agendas**, use os filtros de exibição de lista para alternar entre agendamentos de sincronização **ativos**, **inativos** e todos.**
# Práticas recomendadas
Use essas melhores práticas para otimizar o desenvolvimento e a manutenção de sua integração personalizada.
## Práticas recomendadas gerais
1. Mapeie todos os campos *obrigatórios* porque eles são os campos obrigatórios no AWS Partner Network formulário de envio do Customer Engagement (ACE) (APN).
1. Conecte-se com seu usuário atual do ACE Pipeline Manager para entender como é o processo. Capture todos processes/field os usos exclusivos para que você possa incorporá-los à sua experiência.
1. Considere criar estágios separados do funil de vendas para os estágios de vendas reportados pela Amazon Web Services (AWS) (exemplo: estágio, data de fechamento prevista, AWS receita mensal esperada, próximas etapas). Se tivermos definições de estágio diferentes, poderemos substituir seus estágios de vendas. Quando você cria estágios de vendas separados, isso permite que você gerencie seu funil de forma adequada, mas ainda tenha visibilidade do que AWS está sendo projetado.
1. Para oportunidades indicadas por parceiros, a equipe ACE deve approve/reject usá-las antes de aceitarmos qualquer atualização.
1. Para oportunidades AWS referidas, o parceiro deve aceitar ou rejeitar as oportunidades.
## Protocolos de troca de dados
1. **Convenções de entrada**: separe as entradas da lista de opções de seleção múltipla com ponto e vírgula e omita espaços.
1. **Atenção aos detalhes**: os nomes e valores dos campos diferenciam maiúsculas de minúsculas, portanto, mantenha a precisão.
1. **Procedimentos de exclusão**: execute a remoção do campo transmitindo o valor `null` do campo escolhido.
1. **Sincronização**: Os processos de sincronização operam de hora em hora, causando possíveis atrasos nas reflexões de dados. As atualizações AWS podem levar até uma hora para serem refletidas no gerenciamento de relacionamento com o AWS cliente (CRM). Evite enviar vários documentos por hora.
## Práticas recomendadas específicas de campo
1. **Modificações de entrada**: para proteger a integridade de seus dados, desative as modificações em campos como `stage``closedDate`, e. `closedLostReason` Para rastrear AWS valores sem afetar seus valores locais do Salesforce, use estes campos somente para leitura:`awsStage`, e. `awsCloseDate` `awsClosedLostReason`
1. **Mapeamento e validação do** cliente: garanta a precisão do site do cliente, pois isso é fundamental para o mapeamento do AWS CRM. Combine-o com o nome do cliente para obter um mapeamento superior da conta de CRM.
1. **Clareza da descrição do projeto**: forneça uma descrição clara detalhando os desafios do cliente e os alinhamentos das soluções. AWS usa isso para validar a oportunidade.
1. **Provisionamento**: (Opcional) Quando você provisiona detalhes de contato do cliente final, ele permite AWS refazer leads e campanhas. Isso leva a melhores veredictos de financiamento.
## Melhores práticas adicionais
1. Siga as diretrizes mais recentes de definição de campo de carga útil.
1. Mantenha a consistência da nomenclatura do sandbox bucket com o formato especificado.
1. Use o padrão de nomenclatura recomendado para o bucket de produção.
1. Priorize os testes do ambiente sandbox antes da implantação ao vivo.
1. Mantenha identificadores distintos para registros entre AWS e o parceiro CRMs.
1. Após o processamento, exclua arquivos na pasta de saída do Amazon Simple Storage Service (Amazon S3). Os originais permanecem nos arquivos.
1. Para evitar erros, configure validações em nível de campo na fonte.
# Cotas
## Arquivo de entrada para a Amazon Web Services ()AWS
| Operação | Limite |
| --- | --- |
| Oportunidades máximas | 500 por arquivo |
| Tamanho máximo do arquivo | 1 MB |
| Frequência de sincronização | Quase em tempo real |
| Número máximo de arquivos enviados | 10.000 por período de 24 horas |
## Arquivo de saída para o parceiro
| Operação | Limite |
| --- | --- |
| Tamanho máximo do arquivo | 5 MB |
| Frequência de sincronização | Por hora |
# Histórico de versões
Versão atual dos campos: 14 (15 de novembro de 2023)
A tabela a seguir descreve mudanças importantes nos campos de integração personalizados para leads e oportunidades após 2020. Para ser notificado sobre futuras atualizações, assine o feed RSS.
| Alteração | Versão | Data |
| --- | --- | --- |
| Atualizar cotas do Amazon S3 | 14 | 17/01/2024 |
| **Mudanças nos campos de oportunidades de integração:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/partner-central/latest/crm/version-history.html) | 14 | 15/11/2023 |
| **Mudanças nos campos de oportunidades de integração:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/partner-central/latest/crm/version-history.html) | 13 | 29/03/2023 |
| **Mudanças nos campos de oportunidades de integração:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/partner-central/latest/crm/version-history.html) **Mudanças nos valores padrão de oportunidade:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/partner-central/latest/crm/version-history.html) | 12 | 09/01/2022 |
| **Mudanças nos campos de oportunidades de integração:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/partner-central/latest/crm/version-history.html) **Alterações nos valores padrão nos campos de oportunidade:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/partner-central/latest/crm/version-history.html) | 11 | 21/03/2022 |
| **Mudanças nos campos de oportunidades de integração:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/partner-central/latest/crm/version-history.html) **Mudanças nos valores padrão de oportunidade:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/partner-central/latest/crm/version-history.html) | 10 | 26/01/2022 |
| **Alterações nos valores padrão nos campos de chumbo:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/partner-central/latest/crm/version-history.html) **Mudanças nos campos principais de integração:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/partner-central/latest/crm/version-history.html) **Mudanças nos campos de oportunidades de integração:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/partner-central/latest/crm/version-history.html) | 9 | 16/09/2021 |
| Atualizar códigos de motivo fechado e perdido | 8 | 24/06/2021 |
# FAQs
Use essas perguntas e respostas comuns para ajudar na integração personalizada.
**Topics**
+ [Perguntas frequentes gerais](general-faq.md)
+ [Perguntas frequentes técnicas — Campos](technical-faq-fields.md)
+ [Perguntas frequentes técnicas — Amazon S3](technical-faq-s3.md)
+ [Perguntas frequentes técnicas — leads e oportunidades](technical-faq-leads-and-opps.md)
+ [Perguntas frequentes técnicas — controle de versão e compatibilidade com versões anteriores](technical-faq-versioning.md)
# Perguntas frequentes gerais
## Como a integração funciona?
**P: Posso acessar o bucket do Amazon Simple Storage Service (Amazon S3) usado para enviar e receber os arquivos?**
Sim. Os parceiros podem acessar programaticamente o bucket do Amazon S3 usando secret/access a chave AWS Identity and Access Management do (IAM) que tem acesso ao bucket. Os parceiros não terão acesso ao console aos buckets do Amazon S3 porque esses buckets estão na própria conta da Amazon Web Services (AWS).
**P: De que conjunto de habilidades o desenvolvedor do parceiro precisa?**
O desenvolvedor do parceiro precisa estar familiarizado com o sistema de gerenciamento de relacionamento com o cliente (CRM) e com o Amazon S3.
**P: Os arquivos de código de amostra incluem código completo ou o parceiro precisa escrever o código?**
O parceiro precisa escrever o código com base nos arquivos de código de amostra fornecidos.
**P: Se o parceiro desenvolve sua solução em Python, Golang ou qualquer outra linguagem, o AWS Partner Network (APN) Customer Engagement (ACE) fornece algum kit de desenvolvimento de software (SDK) nessas linguagens para essa integração?**
Não.
**P: Qual é o processo de sincronização do bucket do Amazon S3 com o ACE interno?**
A cada hora, um processo em lote é executado para coletar os arquivos e sincronizar as informações. Qualquer atualização que a equipe de AWS vendas fizer no registro pode levar até uma hora para ser enviada para o repositório do parceiro. Os parceiros podem receber uma notificação por e-mail sobre atualizações imediatamente, mas as atualizações ainda AWS podem ser adiadas em uma hora.
**P: Qual é a frequência de envios de arquivos de leads e oportunidades pela ACE?**
A ACE envia os dados de leads e oportunidades a cada uma hora.
**P: Existe um ambiente de sandbox para o ACE?**
Sim. Temos um ambiente de sandbox para o ACE, mas não podemos fornecer acesso aos parceiros por motivos de segurança. Crie um caso de suporte no Partner Central se quiser ter novas oportunidades ou leads em sua lista.
**P: Como mantemos identificadores no CRM e no APN do parceiro?**
Para oferecer mais flexibilidade aos nossos parceiros, usamos dois conjuntos de identificadores em nosso sistema.
1. `apnCrmUniqueIdentifier`: AWS gerencia esse identificador. Tudo começa com `OXXXXXX` `LXXXXXX` oportunidades e leads.
1. `PartnerCrmUniqueIdentifier`/`partnerCrmLeadId`: O parceiro gerencia esse identificador de oportunidades e leads, respectivamente, em seu CRM. Os parceiros devem adicionar esse identificador ao aproveitar novas oportunidades de rastrear atualizações até seu CRM.
Quando uma oportunidade é enviada sem `apnCrmUniqueIdentifier` ou`partnerCrmUniqueIdentifier`, AWS trata-a como uma nova oportunidade e atribui uma nova `apnCrmUniqueIdentifier` para a oportunidade.
Quando uma oportunidade é enviada com um `apnCrmUniqueIdentifier` ou`partnerCrmUniqueIdentifier`, AWS trata-a como uma ação de atualização e atualiza a oportunidade existente com os dados da carga útil.
**P: Como faço para evitar que registros duplicados sejam criados em ambos os sistemas?**
Do lado do CRM do parceiro, deve haver um identificador exclusivo para cada registro enviado ao ACE, que é chamado`partnerCrmUniqueIdentifier`. Da mesma forma, o ACE também mantém um identificador exclusivo para cada registro, que é chamado`apnCrmUniqueIdentifier`. Quando os dados são enviados, tanto a ACE quanto o parceiro precisam incluir esses dois campos, o que ajuda a identificar se o registro é uma nova oportunidade (se estiver em branco) ou existente (se preenchido).
# Perguntas frequentes técnicas — Campos
**P: A integração é compatível com o formato CSV?**
Não. A integração aceita somente formatos de arquivo JSON.
**P: Quando os arquivos precisam ser excluídos das pastas de saída?**
Exclua os arquivos somente depois de processá-los com sucesso.
**P: Se eu excluir acidentalmente os arquivos das pastas de saída, onde posso encontrar os arquivos originais?**
Os arquivos estão disponíveis nas `lead-outbound-archive` pastas `opportunity-outbound-archive` e.
**P: O que eu faço para obter suporte durante o desenvolvimento?**
Para obter ajuda durante o desenvolvimento, entre em contato com o suporte da AWS Partner Network (APN) no Partner Central.
**P: Qual é a diferença entre `opportunityOwnerName` e`opportunityOwnerEmail`?**
+ `opportunityOwnerName`: o nome do proprietário da oportunidade na organização parceira. Ele precisa ser um usuário do Partner Central.
+ `opportunityOwnerEmail`: o e-mail do proprietário da oportunidade na organização parceira. Ele precisa ser um usuário do Partner Central. Se não for fornecida, a oportunidade é criada com o líder da Partner Central Alliance como proprietário.
**P: Qual é o fuso horário de todos os campos de data (`targetCloseDate`,`lastModifiedDate`,`createdDate`, e`acceptBy`)?**
O fuso horário para os campos de data é Greenwich Mean Time (GMT).
**P: Os arquivos JSON de entrada têm versão?**
Não. A Amazon Web Services (AWS) não oferece suporte ao controle de versão dos arquivos. O APN Customer Engagement (ACE) processa o arquivo imediatamente após o recebimento e, em seguida, exclui o arquivo após o processamento bem-sucedido. Se recebermos o mesmo nome de arquivo novamente, ele será rejeitado.
**P: Quais campos no arquivo JSON do Amazon Simple Storage Service (Amazon S3) indicam a criação e a data de atualização mais recente de um determinado lead e oportunidade?**
`createdDate` e `lastModifiedDate`.
**P: Como você determina se uma oportunidade é nova ou existente?**
O campo `PartnerCrmUniqueIdentifier` é um identificador exclusivo de cada oportunidade que solicitamos do parceiro. Esse identificador deve ser definido no CRM de origem do sistema do parceiro. Usamos isso para determinar se existe uma oportunidade em AWS. Se ela existir, atualizamos a oportunidade com as informações compartilhadas. Caso contrário, criamos uma nova oportunidade.
Quando enviamos dados para o parceiro, incluímos `PartnerCrmUniqueIdentifier` `apnCrmUniqueIdentifier` e. Se a oportunidade compartilhada por AWS estiver sendo enviada pela primeira vez, você não verá nenhum valor para`PartnerCrmUniqueIdentifier`. Isso ajuda você a tratar a oportunidade como nova da ACE. Depois de inseri-lo em seu CRM, você envia as atualizações de volta para nós com e. `PartnerCrmUniqueIdentifier` `apnCrmUniqueIdentifier`
**P: É possível ter mais de um arquivo JSON de saída e de resultado no Amazon S3?**
Sim. Às vezes, podemos gerar mais arquivos na pasta de saída. Da mesma forma, se você enviar arquivos para a pasta de entrada, nós os processaremos e manteremos os arquivos de resultados na pasta de resultados. Você deve marcar ou excluir os arquivos de resultados após o processamento.
**P: O arquivo de saída contém mais de um registro?**
Sim. O arquivo de saída pode conter vários registros.
**P: Se 20 oportunidades de entrada forem enviadas em um único arquivo JSON de entrada na seção de oportunidades e uma das oportunidades não estiver em conformidade com o padrão da APN, o que acontece?**
Se o formato estiver incorreto, independentemente do caso, o arquivo inteiro será rejeitado. Se o formato estiver correto, mas somente uma oportunidade não puder ser processada por nós, o arquivo de resultados incluirá todas as 20 oportunidades e seu status, junto com a mensagem de erro da oportunidade fracassada.
**P: Quais são os principais atributos para validar se o arquivo JSON foi processado com sucesso?**
Esses são os principais atributos para ajudar você a entender se o arquivo JSON foi processado com êxito.
```
{
"inboundApiResults": [
{
"warnings": null, // no warnings
"partnerCrmUniqueIdentifier": "XXXX", //uniqueId from Partner side
"isSuccess": true, // file successfully processed
"errors": null, //no errors reported
"apnCrmUniqueIdentifier": "OXXXX" //uniqueId from AWS side
}
]
}
```
**P: O que acontece se eu enviar um JSON inválido?**
Você recebe esta resposta de erro: "não `[{input JSON}]` é do tipo`object`”.
**P: Quantos lead/opportunity registros podem ser incluídos em um único arquivo JSON de entrada?**
No máximo 50 registros podem estar em um arquivo.
# Perguntas frequentes técnicas — Amazon S3
**P: Onde posso obter a documentação da API REST do Amazon Simple Storage Service (Amazon S3)?**
Para obter mais informações, consulte a Introdução à [API REST do Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/API/Welcome.html).
**P: Como faço para obter os detalhes da chave do Amazon Web Services AWS Key Management Service (AWS KMS) para me autenticar e acessar o bucket do Amazon S3?**
AWS Partner Network (APN) compartilha uma política que inclui o nome da chave.
**P: Como faço para autenticar o Amazon S3 a partir do Salesforce.com (SFDC)?**
Use o arquivo de código de amostra [S3\$1Authentication.cls para autenticar o Amazon S3 a partir](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls) do SFDC.
**P: Como faço o upload do arquivo do kit de desenvolvimento de AWS software (SDK) para o S3?**
Use o comando AWS CLI a seguir para carregar o arquivo no S3.
```
aws s3 cp example.json s3://awsexamplebucket/opportunity- inbound/filename.json --acl bucket-owner-full-control
```
O arquivo de código de amostra [Sample\$1 AceOutboundBatch .cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls) contém código para carregar o arquivo de dados do SFDC.
**P: Quem é o proprietário do bucket Amazon S3?**
AWS possui e gerencia o bucket do Amazon S3. Você tem acesso programático ao seu próprio bucket do Amazon S3 com AWS Identity and Access Management o usuário (IAM).
**P: Há pastas ou compartimentos separados para receber e enviar arquivos?**
Há um bucket com pastas diferentes para receber e enviar os arquivos. Consulte o guia do usuário para obter mais detalhes sobre as pastas.
**P: Preciso acessar o bucket do Amazon S3 usando ou posso acessá-lo diretamente usando AWS Lambda o sistema de gerenciamento de relacionamento com o cliente (CRM)?**
Você pode acessá-lo nos dois sentidos.
**P: O bucket do Amazon S3 é protegido ou criptografado?**
Sim. Nós habilitamos o mecanismo de criptografia padrão que o Amazon S3 oferece.
**P: É possível habilitar o Amazon Simple Notification Service (Amazon SNS) para ouvir o bucket do Amazon S3, para que eu possa atuar apenas no evento, em vez de fazer pesquisas periodicamente?**
Não. Atualmente, o APN Customer Engagement (ACE) não oferece suporte a esse recurso.
**P: A quais pastas eu tenho acesso e qual é a finalidade de cada pasta?**
Você pode encontrar a lista de pastas do Amazon S3 em. [Pré-requisitos de integração](crm-integration-setting-up.md)
# Perguntas frequentes técnicas — leads e oportunidades
## Envie e receba leads e oportunidades
**P: Existe uma convenção de nomenclatura de arquivos?**
Cada nome de arquivo precisa ser exclusivo. Recomendamos o nome do arquivo`PartnerProvided FileName+{timestamp}.json`.
**P: Qual é a estrutura dos resultados?**
Os arquivos de amostra dos resultados (sucesso e erro) podem ser baixados dos seguintes locais:
+ [Exemplo de sucesso de resultados de leads. JSON](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results-Success-Sample.json)
+ [Exemplo de sucesso de resultados de oportunidades. JSON](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results-Success-Sample.json)
+ [Lidere resultados com erros Sample.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results_With-Errors-Sample.json)
+ [Resultados de oportunidade com erros Sample.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results_With-Errors-Sample.json)
**P: Qual é a convenção de nomenclatura dos resultados?**
`PartnerProvidedFileName_result.json`
**P: E se eu enviar um segundo arquivo JSON com o mesmo nome?**
Não processaremos o arquivo e ele será movido para a pasta de arquivamento.
**P: Qual é o limite de tamanho do arquivo de entrada?**
O limite de tamanho do arquivo de entrada é de 1 MB.
**P: Há um número máximo de oportunidades e leads que podem ser agrupados em um arquivo JSON?**
Dado o limite de 1 MB, recomendamos que você tenha uma oportunidade ou lead por arquivo.
**P: Estou recebendo uma mensagem de erro de acesso negado, então não consigo carregar os arquivos. O que devo fazer?**
Os parceiros recebem uma mensagem de *acesso negado* por dois motivos.
1. Você carregou o arquivo na `outbound` pasta em vez da `inbound` pasta. Faça o upload do arquivo na `inbound` pasta.
1. Você precisa fornecer uma lista de controle de acesso (ACL). Use o seguinte comando da CLI do Amazon Web Services (AWS) para fazer o upload do arquivo de dados:
```
aws s3 cp example.json s3://awsexamplebucket --acl bucket-owner-full-control
```
**P: O que acontece se arquivos com extensões como`.pdf`,`.docx`, ou qualquer outra extensão `.json` forem carregados?**
Rejeitamos os arquivos e geramos um `*.error.json` arquivo com os detalhes do motivo.
**P: O que eu faço depois de receber uma mensagem de erro de problema de dados na produção?**
1. Se os dados precisarem ser corrigidos no sistema de gerenciamento de relacionamento com o cliente (CRM) do parceiro, depois de corrigir os dados, envie o arquivo revisado para o Amazon Simple Storage Service (Amazon S3).
1. Se algum esclarecimento for necessário sobre os dados, entre em contato com seu gerente de desenvolvimento de parceiros (PDM).
1. Para qualquer outro suporte técnico, apresente um caso de suporte AWS Partner Network (APN) no portal da APN.
**P: Onde posso encontrar os arquivos de resultados e por quanto tempo eles estão disponíveis?**
Os arquivos de resultados estão nas `opportunity-inbound-results` pastas `lead-inbound-results` e. Eles estão disponíveis até que você os exclua. Você pode excluir os arquivos após a extração bem-sucedida.
**P: Se eu precisar encontrar um arquivo de resultados depois de excluí-lo, onde podemos encontrá-lo?**
Você pode encontrar os arquivos de resultados nas `opportunity-inbound-results-archive/YYYY/MM/DD` pastas `lead-inbound-results-archive/YYYY/MM/DD` e.
**P: Se houver alguma falha no processamento do arquivo pela APN, como sou notificado?**
A APN tem alarmes que criam automaticamente tickets Sev2 para rastrear os erros de processamento. Analisamos, resolvemos e comunicamos esses dados aos parceiros.
**P: Quais campos podem ser atualizados após o lançamento da oportunidade?**
Os campos a seguir podem ser atualizados somente pelos parceiros do Accelerate Vendor Independent Software Vendor (ISV):
+ `isThisForMarketplace`
+ `isNetNewBusinessForCompany`
+ `deliveryModel`
+ `awsFieldEngagement`
+ `additionalComments`
**P: Recebi um erro de *Registro não editável*. O que isso significa?**
Quando você envia uma oportunidade indicada a um novo parceiro, ela passa pelo processo de validação e a equipe de Engajamento do Cliente (ACE) da APN deve aprová-la ou rejeitá-la. Embora a oportunidade esteja em análise e ainda não tenha sido validada, você não pode atualizar o registro e você recebe esse erro.
**P: O que acontece se não houver nenhuma atividade do meu lado (exemplo: não estou processando o arquivo ou não estou enviando nenhuma oportunidade de entrada)?**
Se você não enviar nenhuma informação ou não estiver processando os arquivos que fornecemos, atualmente não temos um mecanismo para alertá-lo. Recomendamos que você monitore seu sistema para garantir que as informações estejam fluindo para a APN.
**P: Em quanto tempo os resultados do JSON ficam disponíveis na pasta de resultados após o envio de uma oportunidade/lead de new/updated entrada?**
O processamento é quase em tempo real. Você deve receber os arquivos em menos de cinco minutos.
**P: Se eu enviar um CRM de oportunidades de entrada que não esteja em conformidade com a format/length restrição do padrão da APN, como o sistema lidará com isso? Isso gera o relatório de erros?**
Se o arquivo não estiver no formato de definição de campo, o arquivo resultante do APN chamará o arquivo.
**P: Não tenho um ID de AWS conta no momento do lançamento. O que eu faço?**
De acordo com o processo ACE, `Launched` significa carga de trabalho concluída e cobrança iniciada. Isso requer um ID de AWS conta. Para obter mais informações, consulte o [Programa ACE FAQs](https://partnercentral.awspartner.com/partnercentral2/s/resources?Id=0690h000003xjjXAAQ).
**P: Após o Teste de Aceitação do Usuário (UAT), como os dados históricos devem ser tratados durante a mudança para a produção?**
Por padrão, quando alguma atualização acontece no ACE, enviamos essas oportunidades para o bucket do Amazon S3. Para dados históricos que você não deseja processar, você precisa fornecer valores fictícios, como `X0001, X0002….X000N` na extração, do que você não deseja processar em seu sistema. `partnerCrmUniqueIdentifier` Você precisa escrever um código para reconhecer esses identificadores e processá-los adequadamente. O restante das oportunidades fornece o `partnerCrmUniqueIdentifier` valor correto. Isso garante que você tenha controle total sobre o que processar e o que não processar em seu sistema.
**P: O arquivo de saída contém mais de um registro?**
Sim. O arquivo de saída pode conter mais de um registro.
**P: Por que os dados *enviam Aceitar para visualização* em alguns campos?**
Para uma oportunidade ou lead AWS indicado, todos os campos de PII são mascarados com o rótulo *Aceitar para visualização* até que a oportunidade ou o lead seja aceito por você. Depois de aceito, você recebe todos os campos de dados no próximo ciclo de sincronização.
**P: O que eu faço quando uma nova oportunidade ou lead AWS indicado é sincronizado pela primeira vez?**
Quando uma nova oportunidade ou lead é sincronizado pela primeira vez, você precisa aceitá-lo ou rejeitá-lo para obter dados adicionais (exemplo: contatos do cliente).
## Criação e atualização de oportunidades/leads
**P: Como faço para incluir novas oportunidades *indicadas por parceiros (originadas)* no ACE por meio da integração?**
Para criar novas oportunidades no ACE por meio da integração, você precisa ingerir as informações de oportunidade necessárias no formato JSON definido na `opportunity-inbound` pasta. AWS processa essas informações, cria uma nova oportunidade no ACE e compartilha os resultados de uma operação de successful/failed criação na `opportunity-inbound-processed-results` pasta.
**P: Como a integração diferencia o envio de novas oportunidades e as atualizações?**
O campo `PartnerCrmUniqueIdentifier` em cada oportunidade é um identificador exclusivo obrigatório. Esse identificador deve ser definido no CRM de origem do sistema. AWS usa isso para determinar se já existe uma oportunidade no ACE. Se estiverem disponíveis no ACE, usamos as informações compartilhadas para atualizar a oportunidade, mas se não estiverem disponíveis no ACE, usamos as informações compartilhadas para criar uma nova oportunidade.
**P: Se eu já implementei a funcionalidade de atualização por meio da integração, o que preciso fazer para usar a integração para enviar (criar) novas oportunidades?**
Você precisa fazer as seguintes alterações na integração existente:
1. Comece a ingerir novas oportunidades de criação na `opportunity-inbound` pasta. Forneça atualizações na mesma pasta.
1. Certifique-se de que os campos obrigatórios necessários para criar estejam disponíveis no JSON compartilhado da oportunidade.
1. Verifique se cada nova oportunidade tem uma única `PartnerCrmUniqueIdentifier` que não existe na ACE/Partner Central. Uma prática recomendada importante é mapear e atualizar os dados existentes no ACE para cada um `PartnerCrmUniqueIdentifier` em seu CRM, para que não criemos duplicatas ao recebermos atualizações. Para obter ajuda, entre em contato com a ACE.
**P: Como parte do processo de ativação, como faço para atualizar as oportunidades existentes no ACE com o meu? `PartnerCrmUniqueIdentifier`**
A equipe ACE fornece uma lista de todas as oportunidades abertas para ajudar na preparação para o lançamento da produção. Você deve mapear essas oportunidades existentes no ACE para suas respectivas `PartnerCrmUniqueIdentifier` e devolver o arquivo atualizado ao ACE para integração com AWS o CRM.
Se você optar por sincronizar somente um subconjunto das oportunidades AWS oferecidas, deverá desenvolver uma lógica para ignorar AWS as atualizações de qualquer oportunidade que não queira processar. Essa abordagem também deve ser aplicada a futuras oportunidades, após a integração. Você deve fornecer aos associados `partnerCrmUniqueIdentifier` oportunidades que precisam de alinhamento entre ambas CRMs. Além disso, você deve indicar quais oportunidades você não atualizará (exemplo: marcar oportunidades fechadas como perdidas ou fechadas) para excluí-las das atualizações. É importante que todas as oportunidades abertas/ativas que você AWS compartilha, e que você aceita, recebam uma. `partnerCrmUniqueIdentifier`
**P: Posso atualizar somente campos específicos na oportunidade ou no lead?**
Sim. Você pode fornecer somente os campos que exigem atualizações, junto com os identificadores necessários.
**P: É possível alterar o *ApnCrmUniqueIdentifier***?
Não. Esse identificador permanece constante AWS e identifica de forma exclusiva cada oportunidade.
**P: E se eu fornecer um *partnerCrmUniqueidentificador* incorreto**?
Se você fornecer um identificador incorreto, uma nova oportunidade será criada. Garanta a precisão para evitar a duplicação de dados.
**P: Posso atualizar as oportunidades AWS enviadas?**
Sim. Você pode atualizar as oportunidades AWS enviadas usando o correto`partnerCrmUniqueIdentifier`.
**P: Em quanto tempo posso esperar os resultados das oportunidades enviadas?**
O processamento é quase em tempo real e os resultados geralmente ficam disponíveis em alguns minutos na `opportunity-inbound-processed-results` pasta.
**P: O que devo fazer se houver erros de processamento nas oportunidades enviadas?**
Analise os detalhes dos erros nos arquivos de resultados, resolva os problemas e busque mais assistência da equipe de suporte do ACE.
**P: Posso excluir uma oportunidade por meio da integração?**
Não. A exclusão direta não é suportada. Você pode atualizar uma oportunidade para refletir um status *Fechado*.
**P: O que significa o erro *Registro não editável*?**
Esse erro ocorre se você tentar atualizar uma oportunidade na revisão do ACE. Essas oportunidades não podem ser editadas até serem validadas.
**P: E se eu não enviar atualizações ou novas oportunidades?**
Nenhum dado novo será recebido e processado se você não enviar atualizações ou novas oportunidades por meio da integração.
**P: Por quanto tempo os arquivos de resultados estão disponíveis?**
Os arquivos de resultados estão disponíveis por um período razoável. Você deve recuperá-los e gerenciá-los imediatamente.
# Perguntas frequentes técnicas — controle de versão e compatibilidade com versões anteriores
**P: O que é uma carga útil na troca de dados da Amazon Web Services (AWS)?**
Uma carga útil é uma parte estruturada de dados formatada em JSON, enviada de entrada ou saída. AWS AWS Cada chave nessa estrutura JSON é chamada de *campo*, e cada campo tem um *valor* associado.
**P: Como a versão da carga útil é determinada?**
A versão da carga é especificada no `version` campo da carga em si. As cargas que aderem à definição de campo v13 são consideradas Payload Versão 1.0, enquanto aquelas que seguem o formato definido na definição de campo v14 ou superior são chamadas de Payload Versão 2.0.
**P: O que significa compatibilidade com versões anteriores nesse contexto e como ela é tratada?**
A compatibilidade com versões anteriores garante que as oportunidades existentes não falhem quando campos novos e obrigatórios são introduzidos nas versões mais recentes da carga útil. AWS mantém isso atribuindo automaticamente valores padrão aos campos obrigatórios na nova versão. Você pode notar valores na interface de usuário do AWS Partner Network Customer Engagement (ACE) (APN) que você não forneceu explicitamente por meio da integração do Customer Relationship Management (CRM). Os detalhes e as condições de cada campo são explicados na descrição do campo ou em detalhes adicionais sobre o campo.
**P: A compatibilidade com versões anteriores é um recurso permanente?**
Não. A compatibilidade com versões anteriores é limitada no tempo, projetada para fornecer flexibilidade para você planejar e implementar mudanças futuras. Ele para de funcionar além de uma data limite especificada, que será anunciada no final do ano como parte de um lançamento mais amplo.
**P: O que acontece quando eu começo a enviar cargas com a versão 2.0?**
Depois de enviar uma carga com a versão 2.0, o sistema presume que todas as alterações necessárias foram implementadas e que as validações para a nova versão da carga se aplicam a todas as alterações subsequentes. É essencial que você não implemente recursos parcialmente entre as cargas da versão 1.0 e da versão 2.0.
**P: Posso voltar para a versão 1.0 do payload depois de atualizar para a versão 2.0?**
Não. A transição para a versão 2.0 da carga útil é um processo unidirecional. Depois de atualizar para a versão 2.0, você não poderá voltar para a versão 1.0 da carga.
# Como obter ajuda
Para obter ajuda com a integração do CRM, envie um caso de suporte no AWS Partner Central.
**Para enviar um caso**
1. Faça login na [AWS Partner Central](https://partnercentral.awspartner.com/APNLogin).
1. No menu superior, escolha **Support**, **Contact Support**.
1. Na página [AWS Partner Support](https://partnercentral.awspartner.com/partnercentral2/s/support), escolha **Open New Case**.
1. Na página **Open New Support Case**, escolha **CRM Integration**.
1. Preencha o formulário e escolha **Enviar**.
# AWS Partner Perguntas frequentes sobre o conector CRM
Os tópicos desta seção ajudam a responder perguntas frequentes sobre a integração do AWS Partner CRM e o uso do conector do CRM.
**nota**
As perguntas e respostas neste FAQ pressupõem que você usa o Salesforce. Para obter mais informações sobre como usar o Salesforce, consulte a ajuda do [Salesforce](https://help.salesforce.com/s/).
**Topics**
+ [Perguntas gerais](#general-questions)
+ [Problemas de instalação](#setup-issues)
+ [Problemas de mapeamento](#mapping-issues)
+ [Problemas de sincronização e validação](#synchronization-validation)
## Perguntas gerais
Expanda as seções a seguir para obter mais informações sobre o uso do conector AWS Partner CRM.
### Como faço para começar a usar o conector AWS Partner CRM?
Entre em contato com seu gerente de desenvolvimento de parceiros (PDM) ou com seu AWS ponto de contato. Seu PDM verificará a elegibilidade, ajudará a configurar o usuário do IAM necessário para autenticação e enviará a solicitação internamente para configurar o bucket Amazon S3 necessário para você trocar arquivos. Depois de ter acesso ao bucket do Amazon S3, você pode instalar o conector e configurar a integração seguindo as instruções no guia do usuário.
Se você já tiver uma integração AWS Partner ACE, [instale o conector do Salesforce AppExchange](install-connector.md) e siga as instruções em. [Configurando o conector para um CRM com integração com o Amazon S3](s3-config.md)
### Por que mudar para a versão 3?
A versão 3 fornece atualizações de oportunidades em tempo real e elimina a necessidade de agendamentos. Ele também fornece um conjunto de botões que permitem aos parceiros aceitar ou rejeitar leads e oportunidades, atualizá-los e enviá-los para AWS. Para obter informações sobre a instalação da versão 3, consulte o artigo [Recursos disponíveis](crm-connector-feature-list.md) anterior neste guia.
### Qual é a versão mais recente do conector?
Versão 3.0.0. Você pode encontrá-lo no Salesforce App Exchange.
### Quanto custa configurar o conector do AWS Partner CRM?
O conector AWS Partner CRM está disponível gratuitamente no Salesforce App Exchange. Ele fornece as seguintes opções de integração:
+ Uma integração baseada na API do Partner Central em que as chamadas AWS de serviço são gratuitas.
+ Uma integração baseada no Amazon S3 em que AWS hospeda e arca com os custos de um bucket do Amazon S3.
**nota**
Você só pode usar essa opção se tiver criado um CRM com a integração do Amazon S3 antes de 2024.
A Amazon também EventBridge é gratuita porque os eventos vêm de um AWS serviço. No entanto, você pode incorrer em cobranças adicionais em sua AWS conta se encaminhar os eventos para outros ônibus de eventos do ouvinte principal do evento para processamento adicional.
Para obter mais informações sobre o conector AWS Partner CRM, consulte. [Visão geral do conector CRM](connector-overview.md) Para obter mais informações sobre EventBridge, consulte [O que é a Amazon EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html) no *Guia do EventBridge usuário da Amazon*.
### Quais novos recursos a versão 3 oferece?
Para obter uma lista dos recursos fornecidos pelo conector AWS Partner CRM, consulte[Recursos da API do Partner Central](crm-connector-feature-list.md#partner-central-api-features), anteriormente neste guia.
### Posso acessar programaticamente o bucket do Amazon S3 usado para enviar e receber arquivos?
Sim. Use as `SecretAccessKey` credenciais `AccessKey` e do usuário do IAM da solicitação de integração do [CRM Integration](https://partnercentral.awspartner.com/partnercentral2/s/acecrmintegration).
Lembre-se de que os arquivos não são mais transferidos usando o bucket do Amazon S3 depois que você transfere a integração para a abordagem baseada em API. No entanto, os leads ainda são compartilhados usando a integração baseada em bucket do Amazon S3.
### Eu não mudei para a versão Salesforce Lightning. Ainda posso usar o conector do AWS Partner CRM?
O conector AWS Partner CRM foi projetado para uso com a versão Salesforce Lightning, portanto, a versão 2 pode não funcionar conforme o esperado.
### Posso usar o pacote diretamente nos meus sistemas de produção?
Recomendamos que você instale o pacote em sistemas de produção somente após um teste completo em um ambiente sandbox.
### Quem são os usuários pretendidos do conector de AWS Partner CRM?
AWS Partner O conector CRM foi projetado para as seguintes personas de usuário:
+ Administradores do Salesforce ou administradores de referência que configuraram o conector.
+ Usuários de operações de vendas que selecionam, aceitam e atualizam oportunidades e leads.
### Eu tenho uma integração ACE. Posso ir para o conector?
Sim. AWS Partner Os que têm uma integração existente com o ACE podem ser movidos para o conector. Como o conector usa o mesmo bucket do Amazon S3 no back-end, conclua as seguintes etapas:
1. Desconecte seu aplicativo ou solução personalizada do bucket do Amazon S3.
1. Faça login na AWS conta para configurar a integração. Obtenha ou crie uma chave secreta e uma chave de acesso para o usuário do IAM que está autorizado a acessar o bucket do Amazon S3. O nome do usuário deve seguir este formato:`apn-ace-{partnerName}-AccessUser-prod`. Para obter mais informações, consulte [Gerenciar chaves de acesso para usuários do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html#Using_CreateAccessKey) no *Guia AWS Identity and Access Management do usuário*.
**nota**
Se você não conseguir encontrar a AWS conta, envie uma [solicitação de suporte](https://docs.aws.amazon.com/awssupport/latest/user/case-management.html).
1. Para configurar o conector para apontar para o bucket do Amazon S3, escolha **Configuração**, depois **Credenciais nomeadas** e, em seguida, conexão de API da **APN**.
1. Envie uma [solicitação de suporte](https://docs.aws.amazon.com/awssupport/latest/user/case-management.html) para excluir objetos existentes no bucket do Amazon S3 antes de agendar um trabalho no conector.
**Importante**
Você deve concluir essa etapa antes de concluir a integração e definir um cronograma de sincronização.
1. Se o objeto de destino for diferente do objeto existente, faça um preenchimento de dados para seus leads e oportunidades existentes. Para obter mais informações, consulte o guia de *configuração e preenchimento de produção da* integração com o CRM.
**nota**
Durante a transição de integração, todas as atualizações do usuário ficam em fila na `Outbound` pasta do bucket do Amazon S3. Depois que a integração estiver ativa, os registros de atualização do usuário serão sincronizados.
### O conector de AWS Partner CRM é seguro para uso na minha organização Salesforce?
O aplicativo Salesforce passou por análises internas e da Salesforce de segurança. AWS Os escaneamentos de análise de segurança da Salesforce incluem as seguintes ameaças:
+ Salesforce Object Query Language (SOQL) e injeção de SQL
+ Scripting entre sites
+ Protocolos de autenticação e controle de acesso não seguros
+ Violações de compartilhamento de registros e outras vulnerabilidades específicas da plataforma Salesforce
A revisão do código usa o [Salesforce Code Analyzer para inspecionar o código do](https://forcedotcom.github.io/sfdx-scanner/) Salesforce. O Salesforce Code Analyzer usa vários mecanismos de análise de código, incluindo PMD e RetireJS. ESLint Ele identifica vários problemas em potencial, desde nomes inconsistentes até vulnerabilidades de segurança.
Para obter mais informações sobre o processo de revisão, consulte [Análise de AppExchange segurança](https://developer.salesforce.com/docs/atlas.en-us.packagingGuide.meta/packagingGuide/security_review_overview.htm) na documentação do Salesforce.
**nota**
Os aplicativos de parceiros não são da Salesforce.com, conforme definido no Contrato de Serviços Principais da Salesforce. Para obter mais informações, consulte os [Acordos e](https://www.salesforce.com/company/legal/agreements/) Termos da Salesforce.
Não obstante quaisquer requisitos de segurança estabelecidos neste documento ou qualquer análise de segurança de um aplicativo de parceiro que possa ocorrer, a Salesforce não garante a qualidade ou a segurança de qualquer aplicativo parceiro, e os clientes são os únicos responsáveis por avaliar a qualidade, a segurança e a funcionalidade dos aplicativos parceiros para determinar sua adequação e adequação à instalação e uso dos clientes.
Embora não possamos compartilhar especificamente o que nossa auditoria interna de segurança abrange, ela é voltada para os AWS componentes nativos da arquitetura de integração, aos quais o aplicativo Salesforce se conecta e abrange vários cenários diferentes de modelagem de ameaças, como man-in-the-middle ataques, denial-of-service mitigações distribuídas e padrões de criptografia. Para obter mais informações, envie uma solicitação de suporte.
## Problemas de instalação
Expanda as seções a seguir para obter informações sobre como corrigir problemas de configuração com o conector do AWS Partner CRM.
### Quais são os pré-requisitos para usar o conector CRM? AWS Partner
Para obter informações sobre os pré-requisitos para usar o conector do CRM, consulte o [Pré-requisitos de integração](crm-integration-setting-up.md) anterior neste guia.
### Como faço para configurar as credenciais nomeadas para o pacote?
Siga estas etapas listadas [Configurando credenciais nomeadas](guided-setup-apis.md#api-named-credentials) posteriormente neste guia.
### Quais são as implicações da mudança da versão 2 para a versão 3? Há alguma alteração significativa?
A mudança da versão 2 para a versão 3 do conector AWS Partner CRM não tem implicações imediatas. Toda a funcionalidade é compatível com versões anteriores e funciona sem interrupções.
Para o gerenciamento de oportunidades, se você planeja usar os novos recursos, talvez seja necessário alterar alguns de seus processos de vendas. Você deve avaliar as seguintes alterações e criar um plano de transição.
+ A versão 3 compartilha oportunidades AWS em tempo real. Você não precisa mais criar agendas para enviar oportunidades para o. AWS Os proprietários de oportunidades na instância do Salesforce de um parceiro devem enviar dados manualmente para o. AWS Os usuários do Salesforce precisam de permissões para promover oportunidades para. AWS
+ Se você planeja usar o mapeamento de vários objetos, precisa de um plano de transição para obter e publicar dados de novos objetos na sua instância do Salesforce. Como administrador do Salesforce, você deve estar ciente das consequências de mudar do mapeamento de objetos com todos os campos mapeados em um único objeto versus campos de um objeto diferente mapeados para um único objeto.
### Ao migrar de uma conexão Amazon S3 (assíncrona) para uma conexão baseada em API (síncrona), existem etapas adicionais de configuração?
Sim. Você *deve* preencher os seguintes itens:
+ Nos pré-requisitos gerais,. [Vinculando sua Central de Parceiros da AWS e AWS Marketplace suas contas](link-pc-mkt-accounts.md)
+ Crie credenciais nomeadas para o novo Partner Central APIs. Para obter mais informações, consulte [Configurando credenciais nomeadas](guided-setup-apis.md#api-named-credentials) anteriormente neste guia.
### Não migramos para a versão Salesforce Lightning. Ainda podemos usar o conector AWS Partner CRM?
Não. O conector foi projetado para ser usado com a versão Salesforce Lightning, e o aplicativo pode não funcionar conforme o esperado sem ele.
### Estamos atingindo o limite de trabalhos agendados em nosso ambiente Salesforce. Podemos usar agendadores externos para acionar a sincronização? AWS
É NECESSÁRIO VALIDAR - O AWS Partner CRM Connector é um pacote gerenciado. Você pode criar uma invocação de agendamento personalizada com aplicativos de terceiros nas classes apex `InboundSyncScheduler` e `OutboundSyncScheduler` apex. Observação: com a nova integração baseada em API, essas classes podem não funcionar.
## Problemas de mapeamento
Expanda as seções a seguir conforme necessário para obter informações sobre como corrigir problemas de mapeamento de objetos com o conector AWS Partner CRM.
### Como funciona o mapeamento de vários objetos?
Para a versão 3, os parceiros podem selecionar os campos dos objetos referenciados um nível abaixo durante o mapeamento. Por exemplo, se seu objeto de oportunidade padrão do Salesforce tiver uma referência interna apontando para um objeto de conta e um objeto de AWS vendas personalizado, você poderá selecionar a oportunidade padrão como objeto principal e mapear campos da conta e dos objetos de vendas.
### Posso selecionar mais de um objeto na guia de mapeamento?
Não. Em vez disso, você mapeia vários campos de um objeto selecionado.
### Como o conector rastreia os objetos que usa para organizar dados?
A versão 3 usa o `APNCrmUniqueIdentifier` campo para referenciar um único objeto pai para mapeamento. O campo contém a ID do AWS registro. Depois de consultar o objeto pai, os valores de todos os outros objetos relacionados são agrupados ou desempacotados com base no link de referência do objeto pai.
### Onde posso encontrar o campo de tipos para um campo específico?
A versão 3 do conector funciona no modelo de dados da versão 2. Para obter informações completas sobre a carga útil, consulte os [exemplos de integração do AWS Partner CRM](https://github.com/aws-samples/partner-crm-integration-samples) em. GitHub
### O pacote gerenciado ajuda a configurar regras de validação no meu objeto padrão do Salesforce?
Não. O pacote vem com o objeto de oportunidade personalizado ACE, que inclui os tipos de campo e as regras de validação que são executados na [carga útil ACE padrão](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Outbound-Sample.json). Você pode copiar as regras e os campos de validação de um objeto de oportunidade personalizado ACE em seu objeto padrão. *NEED TO VALIDATE* - Com o mapeamento de vários objetos, você pode tentar adicionar uma referência a um objeto de oportunidade ACE dentro do seu objeto de oportunidade padrão e, em seguida, copiar os dados nesses campos usando gatilhos para iniciar as validações.
### Por que não consigo editar o mapeamento do AWS campo Sincronizar com?
A AWS caixa de seleção **Sincronizar com** determina se um lead ou oportunidade é sincronizado com a AWS execução do próximo trabalho agendado. O campo **Sincronizar com o Partner Central** está incluído no aplicativo para oportunidades e leads padrão. Se o objeto de destino for um objeto personalizado, você deverá mapear o campo **Sincronizar com** para um AWS campo booleano personalizado que não seja de fórmula em cada objeto.
### Como funciona o Has Updates for AWS Field?
O campo **Tem atualizações para** a AWS fórmula determina se um registro será enviado AWS Partner no próximo trabalho agendado. **Has Updates for AWS** é definido como **True** quando as seguintes condições forem verdadeiras:
+ A **data da última modificação** do registro é posterior à **data da última sincronização do APN**.
+ O **último usuário modificado** não é o usuário que agendou os trabalhos de integração.
### Por que não consigo mapear o campo obrigatório do Identificador Exclusivo do APN CRM? O menu não está disponível e eu recebo a mensagem “Nenhum campo válido para mapear”
Você deve usar o tipo de dados de **texto** com 18 caracteres para corresponder ao tamanho do campo da **API**.
+ Configuração: Texto (18) (ID externa) (Exclusivo sem distinção entre maiúsculas e minúsculas)
### Quais são os pontos de verificação de solução de problemas do aplicativo conector para envio de arquivos de saída do Salesforce para? AWS Partner
O aplicativo usa os seguintes pontos de verificação:
+ A opção **Sincronizar** com AWS deve ser marcada para sincronizar com AWS.
+ **A opção Atualizar AWS** deve ser verificada para sincronizar com AWS.
+ A persona do usuário para criar o trabalho de agendamento deve ser diferente da persona do usuário usada para criar e atualizar leads ou oportunidades.
+ Se as verificações anteriores forem verdadeiras, mas o lote de saída ainda não for executado, verifique os registros de AWS Partner sincronização e adicione a coluna de **saída IDs**. Confirme se o registro de sincronização contém a ID da oportunidade que você deseja enviar. Se o registro de sincronização estiver preso no estado de **sucesso da API**, exclua o registro do registro de sincronização e tente novamente.
Quando a ** AWS receita mensal esperada** não é um número inteiro, como `1041.67` em vez de`1041`, a incompatibilidade no tipo de dados causa um erro de processamento. Para resolver isso, exclua o registro de sincronização preso no estado **API Success** e corrija os dados antes da próxima execução do trabalho.
### Posso configurar filtros e assinaturas para sincronizar leads e oportunidades? Podemos adicionar filtros personalizados nos campos de status ou estágio?
No Salesforce, você pode criar ou atualizar o campo de fórmula para adicionar a dependência dos campos de status ou estágio para um valor específico. Por exemplo, você pode definir **Has Updates for AWS** como **True**. Você pode usar o campo incluído na oportunidade como referência. O exemplo a seguir mostra como:
```
IF(
OR(
AND
(
OR(LastModifiedDate > awsapn_Last_APN_Sync_Date_c,LastModifiedDate = awsapn_Last_APN_Sync_Date_c),
awsapn_Sync_with_Partner_Central_c,
NOT(ISNULL(awsapn_Last_APN_Sync_Date_c))
),
AND(ISNULL(awsapn_Last_APN_Sync_Date_c),awsapn_Sync_with_Partner_Central_c)
)
, true , false
)
```
### Preciso mapear os campos obrigatórios?
Sim. Você deve mapear todos os campos obrigatórios para agendar um trabalho de integração de entrada ou saída.
### Posso mapear campos de pesquisa?
Recomendamos revisar os campos que você insere atualmente no Partner Central para determinar os campos mais relevantes (além dos campos obrigatórios). Para obter uma lista dos campos disponíveis e suas finalidades, consulte o *Guia de definição de campos* incluído no [kit de desenvolvimento do ACE CRM](https://partnercentral.awspartner.com/partnercentral2/s/resources?Id=0698a00000D11JsAAJ) no Partner Central.
### Devo atualizar o registro com campos derivados ou criá-los durante o processo de mapeamento?
Lógica e derivações complexas devem ser feitas em sua organização do Salesforce com base em sua própria lógica de negócios e, em seguida, preencher o campo mapeado com base nela.
## Problemas de sincronização e validação
Expanda as seções a seguir conforme necessário para obter informações sobre como corrigir problemas de sincronização e validação com o conector do AWS Partner CRM.
### O que causa o erro STORAGE\$1LIMIT\$1EXCEEDED?
Esse problema ocorre quando você testa o conector em uma organização de desenvolvimento com armazenamento limitado. Para corrigir isso, limpe os registros de sincronização do console executando a seguinte consulta:
`Listawsapn_Sync_Log_c syncLogs = [SELECT Id FROM awsapn_Sync_Log_c WHERE Status IN ('API Success', 'Processed') LIMIT 4000]; delete syncLogs;`
Você também pode definir o período de retenção do registro de sincronização para limpar automaticamente os registros do registro de sincronização anteriores ao período de retenção. Para obter mais informações sobre como definir o período de retenção, consulte
### AWS leads ou oportunidades indicados não estão em conformidade com a validação imposta ao meu objeto personalizado. Como posso corrigir esse problema?
Alguns leads e oportunidades AWS originadas não estão em conformidade com as regras de validação de cada campo. Para permitir que os parceiros aceitem ou rejeitem essas referências, você pode corrigir os dados antes de aceitar um registro. Para aceitar ou rejeitar um objeto que não esteja em conformidade com as validações de dados, conclua as seguintes etapas:
1. Navegue até os detalhes do log de sincronização do registro com falha.
1. Escolha **Editar carga** para acessar a visualização JSON.
1. Atualize os valores dos campos não compatíveis.
1. Escolha **Salvar carga** para configurar o registro para sincronização para o próximo trabalho.
Se o registro for aceito, você deverá repetir as etapas de 1 a 4 novamente depois de receber os campos restantes do. AWS Para sincronizações subsequentes, os valores corrigidos são usados. Como alternativa, você pode corrigir os valores no gerenciador de pipeline ACE no Partner Central.
### Com que frequência faz AWS upload de leads e oportunidades?
AWS carrega leads e oportunidades para o bucket do Amazon S3 a cada hora. Como resultado, as ações que exigem uma atualização de dados por meio da integração podem levar até uma hora para serem sincronizadas.
### Por que recebo uma mensagem de setFieldLength aviso ao usar a tela de mapeamento?
O aviso a seguir aparece quando um usuário que está realizando o mapeamento de objetos não tem acesso de leitura aos campos obrigatórios:
```
pe.setFieldLengthWarning()@ -
/modules/awsapn/fieldMappingRow.js:1:7831
set salesforceFields()@- /modules/awsapn/fieldMappingRow.js:1:5624
```
Você deve usar um usuário administrador do sistema com permissões para os campos de origem e destino ou um usuário com o [conjunto de permissões de integração do APN](crm-connector-pemissions-sets.md#integration-user).
### O que significam os campos Status e Propósito no registro de sincronização?
Para determinar o estado e a ação em cada registro do log de sincronização, consulte as tabelas em[Registros de sincronização](crm-connector-sync-logs-and-reports.md#sync-logs).
### Vocês fornecem auditoria ou arquivamento?
O objeto de registro de sincronização rastreia todas as transações de entrada e saída. Você também pode especificar um período de retenção para registros de log na configuração do aplicativo.
### Por que recebo uma exceção de limitação?
O Partner Central APIs tem um [conjunto de cotas](https://docs.aws.amazon.com/partner-central/latest/APIReference/quotas.html#understanding-and-managing-quotas) que garantem o uso justo e evitam o uso indevido do serviço. Você pode ver a exceção de limitação quando a limitação de taxa entrar em ação depois de atingir uma cota. As cotas diárias são redefinidas em um ciclo contínuo de 24 horas. Se as cotas padrão não atenderem aos seus requisitos, você poderá usar a página [Service Quotas](https://console.aws.amazon.com/servicequotas/home?region=us-east-1#!/dashboard) para solicitar um aumento de cota.
### Não vejo o AWS botão Enviar para na minha oportunidade padrão
O AWS botão **Enviar para** aparece somente para o tipo de oportunidade **de indicação de parceiro**.
# Notas da versão
Esta seção contém o histórico de lançamento do conector AWS Partner Customer Relationship Management (CRM) para Salesforce.
**Topics**
+ [Versão 3.16 (26 de fevereiro de 2026)](#3.16)
+ [Versão 3.15 (6 de fevereiro de 2026)](#3.15)
+ [Versão 3.14 (17 de dezembro de 2025)](#3.14)
+ [Versão 3.13 (30 de outubro de 2025)](#3.13)
+ [Versão 3.12 (16 de setembro de 2025)](#3.12)
+ [Versão 3.11 (10 de setembro de 2025)](#3.11)
+ [Versão 3.10 (6 de agosto de 2025)](#3.10)
+ [Versão 3.8 (17 de abril de 2025)](#3.8)
+ [Versão 3.6 (18 de março de 2025)](#3.6)
+ [Versão 3.5 (22 de janeiro de 2025)](#3.5)
+ [Versão 3.1 (2 de dezembro de 2024)](#3.1)
+ [Versão 3.0 (14 de novembro de 2024)](#version-3.0-november-14-2024)
+ [Versão 2.2 (24 de abril de 2024)](#2.2)
+ [Versão 2.1 (18 de abril de 2024)](#2.1)
+ [Versão 2.0 (29 de novembro de 2023)](#2.0)
+ [Versão 1.7 (12 de outubro de 2022)](#1.7)
+ [Versão 1.6 (13 de janeiro de 2023)](#1.6)
+ [Versão 1.5 (13 de janeiro de 2023)](#1.5)
+ [Versão 1.4 (7 de dezembro de 2022)](#1.4)
## Versão 3.16 (26 de fevereiro de 2026)
AWS A versão 3.16 do Partner CRM Connector contém os seguintes recursos e aprimoramentos.
### Correções de bugs
+ Corrigido um problema em que os campos de solução não persistiam durante a criação da oportunidade. Na versão 3.15, quando os parceiros criavam oportunidades com campos de solução preenchidos, as soluções não estavam sendo associadas à oportunidade na Central de Parceiros da AWS. O conector agora conecta adequadamente as chamadas CreateOpportunity e a AssociateOpportunity API para garantir que as soluções sejam associadas corretamente durante a criação da oportunidade.
+ Corrigida uma lacuna de permissão em que o campo **Oportunidade de origem** não tinha permissões de edição no conjunto de permissões do **APN Business Admin**. Esse campo, adicionado na versão 3.10 para o`Unified Standard-ACE Opportunity Sync Flow`, agora tem acesso adequado de leitura e edição, permitindo que os administradores de negócios usem automações que criam registros de oportunidade ACE a partir de registros de oportunidade padrão
+ Corrigido um problema em que o código postal era aplicado incorretamente como um campo obrigatório em todos os países, incluindo aqueles sem sistemas de código postal (como Emirados Árabes Unidos, Hong Kong e Bonaire). O campo de código postal agora é opcional, alinhando-se à especificação da API do AWS Partner Central e permitindo que os parceiros criem oportunidades para clientes em países que não usam códigos postais
## Versão 3.15 (6 de fevereiro de 2026)
AWS A versão 3.15 do Partner CRM Connector contém os seguintes recursos e aprimoramentos.
### API da Central de Parceiros da AWS
**Aprimoramento automático do compartilhamento de AWS dados**
+ Sincronização automática de registros aprimorada AWS para trabalhar perfeitamente na criação e nas atualizações de oportunidades
+ Elimina a necessidade do `Sync ACE Opportunity to Partner Central API` fluxo para compartilhamento de dados
**Atualize a partir dos recursos AWS **
+ Capacidade adicional de atualizar dados de oportunidades diretamente da Central de Parceiros da AWS sem a necessidade de eventos
+ Permite que os parceiros obtenham as atualizações mais recentes da Central de Parceiros da AWS sob demanda por meio de um botão no layout da página **ACE Opportunity**
+ Garante a consistência dos dados entre a Salesforce e a Central de Parceiros da AWS
### Correções de bugs
+ Corrigido um problema em que oportunidades com “Outras” especificadas no campo **Setor** não eram incluídas na carga útil da API durante a sincronização com o AWS Partner Central, fazendo com que as oportunidades permanecessem bloqueadas no status de rascunho
+ Corrigido um problema de formatação de notação científica nos campos de moeda e receita que estava causando falhas na validação da API para grandes valores monetários
## Versão 3.14 (17 de dezembro de 2025)
AWS A versão 3.14 do Partner CRM Connector contém os seguintes recursos e aprimoramentos.
### API da Central de Parceiros da AWS
**Preenchimento de dados de oportunidades**
+ Foi adicionado um recurso de **preenchimento** dedicado que permite que os parceiros iniciem a sincronização de dados diretamente da interface do conector para todas as oportunidades existentes, da Central de Parceiros da AWS à Salesforce
+ Implementou critérios definidos pelo usuário para seleção de oportunidades com base em estágios e outras opções de filtragem
**Aprimoramento da associação de oportunidades**
+ Consolidou a abordagem de quatro campos em três campos claros e pesquisáveis com comportamento consistente
+ **Implementou campos suspensos pesquisáveis com funcionalidade de digitação antecipada para soluções**,** produtos da AWS **e oferta do AWS Marketplace****
+ Campo de **produtos da AWS** aprimorado para exibir nomes amigáveis (por exemplo, “AWS Amplify”), mantendo os identificadores de API corretos
**Atribuição do proprietário da oportunidade na criação**
+ Foi adicionado suporte para definir o proprietário da oportunidade durante a criação da oportunidade por meio da CreateOpportunity API
+ Implementou o mapeamento adequado dos OpportunityTeam membros com BusinessTitle “OpportunityOwner”
### Correções de bugs
+ Problema de validação corrigido na validação de OpportunityTeamMember e-mail para compartilhar a carga útil com a AWS somente quando o nome, sobrenome ou número de telefone são fornecidos
+ Lógica de campo de Segurança Nacional atualizada para compartilhar corretamente os valores da lista de opções selecionada
+ Dicas de ferramentas atualizadas para os campos do Partner Account Manager
## Versão 3.13 (30 de outubro de 2025)
AWS A versão 3.13 do Partner CRM Connector contém os seguintes recursos e aprimoramentos.
### API da Central de Parceiros da AWS
**Aceite e atribua oportunidades em massa**
+ Capacidade adicional de **aceitar** ou **atribuir** várias oportunidades ACE simultaneamente, melhorando a eficiência no gerenciamento de oportunidades
**Registros de sincronização de oportunidades**
+ Os usuários da integração da API do AWS Partner Central agora podem visualizar os registros de sincronização correspondentes diretamente no objeto ACE Opportunity. Esse recurso fornece visibilidade do processo de sincronização para cada oportunidade
### Correções de bugs
+ Resolveu um problema em que o campo do número DUNS do cliente (`customerDuns`) foi rejeitado durante o envio da oportunidade devido à incompatibilidade de tipos de dados
+ Aumentou o tamanho do campo de mensagem de erro (`awsapn__Error_Message__c`) de 32 KB para 128 KB nos detalhes do registro de sincronização para evitar o truncamento das mensagens de erro e evitar a interrupção do processamento de trabalhos do Apex durante erros de sincronização de alto volume
+ Corrigido um problema em que as oportunidades apareciam como enviadas, mas permaneciam bloqueadas no status de rascunho quando códigos postais ou CEPs estavam em formato inválido. O conector agora apresenta erros de validação de API assíncronos, permitindo que os parceiros corrijam a formatação do código postal ou do CEP antes de enviarem para a AWS
+ Resolveu um problema em que oportunidades com “Outras” especificadas no campo Oferta de solução permaneciam bloqueadas no status Rascunho em vez de progredirem para Enviado. O conector agora manipula adequadamente os valores de “Outros” da solução e analisa corretamente as respostas da API para permitir a progressão de oportunidades por meio do processo de validação do ACE. Agora, os parceiros também podem associar soluções válidas mesmo quando têm “Outro” no campo de descrição da outra solução
## Versão 3.12 (16 de setembro de 2025)
AWS A versão 3.12 do Partner CRM Connector contém os seguintes recursos e aprimoramentos.
### Correções de bugs
+ Defina o modelo de `Unified_Standard_ACE_Sync` fluxo para estar em um estado de **rascunho** em vez de um estado ativo. Alguns clientes estavam enfrentando erros de instalação com o modelo de fluxo em um estado ativo.
## Versão 3.11 (10 de setembro de 2025)
AWS A versão 3.11 do Partner CRM Connector contém os seguintes recursos e aprimoramentos.
### API da Central de Parceiros da AWS
**Registro em log aprimorado**
+ Recursos de registro detalhados expandidos para processos de integração de API e sincronização de oportunidades da AWS Partner Central
+ Foram adicionadas informações adicionais de solução de problemas para processos de sincronização de oportunidades
### Correções de bugs
+ Corrigido um problema que impedia a dissociação solutions/offers/services do campo Solução oferecida
+ Aumento do número máximo de listagens de soluções que podem ser sincronizadas a partir da Central de Parceiros da AWS de 50 para 100
+ Problemas de visibilidade corrigidos para soluções nas ofertas de soluções quando as soluções estavam em um estado de “exclusão”
+ Resolveu um problema que fazia com que oportunidades duplicadas aparecessem no Salesforce quando alterações eram feitas na Central de Parceiros da AWS
+ Exibição fixa de nomes completos nos campos AWS Partner Success Manager e AWS ISV Success Manager no objeto ACE
## Versão 3.10 (6 de agosto de 2025)
AWS Partner A versão 3.10 do Conector CRM contém os seguintes recursos e aprimoramentos.
### API da Central de Parceiros da AWS
**Compartilhamento automático AWS de dados**
+ Nova configuração **Ativar compartilhamento com AWS integração** nas configurações personalizadas do AWS Partner Central
+ Sincronização automática de registros AWS quando ocorrem atualizações
+ Elimina a necessidade de **compartilhamento manual com** cliques em AWS botões
+ Fluxo de dados contínuo para atualizações AWS registradas
**Associação simplificada de entidades**
+ Funcionalidade integrada para associar ofertas e produtos em seus respectivos campos sem precisar clicar em **Associar ou **Desassociar****
+ Tratamento automático de chamadas da API de back-end com base na seleção
**Gerenciamento simplificado de convites**
+ Aceitar/rejeitar convites diretamente do menu suspenso do campo de status de aceitação do **parceiro**
+ Tratamento automático de chamadas da API de back-end com base na seleção
**Melhorias na automação - Novo modelo de fluxo Unified Standard-ACE Opportunity Sync**
+ Permite a sincronização automatizada entre oportunidades padrão do Salesforce e oportunidades ACE
+ Oferece suporte ao compartilhamento de oportunidades de venda conjunta ao usar o conector CRM
+ Inclui mapeamentos de campo pré-configurados para campos de oportunidade padrão
+ Lida com a criação e as atualizações de oportunidades ACE
+ Apresenta state/country mapeamento automático e tratamento de valores padrão
## Versão 3.8 (17 de abril de 2025)
AWS A versão 3.8 do Partner CRM Connector contém os seguintes recursos e aprimoramentos.
### Correções de bugs
+ Corrigido um problema em que o **ID do APN CRM** não estava sendo atualizado na oportunidade após a sincronização.
+ Foi corrigido um problema ao tentar atualizar produtos do Marketplace em que um vendedor tinha mais de 50 produtos listados.
+ Corrigido um problema em que os campos Representante de AWS Vendas e Gerente de AWS Contas no objeto ACE não exibiam o nome completo.
## Versão 3.6 (18 de março de 2025)
AWS A versão 3.6 do Partner CRM Connector contém os seguintes recursos e aprimoramentos.
### AWS Marketplace
+ Foi adicionado suporte para 8 casas decimais (aumento de 3) nos pay-as-you-go preços de produtos de software como serviço (SaaS), o que se alinha aos AWS Marketplace padrões de preços.
### Correções de bugs
+ Agora, os parceiros podem criar oportunidades diretamente no Partner Central. Essas oportunidades são sincronizadas automaticamente com a organização Salesforce do parceiro por meio do conector de AWS Partner CRM. Isso melhora o processo de indicação e aprimora as colaborações entre parceiros e. AWS
+ Corrigido um problema em que uma sincronização de oportunidades falhava `NUMBER_VALUE` e não podia ser convertida em uma string quando os campos do programa de reconhecimento de receita SaaS (SRRP) eram atualizados.
+ Foi resolvido o problema de compartilhamento de dados para evitar que AWS as referências fossem processadas incorretamente como oportunidades de parceria durante a sincronização da APN.
+ O `ReviewStatus` campo foi corrigido de ser alterado para nulo em uma oportunidade aprovada após a atualização de um campo permitido.
+ Implementou um novo mapeamento de campo `Next Step History` para acomodar volumes maiores de dados e evitar falhas de sincronização.
+ Resolveu problemas de fluxo de ativação de oportunidades ACE implementando a lógica de atualização adequada para o `APN CRM Unique Identifier` campo em um registro de oportunidade ACE.
+ Instruções de configuração guiada atualizadas e corrigidas para uma melhor experiência do usuário.
**nota**
Se você atualizar para a versão 3.6, deverá mapear o `Next Step History` campo na guia **Mapeamentos ACE**.
## Versão 3.5 (22 de janeiro de 2025)
AWS A versão 3.5 do Partner CRM Connector contém os seguintes recursos e aprimoramentos.
### API da Central de Parceiros da AWS
+ Agora você pode ativar o catálogo de sandbox usando a caixa de seleção **PC API Sandbox Enabled** em **Configurações personalizadas, Configurações do conector AWS Partner ** **CRM**.
+ Catálogo de produtos atualizado.
### AWS Marketplace
+ Agora você pode importar detalhes das autorizações de revenda criadas fora do conector do CRM.
+ Foi adicionado suporte para visualizar até 8 pontos decimais, quando aplicável.
### Correções de bugs
+ Problema corrigido com uma nova instalação do conector CRM versão 3.1, sincronize o relatório de falhas com a mensagem `Field Level Security error on field: awspn_Campaign name_new_c` de erro.
+ Foi corrigido o problema com nomes de produtos duplicados do AWS Markeplace que causavam falhas no upsert.
+ Foi corrigido o problema que impedia que a guia de **oportunidades ACE** fosse definida como a visualização padrão para os conjuntos de permissões ACE.
## Versão 3.1 (2 de dezembro de 2024)
AWS A versão 3.1 do Partner CRM Connector contém os seguintes recursos e aprimoramentos.
### Correções de bugs
+ Corrigido o URL de produção da API do AWS Partner Central.
+ Problemas corrigidos com a alteração na carga útil do convite de engajamento.
## Versão 3.0 (14 de novembro de 2024)
AWS O Partner CRM Connector 3.0 contém os seguintes recursos e aprimoramentos:
### Atributos principais
**Mapeamento de vários objetos**
+ Agora, os parceiros podem mapear campos de vários objetos do Salesforce, incluindo relacionamentos de pesquisa e detalhes principais, para os esquemas de oportunidades e leads da APN.
+ UI aprimorada para mapear campos, incluindo visualizações expansíveis para campos de pesquisa.
+ Support para até dois níveis de relacionamentos de objetos em um único mapeamento.
### Recursos de integração do ACE CRM
**AWS Partner Central API Support**
+ O usuário de integração ACE não é necessário para integrações do AWS Partner Central
+ Os agendamentos de sincronização de entrada e saída entre a Salesforce e a AWS Partner Network (APN) não são mais necessários.
+ O conector do AWS Partner CRM lida com erros síncronos.
**AWS Suporte da API do Partner Central para oportunidades AWS originadas (AO) e oportunidades originadas por parceiros**
+ Os parceiros podem usar o AWS botão **Compartilhar com** para criar e atualizar oportunidades.
+ Os parceiros podem usar o botão **Status de aprovação** para aceitar ou rejeitar as oportunidades AWS indicadas.
+ Os parceiros podem usar os botões **Associar ou Desassociar** para associar ou desassociar oportunidades a soluções, AWS produtos e ofertas do AWS Marketplace de parceiros em todo o ciclo de vida da oportunidade.
+ Os parceiros podem usar o botão **Atribuir** para reatribuir oportunidades a outros usuários em sua conta do Partner Central.
+ Os parceiros podem usar a guia **Oferta de soluções** para ver uma lista das soluções disponíveis.
+ Os parceiros podem ver os eventos na guia **Notificação do AWS Marketplace**, como **Oportunidade criada**, **Oportunidade atualizada** ou **Convite de engajamento criado**.
+ Três novos campos adicionados para oportunidades:
+ `Opportunity Engagement Invitation ARN`
+ `Opportunity Type`
+ `Visibility`
### Correções de bugs
+ Corrigido um problema em que o conector, ao receber dados de entrada, substituía a conta associada às oportunidades por uma conta padrão fornecida nas configurações personalizadas, causando conflitos internos do Salesforce e erros de validação
+ Corrigido um problema em que o conector encontrava erros nos registros de sincronização de entrada e saída devido a um valor de `SalesActivity` campo inválido de. `Finalized Deployment Needs`
+ Corrigido um problema ao tentar atualizar as autorizações de revenda compartilhadas.
## Versão 2.2 (24 de abril de 2024)
AWS A versão 2.2 do conector Partner CRM contém os seguintes recursos e aprimoramentos.
### Atributos principais
Aprimoramentos no recurso de autorização de revenda existente para oferecer suporte a produtos não legados.
## Versão 2.1 (18 de abril de 2024)
AWS A versão 2.1 do conector Partner CRM contém os seguintes recursos e aprimoramentos.
### Atributos principais
Os parceiros de canal podem criar um cronograma de sincronização para autorizações de revenda compartilhadas.
### AWS Marketplace integração para vendedores ISV e parceiros de canal
+ Você pode modificar a duração do uso das ofertas lançadas para produtos qualificados.
+ Support for future dated agreements (FDA) para ofertas privadas.
+ Você pode importar detalhes de ofertas privadas criadas fora do conector do CRM.
+ Você pode salvar ofertas privadas e autorizações de revenda como rascunhos.
+ Você pode recuperar e visualizar contratos de ofertas privadas e públicas.
+ Você pode criar ofertas baseadas em contratos em várias contas de vendedor para produtos de contrato de SaaS e produtos de contrato de SaaS com contas de consumo.
### Integração com ACE CRM
+ Formulário de registro aprimorado do Salesforce Lightning para objetos de oportunidade ACE AWS entregues.
+ Você pode sincronizar registros detalhados do log por oportunidade nos objetos de oportunidade ACE AWS entregues.
+ Você pode vincular as ofertas privadas disponíveis do AWS Marketplace a uma oportunidade no objeto de oportunidade ACE AWS entregue.
## Versão 2.0 (29 de novembro de 2023)
### Atributos principais
+ Aplicativo modularizado — aplicativo SF AppExchange único para os recursos de integração do ACE CRM e do Marketplace Seller AWS
### Integração do APN Customer Engagement (ACE)
+ Support para novo modelo de dados (v14) com a integração ACE CRM.
+ Cria objetos personalizados para oportunidades e leads do ACE que contêm tudo o que é attributes/values definido pela integração do ACE CRM com novas validações do modelo de dados nos objetos de oportunidade personalizados.
+ Capacidade de mapeamento automático com um clique para novos objetos personalizados ACE para agilizar o mapeamento com objetos personalizados instalados para oportunidades e leads.
+ Correção para mapear atributos ausentes em oportunidades.
+ Correção para associar AWS oportunidades a uma conta se estiver usando uma oportunidade padrão para mapeamento.
### AWS Integração com o Marketplace
+ Como vendedor de ISV:
+ Sincronize os produtos MP disponíveis na organização Salesforce.
+ Crie, visualize e gerencie ofertas privadas de ISV em produtos SaaS, AMI e contêiner.
+ Cancele e modifique ofertas privadas.
+ Clone ofertas privadas para criar novas ofertas.
+ Crie autorizações de revenda em SaaS, AMI e produtos de contêiner.
+ Cancele e modifique as autorizações de revenda.
+ Clonar autorizações de revenda.
+ Receba notificações quando os compradores se inscreverem em ofertas privadas.
+ Veja o painel de ofertas privadas e autorizações de revenda compartilhadas criadas por meio do conector.
+ Como parceiro AWS de canal:
+ Sincronize e visualize as autorizações de revenda compartilhadas criadas pelo vendedor do ISV.
+ Crie e gerencie ofertas privadas AWS do Channel Partner para produtos SaaS, AMI e contêiner a partir de autorizações de revenda compartilhadas.
## Versão 1.7 (12 de outubro de 2022)
### Log de alterações
**User interface** (Interface do usuário)
+ Adicione o campo opcional de comentários de AWS Partner Network avaliação à tela de mapeamento.
+ Mova a seção de ajuda para a página de **configuração guiada**.
**Correções de bugs**
+ Corrija um problema em que a carga incorreta estava sendo exibida no registro de origem `synclog` detalhado em caso de falha parcial.
+ Corrija um problema em que os parceiros já atualizaram os identificadores exclusivos do CRM do parceiro no ACE para correção automática com base no objeto de destino na organização.
+ Corrija um problema para impedir o envio de atualizações de oportunidades que ainda não foram aprovadas após a solicitação de criação inicial para AWS Partner. Isso evita que respostas de erro de validação sejam recebidas AWS Partner devido à oportunidade não estar no status de aprovada.
**Problemas conhecidos**
Não aplicável.
## Versão 1.6 (13 de janeiro de 2023)
### Log de alterações
**User interface** (Interface do usuário)
+ Adicione um componente para permitir que os parceiros levantem casos de suporte por meio da AWS Partner Central. Isso está disponível na página de **configuração guiada** do aplicativo.
+ Os administradores podem corrigir os dados recebidos na carga de entrada para corrigir valores incorretos da lista de opções para que possam ser processados.
**Limpeza do registro de sincronização**
Os registros antigos do log de sincronização são limpos automaticamente com base na configuração personalizada do aplicativo **Sync Log Retention**. Esse recurso permite que os parceiros configurem por quanto tempo desejam reter os registros de registro de sincronização de entrada e saída.
**Correções de bugs**
+ Atualize a mensagem de validação quando um valor de lista de opções não mapeado estiver presente na carga de entrada para indicar o valor incorreto.
+ Atualize o filtro de tarefas de saída para utilizar a contagem e os dias de repetição configurados na configuração personalizada do aplicativo para repetir automaticamente a transação depois que os dados forem corrigidos, até que o número de tentativas seja excedido.
**Problemas conhecidos**
Não aplicável.
## Versão 1.5 (13 de janeiro de 2023)
### Log de alterações
**User interface** (Interface do usuário)
+ Atualize os rótulos no modal de agendamento.
+ Atualize as mensagens de erro de validação na tela de agendamento para fornecer mais contexto aos usuários sobre falhas de agendamento.
+ Atualize o título do aplicativo em todas as referências com "Conector AWS Partner CRM”.
+ **Oportunidade/página principal**
+ Atualização **elegível para sincronização com o rótulo de campo do APN** para **Tem atualizações para AWS**.
+ Atualize o rótulo de campo **Sincronizar com o Partner Central** para **Sincronizar com AWS**.
+ Página de **configuração guiada**
+ Atualize o rótulo **do campo Insira os detalhes da autenticação** para **configurar a AWS conexão APN.**
+ Atualize **o rótulo do campo SPMS** para **ID do parceiro.**
+ Atualize os campos **do Mapear APN** para AWS campos do **Salesforce**.
+ Página **de mapeamento**
+ Atualize os campos **do gerenciador de pipeline ACE** para **AWS**campos.
+ Atualize os campos **Habilitar atualizações do APN** para **Ativar os campos de atualizações de entrada**.
+ Página de **registros de sincronização**
+ Substitua as referências a “APN” por "AWS" (direção).
+ ******Atualize os seguintes rótulos de campos de finalidade do registro de sincronização: **orquestração de entrada** para recuperação de **arquivo de entrada, orquestração de entrada — recuperação** **de registro para recuperação de registro de entrada e orquestração de saída para recuperação** de arquivo de saída.******
**Sincronização instantânea**
Os administradores podem iniciar uma sincronização de saída específica para um único registro por meio de uma ação rápida adicional. A ação rápida **Enviar para AWS** foi adicionada à oportunidade padrão e ao objeto principal para referência. Ele pode ser adicionado a qualquer objeto padrão ou personalizado integrado para fornecer a opção de invocar imediatamente a sincronização para um único registro fora dos trabalhos agendados.
**Correções de bugs**
+ Corrija um problema no registro de sincronização que mostrava um erro de exceção de FLS incorreto.
+ Corrija um problema no objeto Lead quando o `campaignMemberStatus` campo é mapeado.
+ Corrija um problema de mapeamento em que `awsAccountId` os campos `awsFieldEngagement` e estavam sendo excluídos do mapeamento de saída quando mapeados.
+ Atualize os painéis agrupados de dinâmicos para estáticos para que eles não usem o limite da organização instalada para painéis dinâmicos.
**Problemas conhecidos**
Não aplicável.
## Versão 1.4 (7 de dezembro de 2022)
### Log de alterações
**User interface** (Interface do usuário)
+ Simplifique a interface para registros de sincronização.
+ Simplifique a interface para mapeamento modal.
+ Adicione o modal de confirmação ao botão de reinicialização na tela de **mapeamento**.
+ Desative a opção **Próxima** no mapeamento da lista de opções até que todos os campos sejam preenchidos.
+ Adicione texto de ajuda aos títulos das guias no modal de mapeamento.
+ Atualize o rótulo do aplicativo da **administração do APN CRM** para o conector do **AWS Partner CRM**.
**Relatórios e painéis**
Adicione novos relatórios e painéis para rastrear os status dos registros de sincronização.
**Modelo de fluxo**
Adicione um modelo de fluxo ao pacote para configurar uma notificação push personalizada para administradores de negócios sobre erros de registro de sincronização.
**Correções de bugs**
+ Corrija o problema na diferença de data com UTC no mapeamento.
+ **Corrija um problema quando um registro de sincronização parcialmente processado era selecionado para reprocessamento. Ao encontrar um erro, o status no registro de sincronização não muda para Erro.**
+ Atualize a `to sync` fórmula elegível sobre oportunidades e leads padrão.
+ Oculte campos somente para leitura.
+ Atualização para carregar os spinners.
+ Rótulo de atualização para legenda modal.
+ Mantenha `apnValues_ on _tab3` no modal de mapeamento.
+ Atualize a opção **Editar** para que ela leve o usuário à página atual.
+ Desative a seleção de guias, a menos que esteja no `read-only` modo.
+ Desative `field required` o erro quando opcional.
+ Altere as marcas de seleção modais para verde.
+ Adicione componentes e utilitários da guia de mapeamento.
+ Adicione um novo painel e pasta do painel para sincronizar os registros.
+ Remova a permissão para a guia de relatório personalizado obsoleta.
**Problemas conhecidos**
Erro ao mapear o `CampaignMemberStatus` no objeto Lead. Atualmente, AWS Partner podemos pular o mapeamento desse campo não obrigatório ao mapear leads. A correção estará na próxima versão.