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
Tópicos
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.
Entre na sua organização do Salesforce como administrador do sistema.
Em Configuração, na caixa Busca rápida
apps
, digite e selecione Gerenciador de aplicativos.-
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.
Faça o seguinte:
Na caixa Nome do aplicativo conectado, insira um nome para o aplicativo.
Na caixa E-mail de contato, insira seu endereço de e-mail.
(Opcional) Preencha os campos restantes conforme descrito em Definir as configurações básicas do aplicativo conectado
, na documentação do Salesforce.
-
Marque a caixa de seleção Ativar OAuth configurações e faça o seguinte:
Marque a caixa de seleção Ativar para fluxo de dispositivos. Você pode ignorar o URL de retorno de chamada resultante.
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.
-
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
Na mensagem que aparece depois de selecionar Ativar fluxo de credenciais do cliente, escolha OK.
Navegue até o final da página e escolha Salvar.
-
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.
-
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.
Em Detalhes do consumidor, escolha os botões Copiar para a chave do consumidor e o segredo do cliente.
-
Em Configuração, na caixa Busca rápida, insira Aplicativos, selecione Gerenciar aplicativos conectados e escolha o aplicativo conectado que você acabou de criar.
-
Escolha Editar políticas e faça o seguinte:
Na lista Usuários permitidos, escolha Todos os usuários podem se autoautorizar.
Na lista de relaxamento de IP, escolha Impor restrições de IP.
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.
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:
Tópicos
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
Faça login no Salesforce.
Na seção Configuração, na caixa Busca rápida, digite
my domain
.No painel esquerdo, em Configurações da empresa, escolha o link Meu domínio.
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.
-
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_PCAPI.json
-
AWS Marketplace Integração (opcional): https://servicecatalogconnector.s3.amazonaws.com/APIDestinationAWSMPCFT_
.json
-
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.
Ainda no console, pesquise
cloudformation
e abra o AWS CloudFormation console.Na página Pilhas, escolha Criar pilha.
Selecione os botões de opção Escolher um modelo existente e Carregar um arquivo de modelo.
Selecione Escolher arquivo para abrir o modelo baixado e escolha Avançar.
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).
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.
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.
Tópicos
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
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
Abra o EventBridge console em e https://console.aws.amazon.com/events/
, no painel de navegação esquerdo, escolha destinos de API. -
Role para baixo até a tabela de destinos da API e escolha Criar destino da API.
A página Criar destino da API é exibida.
Insira as seguintes informações:
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.
(Opcional) Insira uma descrição do destino da API.
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
Em Método HTTP, selecione POST.
-
Em Configuração de conexão, selecione Criar uma nova conexão e faça o seguinte:
Insira um nome e uma descrição opcional.
Em Tipo de destino, escolha Outro.
Escolha Credenciais OAuth do cliente.
-
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 Em Método HTTP, selecione POST.
Em Client ID, insira a chave do consumidor do aplicativo conectado no Salesforce.
Em Segredo do cliente, insira o segredo do consumidor do aplicativo conectado no Salesforce.
Adicione os seguintes OAuth valores:
Parâmetro: Campo corporal
Chave: grant_type
Valor: client_credentials
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
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.
-
Na Amazon EventBridge, escolha Regras.
-
Na lista, selecione o ônibus de eventos desejado.
-
Na seção Regras, selecione Criar regra.
-
Insira um nome para a regra e escolha Avançar.
-
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.
-
Escolha Próximo.
-
Em Selecionar destinos, em Alvo 1, selecione Destino EventBridge da API.
-
Na lista, selecione o destino da API que você acabou de criar.
-
Expanda Additional settings (Configurações adicionais).
-
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
} -
Escolha Avançar e, em seguida, Avançar.
-
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.
-
No EventBridge console da Amazon, escolha Regras.
-
Selecione o ônibus de eventos desejado na lista.
-
Na seção Regras, selecione Criar regra.
-
Insira um nome para sua regra e escolha Avançar.
-
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.
-
Escolha Próximo.
-
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.
-
Expanda Additional settings (Configurações adicionais).
-
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
} -
Escolha Avançar e, em seguida, Avançar.
-
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.
-
Oportunidade criada: — Acionada quando uma nova oportunidade é criada.
-
Oportunidade atualizada — acionada quando uma oportunidade é atualizada.
Convite de engajamento criado — acionado quando uma oportunidade é criada.
Convite de engajamento aceito — acionado quando um parceiro aceita um convite de AWS engajamento, confirmando seu interesse em colaborar com a AWS oportunidade.
Convite de engajamento rejeitado — 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 |
|
Oportunidade atualizada |
|
Convite de engajamento criado |
|
Convite de compromisso aceito |
|
Convite de compromisso rejeitado |
|
Todos os eventos |
|