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á.
Atualização do Amazon S3 para a integração API-based
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 e Introdução leia anteriormente este guia.
Recomendado: conclua essas atividades primeiro em um ambiente de sandbox, teste minuciosamente e depois implante na produção.
Esta seção orienta você na atualização do seu AWS Partner CRM Connector da Amazon S3-based para a API-based integração. A API-based integração substitui o modelo de bucket legado do Amazon S3 pela sincronização bidirecional em tempo real por meio de funções e APIs do IAM.
Para ver um passo a passo totalmente interativo com capturas de tela, consulte o workshop de atualização do AWS Partner CRM Connector
A atualização envolve as seguintes etapas:
Pré-requisitos
Ordem das operações de migração
Os parceiros geralmente perguntam se devem migrar para a nova experiência do Partner Central no AWS console ou primeiro fazer o upgrade do Amazon S3 para a API. Aqui está a abordagem recomendada:
| Cenário | Recomendação |
|---|---|
| Atualmente no Amazon S3, ainda não está na nova experiência do Partner Central | Migre primeiro para a API e depois migre para a nova experiência do Partner Central em paralelo ou depois |
| Atualmente no Amazon S3, já está na nova experiência do Partner Central | Prossiga diretamente com a migração da API |
| Já está na API, ainda não está na nova experiência do Partner Central | Migre para a nova experiência do Partner Central conforme sua conveniência |
A vinculação de contas é o único pré-requisito rígido
A vinculação de contas é o único pré-requisito rígido para a migração para a Amazon. S3-to-API NÃO é necessário migrar para a nova experiência do Partner Central para iniciar a atualização da API.
Informações principais:
S3-based As integrações da Amazon estão obsoletas e não estão mais disponíveis para novos usuários.
Os parceiros do Amazon S3 devem planejar concluir a migração para a API o mais rápido possível para evitar a degradação do serviço.
Consulte a documentação de integração do AWS Partner CRM para obter o cronograma mais recente sobre o fim da vida útil do back-end Amazon S3.
Certifique-se de que o Partner Central esteja vinculado a um AWS account
O S3-based conector Amazon foi autenticado usando permissões para um bucket gerenciado do Amazon S3 na conta de AWS gerenciamento. Em vez disso, o API-based conector se autentica por meio de funções do IAM na própria AWS conta vinculada do parceiro para chamar diretamente as APIs do Partner Central. É por isso que a vinculação de contas é um pré-requisito técnico rígido: sem ela, o conector não tem como acessar as APIs do Partner Central com as permissões necessárias.
Por que isso pode estar faltando
Quando AWS foi lançada a API Partner Central para vendas em novembro de 2024, a vinculação de contas foi introduzida para permitir que os parceiros acessassem essas APIs de forma programática. A partir da versão 3.0 do conector (também em novembro de 2024), a vinculação de contas tornou-se um requisito para API-based sincronização. Os parceiros que configuraram seu S3-based conector Amazon antes dessa data não teriam concluído a vinculação da conta.
Vincule sua conta do Partner Central à sua AWS conta principal. Escolha sua conta com cuidado desde o início. Embora seja possível desvincular e revincular uma conta diferente, isso cria problemas de persistência de dados e exige esforços manuais de reconciliação.
Regras de seleção de conta — a AWS conta deve ser:
Uma conta paga em boas condições (não no nível gratuito)
Propriedade da empresa do parceiro (não é uma conta de distribuidor)
Tenha um endereço de cobrança que corresponda ao local comercial principal do parceiro
NÃO é um sandbox, desenvolvedor, pessoal ou conta management/payer
A vinculação de contas é permanente
A vinculação de contas é permanente após a migração do Partner Central para o AWS console. Todos os recursos do APN (oportunidades da ACE, histórico, convites para vários parceiros) estão permanentemente vinculados a essa conta. Escolha com cuidado.
Recursos:
Seção de vinculação de contas do workshop de upgrade
no site do AWS Workshops Desvinculando contas
no site do Partner Central
Opcional: migre para a nova experiência do Partner Central em AWS Console
Essa etapa não é necessária para a atualização do S3-to-API conector Amazon. A vinculação de contas por si só fornece a API-based funcionalidade necessária. No entanto, a migração para a nova experiência do Partner Central dá à sua equipe acesso a recursos adicionais:
Agentes Centrais Parceiros (Co-Sell Agente, Agente Financiador, Prospecção Autônoma)
Uma experiência de AWS console centralizada para gerenciar atividades de parceiros junto com seus AWS recursos
Visibilidade aprimorada dos eventos do ciclo de vida da oportunidade diretamente no console
Alteração do formato do ID da solução
Se você migrar para a nova experiência do Partner Central e depois criar novas soluções, essas soluções usarão o novo soln-* formato. O conector CRM ainda não oferece suporte a esse formato; ele exige o S-* formato legado para o solutionOffered campo. As soluções legadas criadas antes da migração mantêm o S-* formato e continuam funcionando.
Consulte o guia de migração do Partner Central para obter mais detalhes.
Pre-migration limpeza de dados
Antes de iniciar a migração, garanta uma saída limpa da S3-based integração com a Amazon. A etapa mais crítica é remover os trabalhos programados remanescentes que podem interferir no API-based conector e no processo de preenchimento.
Quando você desativa os agendamentos do Amazon S3 por meio da interface do conector, os trabalhos agendados subjacentes do Salesforce (com o prefixo APN) permanecem no sistema. Se eles ainda estiverem presentes quando você iniciar o preenchimento ou ativar a API-based sincronização, o agendador antigo e o novo conector poderão gravar nos mesmos registros simultaneamente, causando a criação de oportunidades duplicadas ou conflitos de dados.
Desativar na interface do usuário não é suficiente
Desativar os horários na interface do conector não é suficiente. Você também deve excluir as entradas de trabalho agendado subjacentes na Configuração do Salesforce. Veja Revise e desative os agendamentos do Amazon S3 o passo a passo completo.
Configurar AWS infraestrutura
Essa fase exige que um administrador do Salesforce trabalhe com um administrador de nuvem de TI para configurar dois novos componentes: um aplicativo de cliente externo da Salesforce e componentes de AWS infraestrutura (EventBridge regras e funções do IAM).
Configurar o aplicativo Salesforce External Client
Com a versão Amazon S3, as duas direções de sincronização passaram por um bucket compartilhado do Amazon S3 por parceiro. A versão da API inverte isso para atualizações de entrada — o Partner Central agora envia eventos diretamente para sua organização em tempo real via. EventBridge O aplicativo cliente externo permite um fluxo de credenciais do cliente OAuth 2.0 para que EventBridge possa entregar notificações à medida que elas acontecem.
O administrador do Salesforce deve seguir as instruções na seção
Configurar AWS Componentes
A AWS infraestrutura da versão da API inclui:
EventBridgepara processamento de eventos em tempo real
Funções do IAM para autenticação segura
Esses componentes substituem o modelo de acesso ao bucket do Amazon S3 usado na versão anterior.
O administrador do IT Cloud deve implantar o CloudFormation modelo seguindo as instruções na seção
Finalize a instalação e a configuração no Salesforce
A configuração restante é executada por um administrador do Salesforce. Conclua as atividades no Sandbox primeiro, teste e depois vá para a produção.
Instale a versão mais recente do AWS Partner CRM Connector do Salesforce AppExchange
Revise e ajuste seus mapeamentos
Com a versão Amazon S3, a sincronização externa Sync with AWS dependia de campos e. Has Updates for AWS Eles não são mais usados na API-based integração.
Com a versão da API, a sincronização de saída é controlada por meio da configuração Ativar compartilhamento com AWS integração nas configurações personalizadas do AWS
Partner CRM Connector ()Companion_App_Settings__c. Quando ativadas, as oportunidades ACE são compartilhadas automaticamente AWS sempre que ocorre uma atualização de qualificação.
Principais pontos:
O objeto ACE Opportunity é recomendado como área de aterrissagem — ele corresponde aos pontos de dados de AWS oportunidade no Partner Central e permite o mapeamento automático.
Se você já estava usando a oportunidade ACE para seu mapeamento de integração, a configuração subjacente não muda. No entanto, o pacote atualizado introduz novos campos que não estavam presentes nas versões anteriores.
Analise todas as automações que fazem referência aos S3-era campos antigos da Amazon (
Sync_with_AWS__c,Has_Updates_for_AWS__c) para usar os novos equivalentes.
O modelo de dados ACE Opportunity está disponível no GitHub site
A versão mais recente do conector inclui um modelo de fluxo para ajudar a mapear sua oportunidade padrão para a oportunidade ACE. Para obter mais detalhes, consulte modelos de fluxo.
Revise e adicione campos e botões obrigatórios
O conector introduziu novos campos e botões desde a versão 3.0+. Você deve atualizar manualmente o layout da página de registro do Lightning.
Adicione os seguintes botões à página de registro relâmpago do ACE Opportunity:
| Button | Finalidade |
|---|---|
| Compartilhe com AWS | Envia manualmente a oportunidade para o Partner Central por meio da API. |
| Atualizar a partir de AWS | Extrai os dados mais recentes do Partner Central para esse registro de oportunidades da ACE. |
| Accept/Reject | Aceite ou rejeite as oportunidades AWS indicadas. |
| Associate/Disassociate | Vincule ou desvincule soluções, produtos e ofertas do Marketplace de parceiros AWS aprovados. |
| Assign | Reatribua uma oportunidade a outro usuário em sua conta do Partner Central. |
Remova os seguintes botões antigos da página de registro relâmpago do ACE Opportunity:
| Button | Motivo |
|---|---|
| Enviar para AWS | Substituído por Compartilhar com AWS. |
| Oferta privada de link | Substituído por Associate/Disassociate. |
Adicione os seguintes botões de exibição de lista à guia Oportunidade do ACE:
Aceite oportunidades — Bulk-accept várias oportunidades AWS indicadas.
Atribua oportunidades — Bulk-reassign várias oportunidades.
Para novos campos, revise todos os campos adicionados após a versão 3.0 do conector
Revise e desative os agendamentos do Amazon S3
Com a API-based abordagem, não há mais necessidade de tarefas agendadas — a integração é executada em tempo real.
Para desativar trabalhos agendados
Navegue até a guia Programações no aplicativo AWS Partner CRM Connector.
Escolha Desativar todos os trabalhos e, em seguida, escolha Desativar novamente.
Exclua também os registros agendados. Para remover os trabalhos agendados do APN restantes da Configuração:
Para remover trabalhos agendados do APN da configuração
Navegue até Configuração. Pesquise por “Agendado” e selecione Trabalhos agendados.
Analise a lista de todas as APN-related vagas. Escolha Del para excluí-los.
Continue CustomLogInteractionBatch correndo
Mantenha o CustomLogInteractionBatch trabalho em execução (AppExchange App Analytics).
Exclua trabalhos agendados, não apenas desative
Não deixe os trabalhos em um estado “desativado, mas não excluído”. Trabalhos persistentes causaram a criação de oportunidades duplicadas quando combinados com a sincronização API-based em tempo real.
Limpeza
Desativar regras de validação antigas
Várias regras de validação antigas devem ser desativadas e outras devem permanecer ativas. Consulte esta seção do workshop
Certifique-se também de que os seguintes fluxos legados tenham sido desativados:
Oportunidade de sincronização ACE com a API central de parceiros
Pesquisa de ofertas privadas
Notificação de falha de sincronização do APN
Atualizando o campo de oferta privada na oportunidade ACE
Atualizando o campo de oportunidade Ace no Sync Log Detail Record
Fluxo unificado de sincronização de Standard-ACE oportunidades (modelo)
Teste seu processo antes de passar para a produção. Veja os testes nas configurações
Preenchimento completo de oportunidades de AWS para a Salesforce
Execute um preenchimento para garantir que os dados correspondam entre os ambientes. O awsapn__Last_Modified_Date__c campo na oportunidade ACE precisa corresponder à data da última modificação no Partner Central para que futuras atualizações sejam sincronizadas. A integração com o Amazon S3 não preencheu esse campo, então as oportunidades de migração do Amazon S3 o deixarão vazio — o preenchimento o preenche.
O preenchimento oferece três modos:
| Modo | O que ela faz | Quando usar |
|---|---|---|
| Somente oportunidades de atualização sem a data da última modificação | Atualiza somente registros onde awsapn__Last_Modified_Date__c está vazio | Recomendado para S3-to-API migração para a Amazon |
| Atualize somente AWS oportunidades que já existem no Salesforce | Atualiza todos os registros que já têm um ID do APN CRM | Alternativa segura para migração |
| Atualize todas as oportunidades AWS | Transfere todo o funil do Partner Central para o Salesforce | Use somente em instalações novas |
Antes de executar o preenchimento:
Confirme se todos os trabalhos agendados do APN foram excluídos (não apenas desativados).
Desative o fluxo “Sync ACE Opportunity to Partner Central API” se estiver ativo.
Desative a opção Ativar compartilhamento com AWS integração nas configurações personalizadas (
Companion_App_Settings__c).Conclua a limpeza de dados antes da migração descrita em. Pre-migration limpeza de dados
Após a conclusão do preenchimento:
Re-enable Ative o compartilhamento com AWS integração — isso impulsiona a sincronização contínua.
O fluxo “Sync ACE Opportunity to Partner Central API” NÃO precisa ser reativado.
Verifique se uma amostra de registros para confirmar
awsapn__Last_Modified_Date__cestá preenchida.
Para obter mais detalhes, consulte a seção Oportunidades de
Post-migration: Monitoramento de EventBridge eventos
Após a migração, sua organização do Salesforce recebe atualizações em tempo real do Partner Central via. EventBridge Para verificar se os eventos estão fluindo:
CloudWatch Métricas: navegue até CloudWatch > Métricas > EventBridge. Verifique as invocações e FailedInvocations o destino da sua API.
Registros de sincronização do Salesforce: em qualquer oportunidade ACE, verifique a lista relacionada ao registro de sincronização para ver as entradas de entrada recentes.
EventBridge Monitoramento de regras: verifique a regra criada pelo CloudFormation modelo para ver os eventos correspondentes recentes.
| Sintomas | Causa provável | Resolução |
|---|---|---|
| Nenhuma atualização de entrada no Salesforce | O token do aplicativo cliente externo expirou | Re-authenticate o aplicativo conectado; verifique as credenciais do OAuth no destino da API EventBridge |
| Os eventos param depois de trabalhar | Tempo limite da sessão do Salesforce | Verifique a integridade do destino da API em EventBridge; reconecte |
| Atualizações parciais (faltam alguns campos) | Incompatibilidade de mapeamento de campo | Atualize para a versão mais recente do conector; verifique os mapeamentos de campo |
Solução de problemas comuns de migração
| Erro/ Sintoma | Causa-raiz | Resolução |
|---|---|---|
FIELD_CUSTOM_VALIDATION_EXCEPTIONao clicar em “Atualizar de AWS” | Regras de validação antigas não desativadas | Desativar ACEOppNew_PreventUpdatesWhenPOSubmitted e ACEOpp_PreventUpdatesWhenPOSubmitted |
| Oportunidades duplicadas | Trabalhos agendados persistentes ou vários usuários de integração | Exclua TODOS os trabalhos agendados pelo APN. Verifique se apenas um usuário detémAPN Business Admin. |
| Registros de log de sincronização crescendo rapidamente | Registros com falha na validação, tente novamente a cada ciclo | Identifique registros com falha por meio de registros de sincronização. Corrija os campos obrigatórios ausentes. |
| O preenchimento excede os limites de armazenamento | Muitos registros ao mesmo tempo | Execute em lotes menores. Monitore o armazenamento. |
| “Atualizar de AWS” mostra dados obsoletos | awsapn__Last_Modified_Date__cincompatibilidade | Re-run preenchimento direcionado usando “Somente oportunidades de atualização sem a data da última modificação” |
| As oportunidades do Partner Central não estão aparecendo | EventBridge problema de conexão ou compartilhamento automático desativado | Verifique a integridade EventBridge do destino da API. Confirme se a opção “Ativar compartilhamento com AWS integração” está ativada. |
Como obter ajuda
Se você encontrar problemas que as etapas anteriores não possam resolver:
Abra um caso de suporte: Partner Central → Suporte → Abrir novo caso
→ Integração de CRM Assistência na migração: para migrações complexas (mais de 500 oportunidades, integrações personalizadas ou incidentes de produção anteriores), solicite suporte completo por meio de seu líder de aliança.
