Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Tutorial: invia eventi a Zendesk da Amazon EventBridge
<a name="eb-tutorial-zendesk"></a>

Puoi utilizzarlo EventBridge per indirizzare [gli eventi](eb-events.md) a servizi di terze parti come [https://www.zendesk.com/](https://www.zendesk.com/).

In questo tutorial, utilizzerai la EventBridge console per creare una connessioneZendesk, una [destinazione API](eb-api-destinations.md) che punti e una [regola](eb-rules.md) a cui indirizzare gli eventiZendesk. Zendesk 

**Topics**
+ [Prerequisiti](#eb-zd-prereqs)
+ [Passaggio 1: creare una connessione](#eb-zd-create-connection)
+ [Passaggio 2: creare una destinazione API](#eb-zd-api-destination)
+ [Passaggio 3: creare una regola](#eb-zd-create-rule)
+ [Passaggio 4: testare la regola](#eb-zd-test-rule)
+ [Passaggio 5: eliminare le risorse](#cleanup)

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

Per completare questo tutorial, avrai bisogno delle seguenti risorse:
+ Un [account Zendesk](https://www.zendesk.com/register/#step-1).
+ Un EventBridge bucket [Amazon Simple Storage Service (Amazon S3) abilitato per Amazon](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html).

## Passaggio 1: creare una connessione
<a name="eb-zd-create-connection"></a>

Per inviare eventi a Zendesk, devi prima stabilire una connessione all'API Zendesk.

**Per creare la connessione**

1. Apri la EventBridge console Amazon all'indirizzo [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. Nel riquadro di navigazione, scegli **Destinazioni API**.

1. Scegli la scheda **Connessioni**, quindi **Crea connessione**.

1. Immetti un nome e una descrizione per la connessione. In questo esempio, immetti **Zendesk** come nome e **Connection to Zendesk API** come descrizione.

1. In **Tipo di autorizzazione**, scegli **Base (nome utente/password)**.

1. In **Nome utente**, immetti il tuo nome utente Zendesk.

1. In **Password**, immetti la password Zendesk.

1. Scegli **Create** (Crea).

## Passaggio 2: creare una destinazione API
<a name="eb-zd-api-destination"></a>

Ora che hai creato la connessione, creerai la destinazione API da utilizzare come [destinazione](eb-targets.md) della regola.

**Per creare la destinazione API**

1. Apri la EventBridge console Amazon all'indirizzo [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. Nel riquadro di navigazione, scegli **Destinazioni API**.

1. Scegli **Crea una destinazione API**.

1. Immetti un nome e una descrizione per la destinazione API. In questo esempio, immetti **ZendeskAD** come nome e **Zendesk API destination** come descrizione.

1. Per **l'endpoint di destinazione dell'API****https://{{your-subdomain}}.zendesk.com/api/v2/tickets.json**, inserisci {{your-subdomain}} dov'è il sottodominio associato al tuo Zendesk account.

1. Per **HTTP method** (Metodo HTTP) scegli **POST**.

1. In **Limite di velocità di invocazione**, immetti **10**.

1. In **Connessione**, scegli **Utilizza una connessione esistente** e scegli la connessione `Zendesk` che hai creato in Passaggio 1.

1. Scegli **Create** (Crea).

## Passaggio 3: creare una regola
<a name="eb-zd-create-rule"></a>

Ora creerai una regola per inviare eventi a Zendesk quando viene creato un oggetto Amazon S3.

**Per creare una regola**

1. Apri la EventBridge console Amazon all'indirizzo [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. Nel pannello di navigazione, scegli **Regole**.

1. Scegli **Create rule** (Crea regola).

1. Immettere un nome e una descrizione per la regola. In questo esempio, immetti **ZendeskRule** come nome e **Rule to send events to Zendesk when S3 objects are created** come descrizione.

1. Per **Event bus** (Bus di eventi), scegli **default**.

1. Per **Rule type** (Tipo di regola), scegli **Rule with an event pattern** (Regola con un modello di eventi).

1. Scegli **Next (Successivo)**.

1. In **Event source** (Origine eventi), scegli **Other** (Altro).

1. In **Modello di eventi**, immetti quanto segue:

   ```
   {
     "source": ["aws.s3"]
   }
   ```

1. Scegli **Next (Successivo)**.

1. Per i **tipi di Target**, scegli la **destinazione EventBridge dell'API**.

1. In **Destinazione API**, scegli **Utilizza una destinazione API esistente**, quindi scegli la destinazione `ZendeskAD` creata in Passaggio 2.

1. In **Ruolo di esecuzione**, scegli **Crea un nuovo ruolo per questa risorsa specifica**.

1. In **Impostazioni aggiuntive**, procedi come segue:

   1. In **Configura l'input di destinazione**, scegli **Trasformatore di input** dall'elenco a discesa.

   1. Scegli **Configura il trasformatore di input**.

   1. In **Eventi di esempio**, immetti quanto segue:

      ```
      {
        "detail":[]
      }
      ```

   1. In **Trasformatore di input di destinazione**, procedi come segue:

      1. In **Percorso di input**, immetti quanto segue:

         ```
         {"detail":"$.detail"}
         ```

      1. In **Modello di input**, immetti quanto segue:

         ```
         {"message": <detail>}
         ```

   1. Scegli **Conferma**.

1. Scegli **Next (Successivo)**.

1. Scegli **Next (Successivo)**.

1. Rivedi i dettagli della regola e scegli **Create rule** (Crea regola).

## Passaggio 4: testare la regola
<a name="eb-zd-test-rule"></a>

Per testare la tua regola, crea un [oggetto Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/upload-objects.html) caricando un file in un bucket abilitato. EventBridge [Quando l'evento corrisponde alla regola, EventBridge chiamerà l'API Create Ticket. Zendesk](https://developer.zendesk.com/rest_api/docs/support/tickets#create-ticket) Il nuovo ticket apparirà nella dashboard Zendesk.

## Passaggio 5: eliminare le risorse
<a name="cleanup"></a>

Ora è possibile eliminare le risorse create per questo tutorial, a meno che non si voglia conservarle. Eliminando AWS le risorse che non utilizzi più, eviti addebiti inutili sul tuo AWS account.

**Per eliminare le EventBridge connessioni**

1. Apri la [pagina di destinazione dell'API](https://console.aws.amazon.com/events/home#/apidestinations) della EventBridge console.

1. Scegliere la scheda **Connessioni**.

1. Seleziona la connessione che hai creato.

1. Scegliere **Delete** (Elimina).

1. Immetti il nome della connessione e scegli **Elimina**.

**Per eliminare le destinazioni EventBridge API**

1. Apri la [pagina di destinazione dell'API](https://console.aws.amazon.com/events/home#/apidestinations) della EventBridge console.

1. Seleziona la destinazione API che hai creato.

1. Scegliere **Delete** (Elimina).

1. Immetti il nome della destinazione API e scegli **Elimina**.

**Per eliminare le EventBridge regole**

1. Apri la [pagina Regole](https://console.aws.amazon.com/events/home#/rules) della EventBridge console.

1. Seleziona la regola che hai creato.

1. Scegliere **Delete (Elimina)**.

1. Scegli **Delete** (Elimina).