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à. # Integrazione con Zendesk Suite Gestisci i ticket di assistenza Zendesk direttamente da Amazon Quick utilizzando il linguaggio naturale. Con il connettore Action di Zendesk Suite, puoi creare, aggiornare, cercare ed elencare i ticket di assistenza senza uscire da Amazon Quick. Zendesk Suite è disponibile come connettore integrato in Amazon Quick. Per configurare questa integrazione, completa i due passaggi seguenti. Innanzitutto, prepara il tuo account Zendesk con l'accesso richiesto. Quindi, crea il connettore in Amazon Quick ed esegui l'autenticazione con le tue credenziali Zendesk. Questo connettore supporta l'autenticazione utente OAuth e l'autenticazione del servizio di chiavi API. Per informazioni sui metodi di autenticazione supportati da Amazon Quick, consulta[Metodi di autenticazione](quick-action-auth.md). ## Prerequisiti Prima di configurare l'integrazione, verifica di disporre delle seguenti risorse e dei seguenti accessi. + Un account Zendesk attivo con ruolo di amministratore. + Autorizzazioni per accedere ai ticket e ai dati di supporto nella tua istanza Zendesk. + Un abbonamento che soddisfa i requisiti descritti in. [Configura le integrazioni nella console](integration-console-setup-process.md) ## Verifica il tuo account Zendesk Prima di configurare Amazon Quick, verifica che il tuo account Zendesk soddisfi i seguenti requisiti. + Il tuo account Zendesk è attivo e puoi accedere alla [pagina di accesso di Zendesk sul sito web](https://www.zendesk.com/login/) di Zendesk. + I ticket e i dati di supporto a cui desideri accedere sono accessibili dal tuo account. ## Configura l'account Zendesk Il metodo di autenticazione dell'app OAuth personalizzata in Amazon Quick richiede un client OAuth configurato in Zendesk. Il metodo di autenticazione con chiave API richiede un token API. ### Per configurare un client OAuth 1. **Nella tua istanza Zendesk, vai su **Admin Center**, quindi su **App e integrazioni e** infine su client **OAuth** in API.** 1. **Scegli Aggiungi client OAuth.** 1. Completa il modulo con i seguenti campi: + **Nome**: inserisci un nome per la tua app. + **Descrizione**: inserisci una breve descrizione. + **Identificatore**: immettere un identificatore univoco per il client OAuth. + **URL di reindirizzamento: immettere**. `https://{{region}}.quicksight.aws.amazon.com/sn/oauthcallback` Sostituisci {{region}} con la tua AWS regione, ad esempio,. `us-east-1` 1. Scegli **Save** (Salva). Zendesk genera un client secret. **Importante** Registra subito il segreto del cliente. Non puoi recuperarlo dopo aver lasciato questa pagina. 1. Dopo aver acquisito il segreto, scegli nuovamente **Salva** per creare il client OAuth. L'identificatore e il segreto fungono da Client ID e Client Secret quando configuri il connettore di azione in Amazon Quick con il metodo di autenticazione dell'app OAuth personalizzato. Per ulteriori informazioni, consulta [Usare l'autenticazione OAuth con la tua applicazione sul](https://support.zendesk.com/hc/en-us/articles/4408845965210-Using-OAuth-authentication-with-your-application) sito web di Zendesk. ### Per configurare un token API 1. Vai su **Admin Center**, quindi **su App e integrazioni** e quindi su **Token API**. 1. Scegli **Aggiungi token API.** 1. Per **Descrizione**, inserisci una breve descrizione per il token API. 1. Scegli **Save** (Salva). Zendesk genera un token API. **Importante** Registra subito il token API. Non puoi recuperarlo dopo aver lasciato questa pagina. Se scegli il metodo di autenticazione della chiave API in Amazon Quick, usa questo token API come valore della chiave API. Per ulteriori informazioni, consulta [Gestire l'accesso tramite token API all'API Zendesk sul sito](https://support.zendesk.com/hc/en-us/articles/4408889192858-Managing-API-token-access-to-the-Zendesk-API) Web di Zendesk. ## Configura l'integrazione in Amazon Quick Dopo aver verificato l'accesso al tuo account Zendesk, crea il connettore in Amazon Quick. 1. Nella console Amazon Quick, scegli **Connettori**. 1. Scegli la scheda **Crea per il tuo team**. 1. Scegli **Zendesk Suite** tra le opzioni disponibili. 1. Nella finestra di dialogo **Zendesk Suite**, inserisci i seguenti campi: + **Nome**: un nome descrittivo per il connettore Zendesk. + **Descrizione (opzionale)**: scegli **\+ Aggiungi descrizione** per aggiungere note su come verrà utilizzato questo connettore. + **Tipo di connessione**: scegli **Rete pubblica**. 1. Scegli il metodo di autenticazione e configura le impostazioni del connettore: + **App OAuth personalizzata**: inserisci i seguenti campi per la tua istanza Zendesk: + **URL di base** + **ID cliente** + **Segreto del cliente** + **URL del token** + **URL di autorizzazione** + **URL di reindirizzamento** + **Chiave API**: inserisci i seguenti campi: + **URL di base** + **Chiave API** (token API Zendesk) + **Email** associata al tuo account Zendesk 1. Scegli **Next (Successivo)**. 1. **Controlla le azioni per Zendesk Suite e scegli Avanti.** 1. Specificate chi può accedere al connettore: + Per condividere con un team, inserisci il nome del team o l'email del gruppo. + Per mantenerlo privato, lascia il campo vuoto. + Per condividerlo con tutti gli utenti, attiva l'opzione **Tutti i membri dell'organizzazione**. 1. Seleziona **Pubblica**. **Il connettore viene visualizzato nel pannello **Disponibile** con lo stato Connesso.** ## Operazioni disponibili Dopo aver configurato il connettore, puoi utilizzare le seguenti azioni di gestione dei ticket. **Azioni disponibili in Zendesk Suite** | Azione | Description | | --- | --- | | Crea ticket | Crea un nuovo biglietto | | Elenca i risultati della ricerca | Cerca biglietti | | Elenca biglietti | Visualizza tutti i biglietti | | Mostra biglietto | Visualizza i dettagli del biglietto | | Aggiorna ticket | Modifica i dettagli del biglietto | **Nota** Le azioni che puoi utilizzare dipendono dalle autorizzazioni configurate nel tuo account Zendesk. ## Risoluzione dei problemi Per modificare, condividere o eliminare il connettore, consulta. [Gestione delle integrazioni esistenti](integration-workflows.md#managing-existing-integrations) ### Problemi di autenticazione + **Sign-in fallisce**: verifica che il tuo account Zendesk sia attivo e che tu possa accedere alla [pagina di accesso di Zendesk sul sito web](https://www.zendesk.com/login/) di Zendesk. Se la tua organizzazione utilizza il Single Sign-On (SSO), conferma che il tuo provider di identità sia configurato correttamente. + **Accesso negato**: conferma che il tuo utente Zendesk abbia un ruolo di amministratore con autorizzazioni per accedere ai ticket e ai dati di supporto. Per le connessioni con chiave API, verifica che il token API sia valido e che l'indirizzo email associato sia corretto.