

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
<a name="eb-saas-salesforce"></a>

Você pode usar EventBridge a Amazon para receber [eventos](eb-events.md) 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](https://aws.amazon.com/appflow/) que usa Salesforce como fonte de dados. AppFlow Em seguida, a Amazon envia Salesforce eventos para EventBridge usando um [ônibus de eventos parceiro](eb-saas.md).

É 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](https://help.salesforce.com/s/articleView?id=flow.htm) ou [Acionadores do Apex](https://developer.salesforce.com/docs/atlas.en-us.apexcode.meta/apexcode/apex_triggers.htm). 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](eb-tutorial-salesforce.md).

**Topics**
+ [

## Recebendo eventos do Salesforce usando a Retransmissão do barramento de eventos
](#eb-saas-salesforce-relay)
+ [

## Recebendo eventos Salesforce usando a Amazon AppFlow
](#eb-saas-salesforce-appflow)

## Recebendo eventos do Salesforce usando a Retransmissão do barramento de eventos
<a name="eb-saas-salesforce-relay"></a>

### Etapa 1: configurar o Salesforce Event Bus Relay e uma fonte de eventos do EventBridge parceiro
<a name="eb-set-up-relay"></a>

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](https://resources.docs.salesforce.com/rel1/doc/en-us/static/pdf/Salesforce_Event_Bus_Relay_Pilot.pdf#h.z63eim1tqkm3)

1. [(Opcional) Defina um evento de plataforma](https://resources.docs.salesforce.com/rel1/doc/en-us/static/pdf/Salesforce_Event_Bus_Relay_Pilot.pdf#h.2m5t2i52o23m)

1. [Crie um pipe para um evento de plataforma personalizado](https://resources.docs.salesforce.com/rel1/doc/en-us/static/pdf/Salesforce_Event_Bus_Relay_Pilot.pdf#h.s0spl5puf9d0)

1. [Crie um membro do pipe para associar o evento da plataforma personalizada](https://resources.docs.salesforce.com/rel1/doc/en-us/static/pdf/Salesforce_Event_Bus_Relay_Pilot.pdf#h.rdhi4awp8cvv)

1. [Crie uma credencial nomeada](https://resources.docs.salesforce.com/rel1/doc/en-us/static/pdf/Salesforce_Event_Bus_Relay_Pilot.pdf#h.etec44jyv3og)

1. [Criar uma configuração de retransmissão de eventos](https://resources.docs.salesforce.com/rel1/doc/en-us/static/pdf/Salesforce_Event_Bus_Relay_Pilot.pdf#h.43rfyeehz0w5)

### Etapa 2: ativar a fonte de eventos do Salesforce parceiro no EventBridge console e iniciar a retransmissão de eventos
<a name="eb-salesforce-activate-source"></a>

1. Abra a página de [fontes de eventos do parceiro](https://console.aws.amazon.com/events/home?#/partners) no EventBridge console. 

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

1. Escolha **Associar ao barramento de eventos**.

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

1. Selecione **Associar **. 

1. [Inicie a Retransmissão de eventos](https://resources.docs.salesforce.com/rel1/doc/en-us/static/pdf/Salesforce_Event_Bus_Relay_Pilot.pdf#h.t01b3xp87vhu)

[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](eb-create-rule-visual.md) para filtrar e enviar os dados para um destino.](eb-targets.md)

## Recebendo eventos Salesforce usando a Amazon AppFlow
<a name="eb-saas-salesforce-appflow"></a>

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
<a name="eb-configure-appflow"></a>

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](https://console.aws.amazon.com/appflow/), escolha **Create flow**.

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

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

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

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

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

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

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

   1. Selecione Salesforce eventos para os tipos de dados AppFlow a serem processados pela Amazon.

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

1. Para um destino, selecione **Amazon EventBridge**.

1. Selecione **Criar nova origem de eventos para parceiros**.

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

1. Escolha **Gerar origem de eventos do parceiro**.

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

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

1. Escolha **Próximo**.

1. 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](https://docs.aws.amazon.com//appflow/latest/userguide/getting-started.html#map-fields).

1. Escolha **Próximo**.

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

1. Escolha **Próximo**.

1. 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
<a name="eb-salesforce-events"></a>

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](https://console.aws.amazon.com/events/home?#/partners) no EventBridge console. 

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

1. Escolha **Associar ao barramento de eventos**.

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

1. Selecione **Associar **. 

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

1. Abra a página [Regras](https://console.aws.amazon.com/events/home?#/rules) no EventBridge console.

1. Escolha **Criar regra**.

1. Insira um nome exclusivo para a regra.

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

1. Em **Padrão de correspondência de eventos**, escolha **Padrão predefinido por serviço**.

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

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

1. Selecione o ônibus de eventos que você associou à fonte de eventos do AppFlow parceiro da Amazon.

1. Em **Selecionar alvos**, escolha o AWS serviço que deve agir quando a regra for executada. Uma regra pode ter até cinco destinos.

1. 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](eb-create-pattern.md#eb-event-patterns-content-based-filtering). 

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