Recepción de eventos desde Salesforce en Amazon EventBridge - Amazon EventBridge
Recepción de eventos de Salesforce con Event Bus RelayRecepción de eventos de Salesforce con Amazon AppFlow

Recepción de eventos desde Salesforce en Amazon EventBridge

Puede utilizar Amazon EventBridge para recibir eventos de Salesforce de las siguientes maneras:

  • Mediante el uso de la característica Salesforce's Event Bus Relay para recibir eventos directamente en un bus de eventos de socios de EventBridge.

  • Configurando un flujo en Amazon AppFlow que utilice Salesforce como origen de datos. A continuación, Amazon AppFlow envía eventos de Salesforce a EventBridge mediante un bus de eventos de socios.

Puede enviar la información de los eventos a Salesforce a través de los destinos de la API. Una vez enviado el evento a Salesforce, este puede ser procesado por Flujos o desencadenadores de Apex. Para obtener más información acerca de la configuración de un destino de la API de Salesforce, consulte .

Recepción de eventos de Salesforce con Event Bus Relay

Paso 1: Configurar Salesforce Event Bus Relay y una fuente de eventos asociada a EventBridge

Al crear una configuración de retransmisión de eventos en Salesforce, Salesforce crea un origen de evento de socios de EventBridge en estado pendiente.

Para configurar Salesforce Event Bus Relay

  1. Configure una herramienta de API de REST

  2. (Opcional) Defina un evento de plataforma

  3. Cree un canal para un evento de plataforma personalizado

  4. Cree un miembro del canal para asociar el evento de plataforma personalizado

  5. Cree una credencial con nombre

  6. Cree una configuración de retransmisión de eventos

Paso 2: Activar el origen de evento de socios de Salesforce en la consola de EventBridge e iniciar la retransmisión del evento

  1. Abra la página Orígenes de eventos de socios en la consola de EventBridge.

  2. Seleccione el origen de evento de socios de Salesforce que creó en el Paso 1.

  3. Seleccione Asociar con bus de eventos.

  4. Valide el nombre del bus de eventos de socios.

  5. Seleccione Asociar.

  6. Inicie la retransmisión del evento

Ahora que ha configurado e iniciado Event Bus Relay y ha configurado el origen de evento de socios, puede crear una regla de EventBridge que reaccione a los eventos para filtrar y enviar los datos a un destino.

Recepción de eventos de Salesforce con Amazon AppFlow

Amazon AppFlow encapsula los eventos de Salesforce en un sobre de eventos de EventBridge. El siguiente ejemplo muestra un evento de Salesforce recibido por un bus de eventos de socios de 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"
    }
}

Paso 1: Configurar Amazon AppFlow para usar Salesforce como origen de evento de socios

Para enviar eventos a EventBridge, primero debe configurar Amazon AppFlow para usar Salesforce como origen de evento de socios.

  1. En la consola de Amazon AppFlow, seleccione Crear flujo.

  2. En la sección Detalles del flujo, en Nombre del flujo, indique un nombre para el flujo.

  3. (Opcional) Indique una descripción para el flujo y, a continuación, seleccione Siguiente.

  4. En Detalles del origen, seleccione Salesforce del menú desplegable Nombre del origen y, a continuación, seleccione Conectar para crear una conexión nueva.

  5. En el cuadro de diálogo Conectar a Salesforce, seleccione Producción o Entorno aislado para el entorno de Salesforce.

  6. En el campo Nombre de la conexión, introduzca un nombre exclusivo para la conexión y, a continuación, seleccione Continuar.

  7. En el cuadro de diálogo de Salesforce, haga lo siguiente:

    1. Introduzca sus credenciales de inicio de sesión de Salesforce para iniciar sesión de Salesforce.

    2. Seleccione eventos de Salesforce para los tipos de datos que Amazon AppFlow debe procesar.

  8. En el menú desplegable Elegir evento de Salesforce, seleccione el tipo de evento que quiere enviar a EventBridge.

  9. Para elegir un destino, seleccione Amazon EventBridge.

  10. Seleccione Crear un origen de evento de socios nuevo.

  11. (Opcional) Especifique un sufijo único para el origen de evento de socios.

  12. Seleccione Generar origen de evento de socios.

  13. Seleccione un bucket de Amazon S3 para almacenar los archivos de carga de eventos que superen los 256 KB.

  14. En la sección Desencadenador de flujo, asegúrese de que esté seleccionada la opción Ejecutar flujo en el evento. Esta configuración garantiza que el flujo se ejecute cuando se produzca un evento de Salesforce nuevo.

  15. Seleccione Siguiente.

  16. Para la asignación de campos, seleccione Asignar todos los campos directamente. Como alternativa, puede seleccionar los campos que sean de interés en la lista Nombre de campos de origen.

    Para obtener más información sobre la asignación de campos, consulte Asignación de campos de origen de datos.

  17. Seleccione Siguiente.

  18. (Opcional) Configure filtros para los campos de datos en Amazon AppFlow.

  19. Seleccione Siguiente.

  20. Revise la configuración y, a continuación, seleccione Crear.

Con el flujo configurado, Amazon AppFlow crea un nuevo origen de evento de socios que, a continuación, debe asociar a un bus de eventos de socios de la cuenta.

Paso 2: Configurar EventBridge para recibir eventos de Salesforce

Asegúrese de que el flujo de Amazon AppFlow que se desencadena a partir de eventos de Salesforce con EventBridge como destino esté configurado antes de seguir las instrucciones de esta sección.

Para configurar EventBridge para recibir eventos de Salesforce

  1. Abra la página Orígenes de eventos de socios en la consola de EventBridge.

  2. Seleccione el origen de evento de socios de Salesforce que creó en el Paso 1.

  3. Seleccione Asociar con bus de eventos.

  4. Valide el nombre del bus de eventos de socios.

  5. Seleccione Asociar.

  6. En la consola de Amazon AppFlow, abra el flujo que ha creado y seleccione Activar flujo.

  7. Abra la página Reglas en la consola de Amazon EventBridge.

  8. Seleccione Crear regla.

  9. Introduzca un nombre exclusivo para la regla.

  10. Seleccione patrón de eventos en la sección Definir patrón.

  11. En Patrón de coincidencia de eventos, seleccione Patrón predefinido de un servicio.

  12. En la sección Proveedor de servicios, seleccione Todos los eventos.

  13. En Seleccionar bus de eventos, seleccione Bus de eventos de socio o personalizado.

  14. Seleccione el bus de eventos que asoció al origen de evento de socios de Amazon AppFlow.

  15. En Seleccionar destinos, seleccione el servicio AWS que actuará cuando se ejecute la regla. Una regla puede tener hasta cinco destinos.

  16. Seleccione Crear.

El servicio de destino recibe todos los eventos de Salesforce configurados para la cuenta. Para filtrar los eventos o enviar algunos eventos a diferentes destinos, puede utilizar la opción Filtrar en función del contenido con patrones de eventos.

nota

En el caso de eventos de más de 256 KB, Amazon AppFlow no envía el evento completo a EventBridge. En su lugar, Amazon AppFlow coloca el evento en un bucket de S3 de la cuenta y, a continuación, envía un evento a EventBridge con un puntero al bucket de Amazon S3. Puede usar el puntero para obtener el evento completo del bucket.