This plugin is bundled with Discourse core. There is no need to install the plugin separately.
Features
Create Zendesk tickets
This plugin allows you to create Zendesk tickets from Discourse topics. This can be done either by configuring the plugin so that all topics in a category automatically generate Zendesk tickets, or by pushing individual topics to Zendesk by clicking the “Create Zendesk Ticket” button that’s displayed for site staff below each topic:
When the ticket is created, the author of the topic’s first post will be set as the Requester on Zendesk. They will also be added to your Zendesk customers list.
After the ticket has been created, the “Create Zendesk Ticket” button will be updated to “View on Zendesk.” Clicking that button will take you to the associated Zendesk ticket:
The plugin allows you to optionally push all replies to the Discourse topic to the Zendesk ticket, or to only push replies created by the topic’s author. Both of these features are configurable via the plugin’s settings.
Sync Zendesk comments with Discourse
Zendesk comment can be synced with the Discourse topic that the ticket originated on.
Configuration
The Discourse Zendesk settings can be accessed from the Plugins page of your Discourse site’s Admin section. Click the “Settings” button for the “discourse-zendesk-plugin” entry on that page to access the settings.
zendesk url : enter the URL of your Zendesk account, followed by api/v2 . For example, https://example.zendesk.com/api/v2
zendesk enabled : used to enable and disable the plugin.
zendesk jobs email : the email address of a staff user on your Zendesk account that also has an admin account on your Discourse site.
zendesk autogenerate all categories (formerly zendesk enable all categories) : if enabled, all topics on your Discourse site will automatically generate Zendesk tickets. This setting is disabled by default.
zendesk autogenerate categories (formerly zendesk enabled categories) : a list of Discourse categories that will have all new topics automatically pushed to Zendesk.
zendesk job push all posts and zendesk job push only author posts : both of these settings are disabled by default. Enable one of them if you want to push either all replies, or only the topic author’s replies to Zendesk.
sync comments from zendesk and zendesk incoming webhook token : these two settings are used to sync comments from Zendesk to Discourse. Details about how to configure syncing Zendesk comments to Discourse are here: How to enable Zendesk two-way sync
zendesk tags : an optional list of tags to append to all Zendesk tickets that originate on your Discourse site.
Mi piacerebbe fare una richiesta di funzionalitĂ per questa integrazione di Zendesk:
La possibilità sia di inviare risposte a Zendesk come commenti, sia di estrarre commenti da Zendesk come risposte è fondamentale per noi. Tuttavia, l’unico modo per eseguire quest’ultima operazione è avere argomenti di categorie Discourse specificati che creino automaticamente ticket Zendesk.
In Zendesk, quando creiamo “note interne” (note private) in un ticket, quelle note interne non producono un whisper di Discourse.
Ho implementato un webhook in Zendesk per creare un whisper per ogni nota interna, tuttavia, quel whisper viene poi inviato a Zendesk a causa del normale funzionamento del plugin.
Quindi, la mia domanda è: c’è un modo per impedire al plugin di creare un nuovo commento su Zendesk quando creo i whisper dalle note interne, come descritto sopra?
So che posso disabilitare la sincronizzazione per tutti i post, ma l’obiettivo sarebbe non sincronizzare solo quei whisper che creo tramite l’API di Discourse.
Non sono sicuro se questo sia il posto giusto per segnalare un bug, quindi fammi sapere se devo spostarlo altrove.
Stiamo usando questo plugin da qualche settimana e nel complesso ha funzionato bene. Tuttavia, abbiamo riscontrato un problema in cui il plugin sembra sincronizzare i commenti in doppio. Quello che penso stia succedendo è:
L’utente invia un post in Discourse
Viene sincronizzato in Zendesk
Il plugin di sincronizzazione vede il nuovo commento in Zendesk e lo sincronizza nuovamente in Discourse
Ecco cosa stiamo vedendo visivamente, dove John (l’amministratore che ha configurato il plugin) a volte invia duplicati dei messaggi di altri utenti senza il suo intervento. Questo proviene dal plugin di sincronizzazione di Discourse:
Sul lato Zendesk, non vediamo duplicati di Risposte e vediamo solo quella dell’utente (non posso pubblicare una seconda schermata a causa dei limiti di questo forum).
L’espansione della visualizzazione della cronologia del ticket non mostra anomalie su Zendesk.
Qualche idea su cosa potrebbe andare storto o come possiamo eseguire il debug di questo problema?
Ehi Shane! Ho provato a testare questo per vedere se riesco a replicare il problema, ma finora non ho riscontrato lo stesso problema.
Per confermare, sembra che ZD stia semplicemente inviando automaticamente il commento a Discourse. John non sta citando o copiando/incollando il commento?
Hai impostato dei trigger aggiuntivi su ZD quando hai configurato per la prima volta il plugin?
Ho trovato un trigger che, ogni volta che un ticket viene aggiornato e ha il tag discourse, notifica il webhook di sincronizzazione di Discourse tramite una richiesta PUT. Non sono stato io a configurare il plugin, ma potrebbe essere questo il colpevole?
Oltre a questo trigger, non vedo altre automazioni che potrebbero interferire. Ho chiesto ai nostri amministratori di Discourse di restituire un elenco di tutti i commenti di John (inclusi quelli che abbiamo eliminato) in modo da poter incrociare ogni istanza per tentare di trovare una connessione.
Sto usando e apprezzando molto il plugin Zendesk. Tuttavia, è appena successo qualcosa di inaspettato. Quando un altro membro del team (qualcuno che in precedenza era un agente in Zendesk) ha risposto a una discussione in Discourse, Zendesk ha inviato il messaggio di nuovo a Discourse. Quindi, è stato pubblicato nel topic di Discourse due volte, una volta dall’autore del messaggio che lo ha pubblicato in Discourse e di nuovo dall’assegnatario corrente del ticket in Zendesk.
Qualcuno ha riscontrato questo problema e ha una soluzione?
Sto riscontrando un problema per cui gli argomenti privati creati sul lato community non vengono generati in Zendesk. Qualcuno potrebbe fornire indicazioni su eventuali impostazioni o configurazioni specifiche necessarie per garantire che gli argomenti privati vengano sincronizzati correttamente con Zendesk?
Vedo che i pulsanti “Crea/Visualizza ticket Zendesk” sono visibili solo allo staff.
Potrebbe essere controllata la visibilitĂ di questi pulsanti da nuove impostazioni del plugin zendesk_create_ticket_allowed_groups e zendesk_view_ticket_allowed_groups per una maggiore flessibilitĂ ?
Non voglio necessariamente concedere ruoli di amministratore o moderatore ai nostri team di supporto. Sono ovviamente gli amministratori del loro dominio (Zendesk), ma IMHO ciò non giustifica sempre privilegi estesi su Discourse.
Questo plugin è ora incluso nel core di Discourse come parte di Bundling more popular plugins with Discourse core. Se stai ospitando autonomamente e utilizzi il plugin, devi rimuoverlo dal tuo app.yml prima del tuo prossimo aggiornamento.