Discourse Zendesk

[Discourse]

	Résumé	Créer des tickets Zendesk à partir des sujets Discourse.
	Guide d’installation	Ce plugin est inclus dans le cœur de Discourse. Il n’est pas nécessaire d’installer le plugin séparément.

En tant que plugin #officiel maintenu par l’équipe Discourse, les demandes de Support, Contribute > Bug, Contribute > UX et Contribute > Feature peuvent être faites dans les catégories respectives ici sur Meta, et étiquetées avec l’étiquette de plugin appropriée. Cliquez sur un lien ci-dessous pour en démarrer une.

 Support  Bug  UX  Fonctionnalité

Étant donné que Zendesk désactivera définitivement l’authentification par jeton API le 30 avril 2027, les installations existantes doivent migrer vers l’authentification via OAuth.

Fonctionnalités

Création de tickets Zendesk

Ce plugin vous permet de créer des tickets Zendesk à partir des sujets Discourse. Cela peut se faire en configurant le plugin pour que tous les sujets d’une catégorie génèrent automatiquement des tickets Zendesk, ou en envoyant des sujets individuels vers Zendesk en cliquant sur le bouton « Créer un ticket Zendesk » qui s’affiche pour le personnel du site sous chaque sujet :

Lors de la création du ticket, l’auteur du premier message du sujet sera défini comme Demandeur sur Zendesk. Il sera également ajouté à votre liste de clients Zendesk.

Après la création du ticket, le bouton « Créer un ticket Zendesk » sera mis à jour pour afficher « Voir sur Zendesk ». Cliquer sur ce bouton vous emmènera vers le ticket Zendesk associé :

Envoi des réponses créées sur Discourse vers Zendesk

Le plugin vous permet d’envoyer optionnellement toutes les réponses au sujet Discourse vers le ticket Zendesk, ou uniquement les réponses créées par l’auteur du sujet. Ces deux fonctionnalités sont configurables via les paramètres du plugin.

Synchronisation des commentaires Zendesk avec Discourse

Les commentaires Zendesk peuvent être synchronisés avec le sujet Discourse d’origine du ticket.

Configuration

Les paramètres de Discourse Zendesk sont accessibles depuis la page Plugins de la section Admin de votre site Discourse. Cliquez sur le bouton « Paramètres » pour l’entrée « discourse-zendesk-plugin » sur cette page.

Configuration d’OAuth

Tout d’abord, créez un client OAuth dans Zendesk :

1. Dans le Centre d’administration Zendesk, allez dans Applications et intégrations > API > Clients OAuth.
2. Cliquez sur Ajouter un client OAuth.
3. Entrez un nom, une description et sélectionnez Confidentiel comme type de client. Une URL de redirection n’est pas requise.
4. Configurez les Portées sur tickets:read, tickets:write, users:read et users:write pour restreindre le client OAuth aux seules portées requises par le plugin.
5. Enregistrez le client.
6. Copiez l’Identifiant et le Secret du client. Zendesk n’affiche le secret complet qu’une seule fois.

Configurez ces paramètres Discourse :

• zendesk oauth client id : entrez l’Identifiant du client OAuth.
• zendesk oauth client secret : entrez le Secret du client OAuth.

Autres paramètres

• zendesk url : entrez l’URL de votre compte Zendesk suivie de /api/v2. Par exemple, https://example.zendesk.com/api/v2.

• zendesk enabled : activez ou désactivez le plugin.

• zendesk jobs api token : Obsolète. Les installations existantes doivent migrer vers OAuth.

• zendesk jobs email : Obsolète. Les installations existantes doivent migrer vers OAuth.

• zendesk autogenerate all categories (anciennement zendesk enable all categories) : crée automatiquement des tickets Zendesk pour les sujets de toutes les catégories. Ce paramètre est désactivé par défaut.

• zendesk autogenerate categories (anciennement zendesk enabled categories) : sélectionnez les catégories Discourse dont les nouveaux sujets doivent créer automatiquement des tickets Zendesk.

• zendesk job push all posts : envoie les réponses vers Zendesk en tant que commentaires de ticket. Ce paramètre est activé par défaut.

• zendesk job push only author posts : n’envoie que les réponses écrites par l’auteur original du sujet. Ce paramètre s’applique lorsque zendesk job push all posts est activé et est désactivé par défaut.

• sync comments from zendesk et zendesk incoming webhook token : synchronise les commentaires de Zendesk vers Discourse. Voir Comment activer la synchronisation bidirectionnelle Zendesk.

• zendesk tags : une liste facultative d’étiquettes à ajouter aux tickets Zendesk créés depuis Discourse.