Tutorial: creazione di una connessione a Zendesk come destinazione API

Puoi usarlo EventBridge per indirizzare eventi a servizi di terze parti come Zendesk.

In questo tutorial, utilizzerai la EventBridge console per creare una connessioneZendesk, una destinazione API che punti e una regola a cui indirizzare gli eventiZendesk. Zendesk

Prerequisiti

Per completare questo tutorial, avrai bisogno delle seguenti risorse:

• Un account Zendesk.

• Un EventBridge bucket Amazon Simple Storage Service (Amazon S3) abilitato per Amazon.

Passaggio 1: creare una connessione

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

2. Nel riquadro di navigazione, scegli Destinazioni API.

3. Scegli la scheda Connessioni, quindi Crea connessione.

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

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

6. In Nome utente, immetti il tuo nome utente Zendesk.

7. In Password, immetti la password Zendesk.

8. Scegli Crea.

Passaggio 2: creare una destinazione API

Ora che hai creato la connessione, creerai la destinazione API da utilizzare come destinazione della regola.

Per creare la destinazione API

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

2. Nel riquadro di navigazione, scegli Destinazioni API.

3. Scegli Crea una destinazione API.

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

5. In Endpoint di destinazione API, immetti https://your-subdomain.zendesk.com/api/v2/tickets.json, dove your-subdomain è il sottodominio associato al tuo account Zendesk.

6. Per HTTP method (Metodo HTTP) scegli POST.

7. In Limite di velocità di invocazione, immetti 10.

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

9. Scegli Crea.

Passaggio 3: creare una regola

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

2. Nel pannello di navigazione, scegli Regole.

3. Scegli Create rule (Crea regola).

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

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

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

7. Seleziona Successivo.

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

9. In Modello di eventi, immetti quanto segue:

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

10. Seleziona Successivo.

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

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

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

14. In Impostazioni aggiuntive, procedi come segue:

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

    2. Scegli Configura il trasformatore di input.

    3. In Eventi di esempio, immetti quanto segue:

       {
         "detail":[]
       }

    4. In Trasformatore di input di destinazione, procedi come segue:

       1. In Percorso di input, immetti quanto segue:

          {"detail":"$.detail"}

       2. In Modello di input, immetti quanto segue:

          {"message": <detail>}

    5. Scegli Conferma.

15. Seleziona Successivo.

16. Seleziona Successivo.

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

Passaggio 4: testare la regola

Per testare la tua regola, crea un oggetto Amazon S3 caricando un file in un bucket abilitato. EventBridge Quando l'evento corrisponde alla regola, EventBridge chiamerà l'API Create Ticket. Zendesk Il nuovo ticket apparirà nella dashboard Zendesk.

Passaggio 5: eliminare le risorse

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 della EventBridge console.

2. Scegliere la scheda Connessioni.

3. Seleziona la connessione che hai creato.

4. Scegli Elimina.

5. Immetti il nome della connessione e scegli Elimina.

Per eliminare le destinazioni EventBridge API

1. Apri la pagina di destinazione dell'API della EventBridge console.

2. Seleziona la destinazione API che hai creato.

3. Scegli Elimina.

4. Immetti il nome della destinazione API e scegli Elimina.

Per eliminare la/le EventBridge regola/e

1. Apri la pagina Regole della EventBridge console.

2. Seleziona la regola che hai creato.

3. Scegliere Delete (Elimina).

4. Scegli Delete (Elimina).