Recebendo eventos Salesforce da Amazon EventBridge - Amazon 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 Salesforce da 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.

  • Ao configurar um fluxo na Amazon AppFlow que usa Salesforce como fonte de dados. AppFlow Em seguida, a Amazon 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 do Salesforce usando a Retransmissão do barramento de eventos

Etapa 1: configurar o Salesforce Event Bus Relay e uma fonte de eventos do EventBridge parceiro

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

Para configurar a Retransmissão do barramento de eventos do Salesforce

  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 a fonte de eventos do Salesforce parceiro no EventBridge console e iniciar a retransmissão de eventos

  1. Abra a página de fontes de eventos do parceiro 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 Salesforce usando a Amazon AppFlow

A Amazon AppFlow encapsula os 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 ser usada Salesforce como fonte de eventos parceira

Para enviar eventos para EventBridge, primeiro você precisa configurar a Amazon AppFlow para usá-la Salesforce como fonte de eventos parceira.

  1. No AppFlowconsole da Amazon, escolha Create flow.

  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 AppFlow a serem processados pela Amazon.

  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 ônibus de eventos de parceiros 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 como 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 parceiro 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. Em Padrão de correspondência de eventos, escolha Padrão predefinido 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 ônibus de eventos que você associou à fonte de eventos do AppFlow parceiro da Amazon.

  15. Em Selecionar alvos, escolha o AWS serviço que deve agir 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. Em vez disso, a Amazon AppFlow coloca o evento em um bucket do S3 na sua conta e, em seguida, envia um evento para EventBridge com um ponteiro para o bucket do Amazon S3. É possível usar o ponteiro para obter o evento completo do bucket.