Passer au contenu principal

Intégration Zendesk - Guide de configuration

Connecte ton compte Zendesk à Goodweek pour gérer les tickets d'assistance, les organisations, les utilisateurs, les macros et les vues directement depuis ton espace de travail IA.

A
Écrit par Antoine Stempien

Connecte ton compte Zendesk à Goodweek pour gérer les tickets d'assistance, les organisations, les utilisateurs, les macros et les vues directement depuis ton espace de travail IA.

ℹ️ Note sur la gouvernance

Goodweek ne dépassera jamais les niveaux d'accès accordés à l'utilisateur au sein de Zendesk, garantissant ainsi l'alignement avec les politiques de gouvernance de ton organisation. Les résultats et les fonctionnalités disponibles peuvent varier selon les autorisations spécifiques et l'accès authentifié de chaque utilisateur.

📋 Prérequis

Avant qu'un utilisateur puisse voir et connecter l'intégration Zendesk, l'administrateur de ton organisation doit d'abord l'activer depuis le Panneau d'administration Goodweek, dans l'onglet Intégrations.

Configuration administrateur

L'intégration Zendesk utilise OAuth 2.0. L'utilisateur qui effectue la connexion doit disposer du rôle Zendesk approprié pour autoriser les applications tierces. Un accès de niveau administrateur est requis pour certains outils, comme la configuration des déclencheurs, des automatisations ou des champs personnalisés.

Connexion de l'utilisateur

  1. Dans Goodweek, accède à Intégrations.

  2. Trouve Zendesk et clique sur Connecter.

  3. Il te sera demandé de saisir ton sous-domaine Zendesk (par exemple yourcompany pour yourcompany.zendesk.com).

  4. Tu seras redirigé vers Zendesk, où il te sera demandé de te connecter et d'autoriser l'accès.

  5. Clique sur Autoriser pour accorder l'accès et revenir à Goodweek.

Remarques importantes

  • Chaque utilisateur doit connecter son propre compte individuellement.

  • Goodweek ne peut accéder qu'aux tickets, organisations et données que ton compte Zendesk individuel est autorisé à consulter. Les restrictions de visibilité des agents s'appliquent.

  • Certains outils (déclencheurs, automatisations, champs personnalisés, vues) nécessitent le rôle Administrateur Zendesk. Les agents standards n'auront pas accès à ces outils.

  • Tu peux révoquer l'accès de Goodweek à tout moment depuis Zendesk → Centre d'administration → Applications et intégrations → Connexions → Composio → Révoquer.


Outils disponibles

Outil

Description

Type

Create Zendesk Ticket

Crée un nouveau ticket d'assistance dans Zendesk avec une prise en charge complète de tous les champs du ticket.

Écriture

Create Many Zendesk Tickets

Crée jusqu'à 100 tickets en une seule requête, traitée comme une tâche en arrière-plan.

Écriture

Get Zendesk About Me

Récupère les informations sur l'utilisateur Zendesk actuellement authentifié.

Lecture

Show Changes to Ticket

Affiche les modifications qui résulteraient de l'application d'une macro spécifique à un ticket.

Lecture

Get Incremental Tickets

Récupère les tickets modifiés depuis une heure de début spécifiée pour une synchronisation incrémentielle.

Lecture

List Deleted Tickets

Répertorie les tickets qui ont été supprimés de manière réversible (soft-delete) dans Zendesk, en affichant jusqu'à 100 par page.

Lecture

Create Zendesk Request

Crée une nouvelle demande d'assistance d'utilisateur final via l'API.

Écriture

Create Side Conversation

Crée une conversation privée annexe sur un ticket Zendesk pour la communication entre agents.

Écriture

Upload Zendesk Attachment

Téléverse une pièce jointe dans Zendesk, en renvoyant un jeton de pièce jointe à utiliser dans les commentaires du ticket.

Écriture

Create Zendesk User

Crée un nouvel utilisateur (agent ou utilisateur final) dans Zendesk.

Écriture

Create Many Zendesk Users

Crée jusqu'à 100 utilisateurs en une seule requête, traitée de manière asynchrone.

Écriture

Create or Update User

Crée ou met à jour un utilisateur Zendesk en fonction de la correspondance par e-mail ou external_id.

Écriture

Autocomplete Users

Recherche des utilisateurs Zendesk par préfixe de nom pour une recherche rapide d'utilisateurs.

Lecture

Get Incremental Users

Récupère les utilisateurs modifiés depuis une heure de début spécifiée pour une synchronisation incrémentielle.

Lecture

Create Zendesk Organization

Crée une nouvelle organisation dans Zendesk.

Écriture

Get Zendesk Organizations

Répertorie toutes les organisations dans Zendesk avec pagination.

Lecture

Create or Update Organization

Crée ou met à jour une organisation Zendesk en utilisant external_id comme clé de correspondance.

Écriture

Merge Zendesk Organizations

Fusionne deux organisations Zendesk, en combinant les utilisateurs, les tickets et les données.

Écriture

Create Organization Membership

Affecte un utilisateur à une organisation Zendesk.

Écriture

Create Zendesk Group

Crée un nouveau groupe d'agents dans Zendesk.

Écriture

List Assignable Groups

Répertorie tous les groupes pouvant être affectés à des tickets ou à des utilisateurs.

Lecture

List Group Users

Répertorie tous les utilisateurs appartenant à un groupe Zendesk spécifique.

Lecture

Create Zendesk Group Membership

Affecte un agent à un groupe Zendesk.

Écriture

List Macros

Répertorie toutes les macros partagées et personnelles du compte Zendesk.

Lecture

Show Macro

Récupère les détails d'une macro spécifique à partir de son ID.

Lecture

Apply Zendesk Macro Preview

Prévisualise l'effet d'une macro sur un ticket sans l'appliquer.

Lecture

Create View

Crée une nouvelle vue de tickets (filtre enregistré) dans Zendesk.

Écriture

Preview View

Prévisualise les tickets correspondant à un ensemble de conditions de vue avant l'enregistrement de la vue.

Écriture

List Active Triggers

Répertorie tous les déclencheurs de tickets actifs du compte Zendesk.

Lecture

Create Trigger

Crée un nouveau déclencheur de règle métier qui agit sur les tickets répondant aux conditions spécifiées.

Écriture

List Automations

Répertorie toutes les automatisations configurées dans le compte Zendesk.

Lecture

Create Automation

Crée une nouvelle automatisation qui effectue des actions sur les tickets selon des conditions basées sur le temps.

Écriture

List Brands

Répertorie toutes les marques configurées dans le compte Zendesk.

Lecture

Create Ticket Field

Crée un nouveau champ de ticket personnalisé avec différents types de champ.

Écriture

Create Custom Object Record

Crée un nouvel enregistrement pour un type d'objet personnalisé dans Zendesk.

Écriture

Get Account Settings

Récupère les paramètres du compte Zendesk et la configuration des fonctionnalités.

Lecture

Get Attachment

Récupère les détails d'une pièce jointe Zendesk unique à partir de son ID.

Lecture

List Guide Surveys

Répertorie les enquêtes CSAT disponibles dans Zendesk Guide.

Lecture

List Guide Survey Responses

Répertorie les réponses aux enquêtes CSAT de Zendesk Guide.

Lecture

Delete Zendesk Ticket

Supprime définitivement un ticket, y compris tout son historique de conversation. Cette action est irréversible.

⚠️ Destructif

Delete Zendesk User

Supprime définitivement un utilisateur de Zendesk. Cette action ne peut pas être annulée.

⚠️ Destructif

Delete Zendesk Organization

Supprime définitivement une organisation de Zendesk. Cette action est irréversible.

⚠️ Destructif

Bulk Delete Zendesk Suspended Tickets

Supprime définitivement plusieurs tickets suspendus en une seule action.

⚠️ Destructif

Cas d'usage

  • Créer et gérer des tickets d'assistance depuis les conversations. Enregistre de nouveaux tickets Zendesk avec le bon sujet, la bonne description, le bon demandeur et la bonne priorité directement depuis une conversation Goodweek, en gardant les opérations d'assistance dans le contexte du reste de ton travail.

  • Gérer les utilisateurs et les organisations. Crée ou met à jour des utilisateurs et des organisations Zendesk, affecte des utilisateurs à des groupes et gère les appartenances aux organisations depuis Goodweek afin de garder ta structure d'assistance à jour.

  • Examiner les macros et les déclencheurs avant de les appliquer. Prévisualise l'effet des macros ou des conditions de vue sur les tickets depuis Goodweek avant de valider les modifications, ce qui réduit le risque d'une mauvaise configuration accidentelle.

  • Suivre le CSAT et les réponses aux enquêtes. Récupère les résultats et les réponses aux enquêtes CSAT de Zendesk Guide au sein d'une conversation Goodweek pour consulter les données de satisfaction client sans avoir à naviguer dans le tableau de bord Zendesk Explore.


Dépannage

Certains outils ne fonctionnent pas après la connexion

Certains outils Zendesk nécessitent le rôle Administrateur. Si tu te connectes avec un compte Agent, les outils de niveau administrateur ne seront pas accessibles. Contacte ton administrateur Zendesk pour ajuster ton rôle si nécessaire.

L'intégration n'est pas visible dans Goodweek

Assure-toi que l'administrateur de ton organisation a activé l'intégration Zendesk depuis le Panneau d'administration Goodweek, dans l'onglet Intégrations.

Références

Avez-vous trouvé la réponse à votre question ?