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 Zendesk desde Amazon EventBridge
<a name="eb-tutorial-zendesk"></a>

Puede usar EventBridge para dirigir [eventos](eb-events.md) a servicios de terceros, como [https://www.zendesk.com/](https://www.zendesk.com/).

En este tutorial, utilizará la consola de EventBridge para crear una conexión a Zendesk, un [destino de API](eb-api-destinations.md) que apunte a Zendesk, y una [regla](eb-rules.md) para dirigir eventos a Zendesk. 

**Topics**
+ [Requisitos previos](#eb-zd-prereqs)
+ [Paso 1: Crear una conexión](#eb-zd-create-connection)
+ [Paso 2: Crear un destino de la API](#eb-zd-api-destination)
+ [Paso 3: Crear una regla](#eb-zd-create-rule)
+ [Paso 4: Probar la regla](#eb-zd-test-rule)
+ [Paso 5: Eliminar los recursos](#cleanup)

## Requisitos previos
<a name="eb-zd-prereqs"></a>

Para completar este tutorial necesitará los siguientes recursos:
+ Una [cuenta de Zendesk](https://www.zendesk.com/register/#step-1).
+ 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
<a name="eb-zd-create-connection"></a>

Para enviar eventos a Zendesk, primero tendrá que establecer una conexión con la API de Zendesk.

**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 **Zendesk** para el nombre y **Connection to Zendesk API** para la descripción.

1. En **Tipo de autorización**, elija **Basic (Nombre de usuario y contraseña)**.

1. En **Nombre de usuario**, introduzca su nombre de usuario de Zendesk.

1. En **Contraseña**, introduzca su contraseña de Zendesk.

1. Seleccione **Crear**.

## Paso 2: Crear un destino de la API
<a name="eb-zd-api-destination"></a>

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 **ZendeskAD** para el nombre y **Zendesk API destination** para la descripción.

1. En **Punto de conexión de destino de la API**, introduzca **https://{{your-subdomain}}.zendesk.com/api/v2/tickets.json**, donde {{your-subdomain}} es el subdominio asociado a su cuenta de Zendesk.

1. En **Método HTTP**, elija **POST**.

1. En **Límite de frecuencia de invocación**, introduzca **10**.

1. En **Conexión**, elija **Usar una conexión existente** y elija la conexión de `Zendesk` que creó en el paso 1.

1. Seleccione **Crear**.

## Paso 3: Crear una regla
<a name="eb-zd-create-rule"></a>

A continuación, cree una regla para enviar eventos a Zendesk 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 **ZendeskRule** para el nombre y **Rule to send events to Zendesk when S3 objects are created** 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 `ZendeskAD` 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": <detail>}
         ```

   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
<a name="eb-zd-test-rule"></a>

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. Cuando el evento cumpla con la regla, EventBridge llamará a la [API crear ticket de Zendesk](https://developer.zendesk.com/rest_api/docs/support/tickets#create-ticket). El nuevo ticket aparecerá en el panel de control de Zendesk.

## Paso 5: Eliminar los recursos
<a name="cleanup"></a>

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