Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Tutorial: Enviar eventos a Salesforce desde Amazon EventBridge
Puede usar EventBridge para enrutar [eventos](eb-events.md) a servicios de terceros, como [https://www.salesforce.com/](https://www.salesforce.com/).
En este tutorial, utilizará la consola de EventBridge para crear una conexión a Salesforce, un [destino de API](eb-api-destinations.md) que apunte a Salesforce, y una [regla](eb-rules.md) para dirigir eventos a Salesforce.
**Topics**
+ [Requisitos previos](#eb-sf-prereqs)
+ [Paso 1: Crear una conexión](#eb-sf-create-connection)
+ [Paso 2: Crear un destino de la API](#eb-dd-api-destination)
+ [Paso 3: Crear una regla](#eb-dd-create-rule)
+ [Paso 4: Probar la regla](#eb-dd-test-rule)
+ [Paso 5: Eliminar los recursos](#cleanup)
## Requisitos previos
Para completar este tutorial necesitará los siguientes recursos:
+ Una [cuenta de Salesforce](https://login.salesforce.com/).
+ Una [aplicación de Salesforce conectada](https://help.salesforce.com/s/articleView?id=sf.connected_app_create_basics.htm).
+ Un [token de seguridad de Salesforce](https://help.salesforce.com/s/articleView?id=sf.user_security_token.htm).
+ Un [evento de plataforma personalizado de Salesforce](https://developer.salesforce.com/docs/atlas.en-us.234.0.platform_events.meta/platform_events/platform_events_define.htm).
+ Un [bucket de Amazon Simple Storage Service (Amazon S3)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html) habilitado para EventBridge.
## Paso 1: Crear una conexión
Para enviar eventos a Salesforce, primero tendrá que establecer una conexión con la API de Salesforce.
**Para crear la conexión**
1. Abra la consola de Amazon EventBridge en [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. En el panel de navegación, seleccione **Destinos de API**.
1. Elija la pestaña **Conexiones** y, a continuación, elija **Crear conexión**.
1. Escriba un nombre y una descripción para la conexión. Por ejemplo, introduzca **Salesforce** como nombre y **Salesforce API Connection** como descripción.
1. En **Tipo de destino**, elija **Socios** y, en **Destinos de socios**, seleccione Salesforce de la lista desplegable.
1. En **Punto de conexión de autorización**, introduzca uno de los siguientes:
+ Si utiliza una organización de producción, introduzca **https://*MyDomainName*.my.salesforce.com./services/oauth2/token**
+ Si utiliza un entorno aislado sin dominios mejorados, introduzca **https://*MyDomainName*--*SandboxName*.my. salesforce.com/services /oauth2/token**
+ Si utiliza un entorno aislado con dominios mejorados, introduzca **https://*MyDomainName*--* SandboxName*.sandbox.my.salesforce.com/services/oauth2/token**
1. En **Método HTTP**, elija **POST** en la lista desplegable.
1. En **ID de cliente**, introduzca el ID de cliente de la aplicación de Salesforce conectada.
1. En **Secreto de cliente**, introduzca el secreto de cliente de la aplicación de Salesforce conectada.
1. En **Parámetros Http OAuth**, introduzca el siguiente par clave/valor:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/eventbridge/latest/userguide/eb-tutorial-salesforce.html)
1. Seleccione **Crear**.
## Paso 2: Crear un destino de la API
Ahora que ha creado la conexión, debe crear el destino de la API para usarlo como [destino](eb-targets.md) de la regla.
**Para crear el destino de la API**
1. Abra la consola de Amazon EventBridge en [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. En el panel de navegación, seleccione **Destinos de API**.
1. Elija **Crear destino de API**.
1. Escriba un nombre y una descripción para el destino de la API. Por ejemplo, introduzca **SalesforceAD** para el nombre y **Salesforce API Destination** para la descripción.
1. En **Punto de conexión de destino de la API**, introduzca **https://*MyDomainName*.my.salesforce.com/services/data/v54.0/sobjects/*MyEvent\$1\$1e***, donde **MyEvent\$1\$1E** es el evento de la plataforma al que quiere enviar la información.
1. En **Método HTTP**, elija **POST** en la lista desplegable.
1. En **Límite de frecuencia de invocación**, introduzca **300**.
1. En **Conexión**, elija **Usar una conexión existente** y elija la conexión de `Salesforce` que creó en el paso 1.
1. Seleccione **Crear**.
## Paso 3: Crear una regla
A continuación, debe crear una regla para enviar eventos a Salesforce cuando se cree un objeto de Amazon S3.
**Para crear una regla**
1. Abra la consola de Amazon EventBridge en [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. En el panel de navegación, seleccione **Reglas**.
1. Elija **Creación de regla**.
1. Escriba un nombre y una descripción para la regla. Por ejemplo, introduzca **SalesforceRule** para el nombre y **Rule to send events to Salesforce for S3 object creation** para la descripción.
1. En **Bus de eventos**, elija **Predeterminado**.
1. En **Tipo de regla**, elija **Regla con un patrón de evento**.
1. Seleccione **Siguiente**.
1. En **Origen del evento**, seleccione **Otro**.
1. En **Patrón de evento**, introduzca lo siguiente:
```
{
"source": ["aws.s3"]
}
```
1. Elija **Siguiente**.
1. En **Tipos de destino**, elija **Destino de la API de EventBridge**.
1. En **Destino de la API**, seleccione **Usar un destino de API existente** y, a continuación, elija el destino de `SalesforceAD` que creó en el paso 2.
1. En **Rol de ejecución**, elija **Crear un rol nuevo para este recurso específico**.
1. En **Configuración adicional**, haga lo siguiente:
1. En **Configurar entrada de destino**, seleccione **Transformador de entrada** en la lista desplegable.
1. Elija **Configurar transformador de entrada**
1. En **Eventos de muestra**, introduzca lo siguiente:
```
{
"detail":[]
}
```
1. En **Transformador de entrada de destino**, haga lo siguiente:
1. En **Ruta de entrada**, introduzca lo siguiente:
```
{"detail":"$.detail"}
```
1. En **Plantilla de entrada**, introduzca lo siguiente:
```
{"message": }
```
1. Elija **Confirmar**.
1. Elija **Siguiente**.
1. Elija **Siguiente**.
1. Revise los detalles de la regla y seleccione **Creación de regla**.
## Paso 4: Probar la regla
Para probar su regla, cree un [objeto de Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/upload-objects.html) cargando un archivo en un bucket habilitado para EventBridge. La información sobre el objeto creado se enviará al evento de la plataforma de Salesforce.
## Paso 5: Eliminar los recursos
A menos que desee conservar los recursos que creó para este tutorial, puede eliminarlos ahora. Si elimina los recursos de AWS que ya no utiliza, evitará gastos innecesarios en su cuenta de AWS.
**Para eliminar las conexiones de EventBridge**
1. Abra la página [Destinos de la API](https://console.aws.amazon.com/events/home#/apidestinations) en la consola de EventBridge.
1. Elija la pestaña **Connections (Conexiones)**.
1. Seleccione las conexiones que creó.
1. Elija **Eliminar**.
1. Introduzca el nombre de la conexión y elija **Eliminar**.
**Para eliminar los destinos de la API de EventBridge**
1. Abra la página [Destinos de la API](https://console.aws.amazon.com/events/home#/apidestinations) en la consola de EventBridge.
1. Seleccione los destinos de la API que creó.
1. Elija **Eliminar**.
1. Introduzca el nombre del destino de la API y elija **Eliminar**.
**Para eliminar las reglas de EventBridge**
1. Abra la página [Reglas](https://console.aws.amazon.com/events/home#/rules) en la consola de EventBridge.
1. Seleccione las reglas que creó.
1. Elija **Eliminar**.
1. Elija **Eliminar**.