 |
Riepilogo | Crea ticket Zendesk da argomenti Discourse. |
 |
Guida all’installazione | Questo plugin è incluso nel core di Discourse. Non è necessario installarlo separatamente. |
Poiché Zendesk disattiverà permanentemente l’autenticazione tramite token API il 30 aprile 2027, le installazioni esistenti devono migrare all’autenticazione tramite OAuth.
Funzionalità
Creazione di ticket Zendesk
Questo plugin consente di creare ticket Zendesk da argomenti Discourse. È possibile farlo configurando il plugin in modo che tutti gli argomenti in una categoria generino automaticamente ticket Zendesk, oppure spingendo singoli argomenti su Zendesk facendo clic sul pulsante “Crea ticket Zendesk” visualizzato per lo staff del sito sotto ogni argomento:
Quando il ticket viene creato, l’autore del primo post dell’argomento verrà impostato come Richiedente su Zendesk. Verrà inoltre aggiunto all’elenco dei clienti Zendesk.
Dopo la creazione del ticket, il pulsante “Crea ticket Zendesk” verrà aggiornato a “Visualizza su Zendesk”. Facendo clic su quel pulsante, verrai reindirizzato al ticket Zendesk associato:
Invio delle risposte create su Discourse a Zendesk
Il plugin consente di inviare facoltativamente tutte le risposte all’argomento Discourse al ticket Zendesk, oppure di inviare solo le risposte create dall’autore dell’argomento. Entrambe queste funzionalità sono configurabili tramite le impostazioni del plugin.
Sincronizzazione dei commenti Zendesk con Discourse
I commenti Zendesk possono essere sincronizzati con l’argomento Discourse da cui è stato originato il ticket.
Configurazione
Le impostazioni di Discourse Zendesk sono accessibili dalla pagina Plugin della sezione Admin del tuo sito Discourse. Clicca sul pulsante “Impostazioni” per la voce “discourse-zendesk-plugin” in quella pagina.
Configurazione di OAuth
Innanzitutto, crea un client OAuth in Zendesk:
- Nell’Admin Center di Zendesk, vai su App e integrazioni > API > Clienti OAuth.
- Clicca su Aggiungi client OAuth.
- Inserisci un nome, una descrizione e seleziona Confidenziale come tipo di client. Non è richiesta un’URL di reindirizzamento.
- Configura gli Scope su
tickets:read,tickets:write,users:readeusers:writeper limitare il client OAuth solo agli scope richiesti dal plugin. - Salva il client.
- Copia l’Identificatore e il Segreto del client. Zendesk visualizza il segreto completo solo una volta.
Configura queste impostazioni di Discourse:
zendesk oauth client id: inserisci l’Identificatore del client OAuth.zendesk oauth client secret: inserisci il Segreto del client OAuth.
Altre impostazioni
-
zendesk url: inserisci l’URL del tuo account Zendesk seguito da/api/v2. Ad esempio,https://example.zendesk.com/api/v2. -
zendesk enabled: abilita o disabilita il plugin. -
zendesk jobs api token: Non supportato. Le installazioni esistenti dovrebbero migrare a OAuth. -
zendesk jobs email: Non supportato. Le installazioni esistenti dovrebbero migrare a OAuth. -
zendesk autogenerate all categories(precedentementezendesk enable all categories): crea automaticamente ticket Zendesk per gli argomenti in tutte le categorie. Questa impostazione è disabilitata per impostazione predefinita. -
zendesk autogenerate categories(precedentementezendesk enabled categories): seleziona le categorie Discourse i cui nuovi argomenti dovrebbero creare automaticamente ticket Zendesk. -
zendesk job push all posts: invia le risposte a Zendesk come commenti al ticket. Questa impostazione è abilitata per impostazione predefinita. -
zendesk job push only author posts: invia solo le risposte scritte dall’autore originale dell’argomento. Questa impostazione si applica quandozendesk job push all postsè abilitato ed è disabilitata per impostazione predefinita. -
sync comments from zendeskezendesk incoming webhook token: sincronizza i commenti da Zendesk a Discourse. Vedi Come abilitare la sincronizzazione bidirezionale con Zendesk. -
zendesk tags: un elenco opzionale di tag da aggiungere ai ticket Zendesk creati da Discourse.