Discourse Zendesk

:discourse2: Summary Create Zendesk tickets from Discourse topics.
:open_book: Install Guide 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:

Push replies created on Discourse to Zendesk

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 api token : details for generating the API token on Zendesk are here: Generating a new API token – Zendesk help. Copy that token to this Discourse setting.

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

Last edited by @tobiaseigen 2025-07-16T21:55:24Z

Check documentPerform check on document:
36 Mi Piace

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.

Preferirei molto di più che ci fosse un modo per far sì che anche i ticket Zendesk creati manualmente avessero questa capacità di estrarre commenti come risposte! Questo perché abbiamo un processo di triage in atto in cui solo alcuni argomenti creati dai clienti dovrebbero essere inoltrati a Zendesk. Non vorremmo consentire ai nostri utenti finali di creare anche ticket Zendesk dietro le quinte.

Grazie!

Grazie mille per il plugin, ci ha aiutato molto!

Vorrei un aiuto con il seguente problema:

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

Sai se c’è una soluzione semplice per questo?

1 Mi Piace

Ciao!

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 è:

  1. L’utente invia un post in Discourse
  2. Viene sincronizzato in Zendesk
  3. 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?

Grazie!

6 Mi Piace

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?

3 Mi Piace

Grazie per essere intervenuto! Sì, questo è un problema software, John non sta inviando questi messaggi da solo.

Controllerò i nostri trigger e proverò a disabilitarli e riabilitarli. Sfortunatamente, non ho trovato alcuna somiglianza su quando o perché ciò accade, quindi non ho un modo diretto per riprodurlo.

2 Mi Piace

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.

4 Mi Piace

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?

Ciao,

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?

Grazie in anticipo per il vostro aiuto.

1 Mi Piace

Ho una richiesta di funzionalitĂ  : )

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.

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

1 Mi Piace