Configurando notificações em tempo real para o AWS Partner Central e AWS Marketplace eventos - Central de parceiros da AWS

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

Configurando 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

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, consulteCriação manual de componentes de notificação, posteriormente neste guia.

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

  2. Em Configuração, na caixa Busca rápidaapps, digite e selecione Gerenciador de aplicativos.

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

  4. Faça o seguinte:

    1. Na caixa Nome do aplicativo conectado, insira um nome para o aplicativo.

    2. Na caixa E-mail de contato, insira seu endereço de e-mail.

    3. (Opcional) Preencha os campos restantes conforme descrito em Definir as configurações básicas do aplicativo conectado, na documentação do Salesforce.

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

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

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

    4. Na mensagem que aparece depois de selecionar Ativar fluxo de credenciais do cliente, escolha OK.

    5. Navegue até o final da página e escolha Salvar.

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

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

  8. Em Detalhes do consumidor, escolha os botões Copiar para a chave do consumidor e o segredo do cliente.

  9. Em Configuração, na caixa Busca rápida, insira Aplicativos, selecione Gerenciar aplicativos conectados e escolha o aplicativo conectado que você acabou de criar.

  10. Escolha Editar políticas e faça o seguinte:

    1. Na lista Usuários permitidos, escolha Todos os usuários podem se autoautorizar.

    2. Na lista de relaxamento de IP, escolha Impor restrições de IP.

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

    4. 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 AWS CloudFormation modelo para configurar os AWS componentes para a EventBridge integração com a Amazon ou criar os componentes manualmente. Para usar AWS CloudFormation, baixe os modelos em:

Encontrando o URL do seu domínio

O AWS 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.

  2. Na seção Configuração, na caixa Busca rápida, digitemy domain.

  3. No painel esquerdo, em Configurações da empresa, escolha o link Meu domínio.

  4. Copie o endereço na caixa URL atual do meu domínio.

nota

Você deve usar o prefixo https://ao inserir o URL no AWS CloudFormation modelo.

Usando a AWS CloudFormation pilha

As etapas nos tópicos a seguir explicam como criar e implantar uma AWS 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.

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

  3. Ainda no console, pesquise cloudformation e abra o AWS CloudFormation console.

  4. Na página Pilhas, escolha Criar pilha.

  5. Selecione os botões de opção Escolher um modelo existente e Carregar um arquivo de modelo.

  6. Selecione Escolher arquivo para abrir o modelo baixado e escolha Avançar.

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

    Quando terminar, escolha Next (Próximo).

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

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

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, 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 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/, no painel de navegação esquerdo, escolha destinos de API.

  2. Role para baixo até a tabela de destinos da API e escolha Criar destino da API.

    A página Criar destino da API é exibida.

  3. 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 (_).

      O nome deve ser exclusivo na sua conta na sua região atual.

    2. (Opcional) Insira uma descrição do destino da API.

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

    4. Em Método HTTP, selecione POST.

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

    2. Em Tipo de destino, escolha Outro.

    3. Escolha Credenciais OAuth do cliente.

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

    5. Em Método HTTP, selecione POST.

    6. Em Client ID, insira a chave do consumidor do aplicativo conectado no Salesforce.

    7. Em Segredo do cliente, insira o segredo do consumidor do aplicativo conectado no Salesforce.

    8. Adicione os seguintes OAuth valores:

      • Parâmetro: Campo corporal

      • Chave: grant_type

      • Valor: client_credentials

  5. 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 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 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, escolha Regras.

  2. Na lista, selecione o ônibus de eventos desejado.

  3. Na seção Regras, selecione Criar regra.

  4. Insira um nome para a regra e escolha Avançar.

  5. 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 na AWS documentação.

  6. Escolha Próximo.

  7. Em Selecionar destinos, em Alvo 1, selecione Destino EventBridge da API.

  8. Na lista, selecione o destino da API que você acabou de criar.

  9. Expanda Additional settings (Configurações adicionais).

  10. 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 }
  11. Escolha Avançar e, em seguida, Avançar.

  12. 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 Amazon SQS no Guia do usuário do Amazon SQS.

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, escolha Regras.

  2. Selecione o ônibus de eventos desejado na lista.

  3. Na seção Regras, selecione Criar regra.

  4. Insira um nome para sua regra e escolha Avançar.

  5. 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 da Amazon no Guia EventBridge do usuário da Amazon.

  6. Escolha Próximo.

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

  8. Expanda Additional settings (Configurações adicionais).

  9. 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 }
  10. Escolha Avançar e, em seguida, Avançar.

  11. 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 e Recebimento e exclusão de mensagens (console) 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

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.

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"]   } }