Résumé
Dans cette documentation, nous allons couvrir :
- Activation des paramètres de synchronisation Zendesk dans Discourse
- Configuration d’un webhook Zendesk
- Configuration d’un déclencheur (trigger) Zendesk
Activation des paramètres de synchronisation Zendesk
Pour commencer, vous devrez activer le plugin Zendesk, activer le paramètre de synchronisation et fournir un jeton sécurisé.
- Accéder aux paramètres du plugin : Accédez à votre site Discourse et naviguez jusqu’à la page des paramètres du plugin Zendesk à l’adresse
/admin/plugins/discourse-zendesk-plugin. Alternativement, vous pouvez trouver les paramètres en effectuant une recherche sur/admin/site_settings. - Activer le plugin : Trouvez et activez le paramètre
zendesk enableds’il n’est pas déjà activé. - Activer le paramètre de synchronisation : Trouvez et activez le paramètre
sync comments from zendesk. - Fournir le jeton de webhook : Dans le champ
zendesk incoming webhook token, générez et ajoutez une chaîne sécurisée aléatoire. Ce jeton sera utilisé plus tard pour configurer le webhook de Zendesk. - Configurer les catégories de génération automatique : La synchronisation bidirectionnelle ne fonctionne que pour les sujets dans les catégories configurées pour la génération automatique de tickets Zendesk. Activez
zendesk autogenerate all categoriesou ajoutez des catégories spécifiques au paramètrezendesk autogenerate categories. Sans cela, le webhook ignorera silencieusement les commentaires entrants.
Configuration d’un webhook Zendesk
Suivez ces étapes pour configurer un webhook dans Zendesk :
- Accéder à la page des Webhooks : Naviguez vers la section Webhooks dans Zendesk sous Apps et intégrations → Webhooks.
- URL d’exemple :
https://\u003cinstance_name\u003e.zendesk.com/admin/apps-integrations/webhooks/webhooks
- URL d’exemple :
- Créer un Webhook :
- Cliquez sur le bouton Actions dans le coin supérieur droit.
- Sélectionnez Créer un Webhook.
- Remplissez les détails du webhook :
- Méthode de requête :
PUT - URL du point de terminaison :
https://\u003cdiscourse.example.com\u003e/zendesk-plugin/sync - Format de la requête : JSON
- Méthode de requête :
- Tester le Webhook :
- Cliquez sur le bouton Tester le webhook.
- Sélectionnez ‘Test personnalisé’ dans le menu déroulant.
- Remplacez le JSON par ce qui suit, en insérant votre jeton :
{
"ticket_id": "{{ticket.id}}",
"topic_id": "{{ticket.external_id}}",
"email": "{{current_user.email}}",
"token": "INSERT TOKEN HERE"
}
- Cliquez sur Envoyer le test. Attendez-vous à un
400 Bad Requestcomme signal positif avec la page HTML affichée indiquant le succès.
Configuration d’un déclencheur Zendesk
Configurez un déclencheur dans Zendesk pour automatiser les actions :
- Accéder à la page des déclencheurs : Accédez à la section Déclencheurs dans Zendesk sous Admin → Objets et règles → Règles de gestion → Déclencheurs.
- URL d’exemple :
https://\u003cinstance_name\u003e.zendesk.com/admin/objects-rules/rules/triggers
- URL d’exemple :
- Créer un Déclencheur :
- Cliquez sur Ajouter un déclencheur.
- Nommez-le “Discourse Sync” et définissez la catégorie sur “Notifications”.
- Configurez les conditions et les actions comme illustré ci-dessous.
- Utilisez le même corps JSON que lors de l’étape de test du webhook, en remplaçant à nouveau “INSERT TOKEN HERE” par votre jeton.
- Enregistrer le Déclencheur : Une fois configuré, assurez-vous d’enregistrer le déclencheur.
Cependant, il y a un problème lorsqu’un commentaire dans Zendesk contient une pièce jointe : le message arrive, mais la pièce jointe est manquante. Je ne suis pas sûr s’il faut passer un paramètre supplémentaire dans le webhook pour gérer les pièces jointes. Quelqu’un pourrait-il clarifier s’il existe des paramètres spécifiques requis pour cela ?
