Receber eventos do Salesforce no Amazon EventBridge - Amazon EventBridge
Recebendo eventos do Salesforce usando a Retransmissão do barramento de eventosComo receber eventos do Salesforce usando o Amazon AppFlow

Receber eventos do Salesforce no Amazon EventBridge

É possível usar o Amazon EventBridge para receber eventos do Salesforce das seguintes formas:

  • Ao usar o atributo Retransmissão do barramento de eventos do Salesforce's para receber eventos diretamente em um barramento de eventos parceiro do EventBridge.

  • Ao configurar um fluxo no Amazon AppFlow que usa o Salesforce como fonte de dados. O Amazon AppFlow envia eventos do Salesforce para o EventBridge usando um barramento 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 a retransmissão do barramento de eventos do Salesforce e uma origem de eventos parceira do EventBridge

Quando uma configuração de retransmissão de eventos é criada no Salesforce, o Salesforce cria uma origem de eventos do parceiro no 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 origem de eventos do parceiro do Salesforce no console do EventBridge e iniciar a retransmissão de eventos

  1. Abra a página de Origens de eventos do parceiro no console do EventBridge.

  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 a Retransmissão do barramento de eventos e a origem de eventos do parceiro foram configuradas, é possível criar uma Regra do EventBridge que reage aos eventos para filtrar e enviar os dados para um destino.

Como receber eventos do Salesforce usando o Amazon AppFlow

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

{
    "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 o Amazon AppFlow para usar o Salesforce como origem de eventos do parceiro

Para enviar eventos para o EventBridge, primeiro você precisa configurar o Amazon AppFlow para usar o Salesforce como origem de eventos do parceiro.

  1. No console do Amazon AppFlow, 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 origem 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 da 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 eventos da Salesforce para os tipos de dados para o Amazon AppFlow processar.

  8. No menu suspenso Escolher evento da Salesforce, selecione o tipo de evento a ser enviado para o 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 256 KB.

  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 no Amazon AppFlow.

  19. Escolha Próximo.

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

Com o fluxo configurado, o Amazon AppFlow cria uma nova origem de eventos de parceiros que precisa ser associada a um barramento de eventos de parceiros em sua conta.

Etapa 2: configurar o EventBridge para receber eventos do Salesforce

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

Para configurar o EventBridge para receber eventos Salesforce

  1. Abra a página de Origens de eventos do parceiro no console do EventBridge.

  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 console do Amazon AppFlow, abra o fluxo criado e escolha Ativar fluxo.

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

  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 barramento de eventos associado à origem de eventos do parceiro Amazon AppFlow.

  15. Em Selecionar destinos, escolha o serviço da AWS 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

O Amazon AppFlow não envia o evento completo para o EventBridge em eventos maiores que 256 KB. Em vez disso, o Amazon AppFlow coloca o evento em um bucket do S3 na sua conta e envia um evento para o EventBridge com um ponteiro para o bucket do Amazon S3. É possível usar o ponteiro para obter o evento completo do bucket.