View a markdown version of this page

Integrazione con Zendesk Suite - Amazon Quick

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, consultaMetodi di autenticazione.

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

Verifica il tuo account Zendesk

Prima di configurare Amazon Quick, verifica che il tuo account Zendesk soddisfi i seguenti requisiti.

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.

  2. Scegli Aggiungi client OAuth.

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

  4. Scegli Save (Salva). Zendesk genera un client secret.

    Importante

    Registra subito il segreto del cliente. Non puoi recuperarlo dopo aver lasciato questa pagina.

  5. 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 sito web di Zendesk.

Per configurare un token API

  1. Vai su Admin Center, quindi su App e integrazioni e quindi su Token API.

  2. Scegli Aggiungi token API.

  3. Per Descrizione, inserisci una breve descrizione per il token API.

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

  2. Scegli la scheda Crea per il tuo team.

  3. Scegli Zendesk Suite tra le opzioni disponibili.

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

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

  6. Scegli Next (Successivo).

  7. Controlla le azioni per Zendesk Suite e scegli Avanti.

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

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

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