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á.
# Tutorial: enviar eventos ao Salesforce por meio do Amazon EventBridge
É possível usar o EventBridge para encaminhar [eventos](eb-events.md) para serviços de terceiros, como [https://www.salesforce.com/](https://www.salesforce.com/).
Neste tutorial, será usado o console do EventBridge para criar uma conexão aoSalesforce, um [Destino de API](eb-api-destinations.md) que aponta para o Salesforce e uma [regra](eb-rules.md) que roteia eventos para o Salesforce.
**Topics**
+ [Pré-requisitos](#eb-sf-prereqs)
+ [Etapa 1: criar uma conexão](#eb-sf-create-connection)
+ [Etapa 2: criar um destino de API](#eb-dd-api-destination)
+ [Etapa 3: criar regra](#eb-dd-create-rule)
+ [Etapa 4: testar a regra](#eb-dd-test-rule)
+ [Etapa 5: limpar os recursos](#cleanup)
## Pré-requisitos
Para concluir este tutorial, serão necessários os seguintes recursos:
+ Uma [conta do Salesforce](https://login.salesforce.com/).
+ Uma [aplicação Salesforce conectada](https://help.salesforce.com/s/articleView?id=sf.connected_app_create_basics.htm).
+ Um [token de segurança do Salesforce](https://help.salesforce.com/s/articleView?id=sf.user_security_token.htm).
+ Um [evento de plataforma personalizado do Salesforce](https://developer.salesforce.com/docs/atlas.en-us.234.0.platform_events.meta/platform_events/platform_events_define.htm).
+ Um bucket do [Amazon Simple Storage Service (Amazon S3)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html) habilitado pelo EventBridge.
## Etapa 1: criar uma conexão
Para enviar eventos para o Salesforce, primeiro é preciso estabelecer uma conexão com a API do Salesforce.
**Para criar a conexão**
1. Abra o console do Amazon EventBridge em [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. No painel de navegação, escolha **Destinos de API**.
1. Escolha a guia **Conexões** e **Criar conexão**.
1. Insira um nome e uma descrição para a conexão. Por exemplo, insira **Salesforce** como um nome e **Salesforce API Connection** como uma descrição.
1. Em **Tipo de destino**, escolha **Parceiros** e, em **Destinos de parceiros**, selecione o Salesforce na lista suspensa.
1. Em **Endpoint de autorização**, insira um destes:
+ Se estiver usando uma organização de produção, insira **https://*MyDomainName*.my.salesforce.com./services/oauth2/token**
+ Se estiver usando uma sandbox sem domínios aprimorados, digite **https://*MyDomainName*--*SandboxName*.my. salesforce.com/services /oauth2/token**
+ Se estiver usando uma sandbox com domínios aprimorados, digite **https://*MyDomainName*--* SandboxName*.sandbox.my.salesforce.com/services/oauth2/token**
1. Em **Método HTTP** , escolha **POST** na lista suspensa.
1. Em **ID do cliente**, insira o ID do cliente da sua aplicação do Salesforce conectada.
1. Em **Segredo do cliente**, insira o segredo do cliente da sua aplicação do Salesforce conectada.
1. Para **Parâmetros HTTP do OAuth**, insira o seguinte par de chave-valor:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/eventbridge/latest/userguide/eb-tutorial-salesforce.html)
1. Escolha **Criar**.
## Etapa 2: criar um destino de API
Agora que criou a conexão, criará o destino da API para usar como [destino](eb-targets.md) da regra.
**Para criar o destino de API**
1. Abra o console do Amazon EventBridge em [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. No painel de navegação, escolha **Destinos da API**.
1. Escolha **Criar destino de API**.
1. Insira um nome e uma descrição para o destino de API. Por exemplo, insira **SalesforceAD** para o nome e **Salesforce API Destination** para a descrição.
1. Em **Endpoint de destino da API**, insira **https://*MyDomainName*.my.salesforce.com/services/data/v54.0/sobjects/*MyEvent\$1\$1e*** onde **MyEvent\$1\$1e** é o evento da plataforma para o qual deseja enviar informações.
1. Em **Método HTTP** , escolha **POST** na lista suspensa.
1. Em **Limite de taxa de invocação**, insira **300**.
1. Em **Conexão**, escolha U**sar uma conexão existente** e escolha a conexão `Salesforce` criada na etapa 1.
1. Escolha **Criar**.
## Etapa 3: criar regra
Em seguida, será criada uma regra para enviar eventos para o Salesforce quando um objeto do Amazon S3 é criado.
**Como criar uma regra**
1. Abra o console do Amazon EventBridge em [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. No painel de navegação, escolha **Regras**.
1. Escolha **Create rule**.
1. Insira um nome e uma descrição para a regra. Por exemplo, insira **SalesforceRule** para o nome e **Rule to send events to Salesforce for S3 object creation** para a descrição.
1. Em **Barramento de eventos**, escolha **padrão**.
1. Em **Rule type**, escolha **Rule with an event pattern**.
1. Escolha **Próximo**.
1. Em **Fonte do evento**, escolha **Outra**.
1. Em **Padrão de evento**, insira um do seguintes:
```
{
"source": ["aws.s3"]
}
```
1. Escolha **Próximo**.
1. Em **Tipos de destino**, escolha o **Destino da API do EventBridge**.
1. Em **Destino da API**, escolha **Usar um destino de API existente** e escolha o destino do `SalesforceAD` criado na etapa 2.
1. Em **Perfil de execução**, escolha **Criar um novo perfil para este recurso específico**.
1. Para **Configurações de atualização**, faça o seguinte:
1. Em **Configurar entrada de destino**, escolha **Transformador de entrada** na lista suspensa.
1. Escolha **Configurar transformador de entrada**
1. em **Eventos de amostra**, insira o seguinte:
```
{
"detail":[]
}
```
1. Para o **Transformador de entrada de destino**, faça o seguinte:
1. Em **Caminho de entrada**, insira o seguinte:
```
{"detail":"$.detail"}
```
1. Em **Modelo de entrada**, insira o seguinte:
```
{"message": }
```
1. Escolha **Confirmar**.
1. Escolha **Próximo**.
1. Escolha **Próximo**.
1. Analise os detalhes da regra e selecione **Criar regra**.
## Etapa 4: testar a regra
Para testar sua regra, crie um [objeto do Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/upload-objects.html) fazendo o upload de um arquivo em um bucket compatível com o Eventbridge. As informações sobre o objeto criado serão enviadas para o evento da plataforma Salesforce.
## Etapa 5: limpar os recursos
Agora você pode excluir os recursos criados para este tutorial, a menos que queira mantê-los. Ao excluir os recursos da AWS que não estão mais sendo usados, são evitadas cobranças desnecessárias em sua conta da AWS.
**Para excluir as conexões do EventBridge**
1. Abra a página de [Destino da API](https://console.aws.amazon.com/events/home#/apidestinations) do console do EventBridge.
1. Escolha a guia **Connections (Conexões)**.
1. Selecione as Conexões que foram criadas.
1. Escolha **Excluir**.
1. Insira o nome da conexão e escolha **Excluir**.
**Para excluir os destinos da API do EventBridge**
1. Abra a página de [Destino da API](https://console.aws.amazon.com/events/home#/apidestinations) do console do EventBridge.
1. Selecione os destinos da API que foram criados.
1. Escolha **Excluir**.
1. Insira o nome do destino da API e escolha **Excluir**.
**Para excluir as regras do EventBridge**
1. Abra a página [Regras](https://console.aws.amazon.com/events/home#/rules) no console do EventBridge.
1. Selecione as regras que foram criadas.
1. Escolha **Excluir**.
1. Escolha **Excluir**.