Tutorial: enviar eventos ao Salesforce por meio do Amazon EventBridge - Amazon EventBridge
Pré-requisitosEtapa 1: criar uma conexãoEtapa 2: criar um destino de APIEtapa 3: criar regraEtapa 4: testar a regraEtapa 5: limpar os recursos

Tutorial: enviar eventos ao Salesforce por meio do Amazon EventBridge

É possível usar o EventBridge para encaminhar eventos para serviços de terceiros, como Salesforce.

Neste tutorial, será usado o console do EventBridge para criar uma conexão aoSalesforce, um Destino de API que aponta para o Salesforce e uma regra que roteia eventos para o Salesforce.

Pré-requisitos

Para concluir este tutorial, serão necessários os seguintes recursos:

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

  2. No painel de navegação, escolha Destinos de API.

  3. Escolha a guia Conexões e Criar conexão.

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

  5. Em Tipo de destino, escolha Parceiros e, em Destinos de parceiros, selecione o Salesforce na lista suspensa.

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

  7. Em Método HTTP , escolha POST na lista suspensa.

  8. Em ID do cliente, insira o ID do cliente da sua aplicação do Salesforce conectada.

  9. Em Segredo do cliente, insira o segredo do cliente da sua aplicação do Salesforce conectada.

  10. Para Parâmetros HTTP do OAuth, insira o seguinte par de chave-valor:

    Chave Valor

    grant_type

    client_credentials

  11. Escolha Criar.

Etapa 2: criar um destino de API

Agora que criou a conexão, criará o destino da API para usar como destino da regra.

Para criar o destino de API

  1. Abra o console do Amazon EventBridge em https://console.aws.amazon.com/events/.

  2. No painel de navegação, escolha Destinos da API.

  3. Escolha Criar destino de API.

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

  5. Em Endpoint de destino da API, insira https://MyDomainName.my.salesforce.com/services/data/v54.0/sobjects/MyEvent__e onde MyEvent__e é o evento da plataforma para o qual deseja enviar informações.

  6. Em Método HTTP , escolha POST na lista suspensa.

  7. Em Limite de taxa de invocação, insira 300.

  8. Em Conexão, escolha Usar uma conexão existente e escolha a conexão Salesforce criada na etapa 1.

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

  2. No painel de navegação, escolha Regras.

  3. Escolha Create rule.

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

  5. Em Barramento de eventos, escolha padrão.

  6. Em Rule type, escolha Rule with an event pattern.

  7. Escolha Próximo.

  8. Em Fonte do evento, escolha Outra.

  9. Em Padrão de evento, insira um do seguintes:

    {
  "source": ["aws.s3"]
}

  10. Escolha Próximo.

  11. Em Tipos de destino, escolha o Destino da API do EventBridge.

  12. Em Destino da API, escolha Usar um destino de API existente e escolha o destino do SalesforceAD criado na etapa 2.

  13. Em Perfil de execução, escolha Criar um novo perfil para este recurso específico.

  14. Para Configurações de atualização, faça o seguinte:

    1. Em Configurar entrada de destino, escolha Transformador de entrada na lista suspensa.

    2. Escolha Configurar transformador de entrada

    3. em Eventos de amostra, insira o seguinte:

      {
  "detail":[]
}

    4. Para o Transformador de entrada de destino, faça o seguinte:

      1. Em Caminho de entrada, insira o seguinte:

        {"detail":"$.detail"}

      2. Em Modelo de entrada, insira o seguinte:

        {"message": <detail>}

    5. Escolha Confirmar.

  15. Escolha Próximo.

  16. Escolha Próximo.

  17. Analise os detalhes da regra e selecione Criar regra.

Etapa 4: testar a regra

Para testar sua regra, crie um objeto do Amazon S3 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 do console do EventBridge.

  2. Escolha a guia Connections (Conexões).

  3. Selecione as Conexões que foram criadas.

  4. Escolha Excluir.

  5. 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 do console do EventBridge.

  2. Selecione os destinos da API que foram criados.

  3. Escolha Excluir.

  4. Insira o nome do destino da API e escolha Excluir.

Para excluir as regras do EventBridge

  1. Abra a página Regras no console do EventBridge.

  2. Selecione as regras que foram criadas.

  3. Escolha Excluir.

  4. Escolha Excluir.