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