View a markdown version of this page

Recebendo eventos de Salesforce na Amazon EventBridge - Amazônia EventBridge
Recebendo eventos do Salesforce usando a Retransmissão do barramento de eventosRecebendo eventos Salesforce usando a Amazon AppFlow

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

Recebendo eventos de Salesforce na Amazon EventBridge

Você pode usar EventBridge a Amazon para receber eventos Salesforce das seguintes formas:

  • Usando o recurso Salesforce's Event Bus Relay para receber eventos diretamente em um ônibus de eventos EventBridge parceiro.

  • Configurando um fluxo na Amazon AppFlow que usa Salesforce como fonte de dados. A Amazon AppFlow então envia Salesforce eventos para EventBridge usando um ônibus de eventos parceiro.

É possível enviar informações do evento para o Salesforce usando destinos de API. Depois que o evento é enviado para oSalesforce, ele pode ser processado por Fluxos ou Acionadores do Apex. Para obter mais informações sobre como configurar um destino de API do Salesforce, consulte Tutorial: enviar eventos ao Salesforce por meio do Amazon EventBridge.

Recebendo eventos de Salesforce usando o Event Bus Relay

Etapa 1: Configurar Salesforce Event Bus Relay e uma fonte de eventos EventBridge parceira

Quando você cria uma configuração de retransmissão de eventos emSalesforce, Salesforce cria uma fonte de eventos de parceiro EventBridge no estado pendente.

Para configurar Salesforce Relé de barramento de eventos

  1. Configurar uma ferramenta de API REST

  2. (Opcional) Defina um evento de plataforma

  3. Crie um pipe para um evento de plataforma personalizado

  4. Crie um membro do pipe para associar o evento da plataforma personalizada

  5. Crie uma credencial nomeada

  6. Criar uma configuração de retransmissão de eventos

Etapa 2: ativar Salesforce conecte a fonte de eventos no EventBridge console e inicie o retransmissor de eventos

  1. Abra a página de fontes de eventos do Partner no EventBridge console.

  2. Selecione a origem do evento do parceiro Salesforce criado na etapa 1.

  3. Escolha Associar ao barramento de eventos.

  4. Valide o nome do barramento de eventos do parceiro.

  5. Selecione Associar .

  6. Inicie a Retransmissão de eventos

Agora que você configurou e iniciou o Event Bus Relay e configurou a fonte de eventos do parceiro, você pode criar uma EventBridge regra que reaja aos eventos para filtrar e enviar os dados para um destino.

Recebendo eventos de Salesforce usando a Amazon AppFlow

A Amazon AppFlow encapsula eventos Salesforce em um envelope de EventBridge eventos. O exemplo a seguir mostra um Salesforce evento recebido por um ônibus de eventos EventBridge parceiro.

{
    "version": "0",
    "id": "5c42b99e-e005-43b3-c744-07990c50d2cc",
    "detail-type": "AccountChangeEvent",
    "source": "aws.partner/appflow.test/salesforce.com/364228160620/CustomSF-Source-Final",
    "account": "000000000",
    "time": "2020-08-20T18:25:51Z",
    "region": "us-west-2",
    "resources": [],
    "detail": {
        "ChangeEventHeader": {
            "commitNumber": 248197218874,
            "commitUser": "0056g000003XW7AAAW",
            "sequenceNumber": 1,
            "entityName": "Account",
            "changeType": "UPDATE",
            "changedFields": [
                "LastModifiedDate",
                "Region__c"
            ],
            "changeOrigin": "com/salesforce/api/soap/49.0;client=SfdcInternalAPI/",
            "transactionKey": "000035af-b239-0581-9f14-461e4187de11",
            "commitTimestamp": 1597947935000,
            "recordIds": [
                "0016g00000MLhLeAAL"
            ]
        },
        "LastModifiedDate": "2020-08-20T18:25:35.000Z",
        "Region__c": "America"
    }
}

Etapa 1: configurar AppFlow a Amazon para usar Salesforce como fonte de eventos parceiros

Para enviar eventos para EventBridge, primeiro você precisa configurar a Amazon AppFlow para usar Salesforce como uma fonte de eventos parceira.

  1. No AppFlow console da Amazon, escolha Criar fluxo.

  2. Na seção Detalhes do fluxo, em Nome do fluxo, insira um nome para seu fluxo.

  3. (Opcional) Insira uma descrição para o fluxo e escolha Próximo.

  4. Em Detalhes da origem, escolha Salesforce no menu suspenso Nome da fonte e escolha Conectar para criar uma nova conexão.

  5. Na caixa de diálogo Conectar-se ao Salesforce, escolha Produção ou Sandbox para o ambiente do Salesforce.

  6. No campo Nome da conexão, insira um nome exclusivo para a conexão e escolha Continuar.

  7. Na caixa de diálogo Salesforce, faça o seguinte:

    1. Insira suas credenciais de login da Salesforce para fazer login na Salesforce.

    2. Selecione Salesforce eventos para os tipos de dados que AppFlow a Amazon deve processar.

  8. No menu suspenso Escolher Salesforce evento, selecione o tipo de evento para o qual enviar. EventBridge

  9. Para um destino, selecione Amazon EventBridge.

  10. Selecione Criar nova origem de eventos para parceiros.

  11. (Opcional) Especifique um sufixo exclusivo para a origem do evento do parceiro.

  12. Escolha Gerar origem de eventos do parceiro.

  13. Escolha um bucket do Amazon S3 para armazenar arquivos de carga útil de eventos maiores que 1 MB.

  14. Na seção Acionador de fluxo, verifique se a opção Executar fluxo no evento está selecionada. Esta configuração garante que o fluxo seja executado quando um novo evento Salesforce ocorrer.

  15. Escolha Próximo.

  16. Para mapeamento de campo, selecione Mapear todos os campos diretamente. Como alternativa, é possível selecionar os campos que são de interesse na lista Nome do campo de origem.

    Para obter mais informações, consulte Mapear campos de dados.

  17. Escolha Próximo.

  18. (Opcional) Configure filtros para campos de dados na Amazon AppFlow.

  19. Escolha Próximo.

  20. Revise as configurações e escolha Criar fluxo.

Com o fluxo configurado, a Amazon AppFlow cria uma nova fonte de eventos de parceiros que você precisa associar a um barramento de eventos parceiro em sua conta.

Etapa 2: configurar EventBridge para receber Salesforce eventos

Certifique-se de que o AppFlow fluxo da Amazon que é acionado a partir de Salesforce eventos com EventBridge destino esteja configurado antes de seguir as instruções nesta seção.

Para configurar EventBridge para receber Salesforce eventos

  1. Abra a página de fontes de eventos do Partner no EventBridge console.

  2. Selecione a origem do evento do parceiro Salesforce criado na etapa 1.

  3. Escolha Associar ao barramento de eventos.

  4. Valide o nome do barramento de eventos do parceiro.

  5. Selecione Associar .

  6. No AppFlow console da Amazon, abra o fluxo que você criou e escolha Ativar fluxo.

  7. Abra a página Regras no EventBridge console.

  8. Escolha Criar regra.

  9. Insira um nome exclusivo para a regra.

  10. Na seção Padrão de evento, escolha a seção Definir padrão.

  11. Para Padrão de correspondência de eventos, selecione Pre-defined padrão por serviço.

  12. Na seção Provedor de serviços, selecione Todos os eventos.

  13. Em Selecionar barramento de eventos, escolha Barramento de evento personalizado ou parceiro.

  14. Selecione o barramento de eventos que você associou à fonte de eventos do AppFlow parceiro da Amazon.

  15. Em Selecionar alvos, escolha o AWS serviço que atuará quando a regra for executada. Uma regra pode ter até cinco destinos.

  16. Escolha Criar.

O serviço de destino recebe todos os eventos Salesforce configurados para sua conta. Para filtrar os eventos ou enviar alguns eventos para destinos diferentes, você pode usar a filtragem baseada em conteúdo com padrões de eventos.

nota

Para eventos maiores que 1 MB, a Amazon AppFlow não envia o evento completo para EventBridge o. Em vez disso, a Amazon AppFlow coloca o evento em um bucket do S3 em sua conta e, em seguida, envia um evento EventBridge com um ponteiro para o bucket do Amazon S3. É possível usar o ponteiro para obter o evento completo do bucket.