Intégration Zendesk n8nAutomatiser Zendesk avec n8n.

Ouvre un ticket dans Zendesk à partir des données déjà présentes dans le workflow, et renvoie le ticket créé avec son identifiant pour les nœuds suivants.

• Description : le premier commentaire du ticket, et le seul champ obligatoire. Il vient en général de l'item entrant, par exemple {{ $json.message }}.
• Subject : dans Additional Fields, facultatif pour l'API mais c'est la ligne que l'agent lit dans sa file.
• Type : Question, Incident, Problem ou Task, ce qui oriente le tri.
• Group Name or ID : le groupe à qui le ticket est assigné, depuis la liste ou par expression.

Efface un ticket définitivement. Zendesk range les tickets normaux et les tickets suspendus à deux endroits distincts, donc le nœud demande dans quelle pile chercher avant de supprimer quoi que ce soit.

• Ticket Type : Regular ou Suspended. Se tromper ne renvoie rien à supprimer, plutôt que de supprimer le mauvais ticket.
• Ticket ID : l'identifiant numérique, pas le sujet, souvent repris tel quel avec {{ $json.id }}.

Lit un ticket et renvoie son contenu complet : statut, demandeur, groupe, tags et valeurs des champs personnalisés, disponibles en JSON pour la suite du workflow.

• Ticket Type : Regular pour la file active, Suspended pour inspecter un message retenu avant de décider de son sort.
• Ticket ID : l'identifiant du ticket à lire, typiquement celui que le trigger vient de livrer.

Liste des tickets en masse et accepte la syntaxe de recherche Zendesk, ce qui en fait l'opération de reporting du nœud.

• Ticket Type : obligatoire, et il change tout le jeu de résultats.
• Return All : activé, n8n parcourt toutes les pages ; désactivé, Limit plafonne le nombre de tickets renvoyés.
• Query : dans Options, la chaîne de recherche Zendesk qui restreint la liste.
• Status et Group Name or ID : filtrent sur un état ou sur une équipe.
• Sort By et Sort Order : tri par Created At, Priority, Status ou Updated At, croissant ou décroissant.

Ramène un ticket suspendu dans la file normale, où il redevient un ticket comme les autres : assignable, répondable, clôturable.

• Suspended Ticket ID : l'identifiant issu de la liste des suspendus, qui n'est pas celui que le ticket portera une fois réintégré.

Applique des modifications à un ticket existant, du simple changement de statut à une réponse publique rédigée par un autre nœud.

• Ticket ID : obligatoire, le ticket concerné.
• Public Reply : la réponse visible par le demandeur. Internal Note reste entre agents et accepte du HTML.
• Status : New, Open, Pending, On-Hold, Solved ou Closed.
• Assignee Email : confie le ticket à un agent via son adresse.
• Tag Names or IDs : attention, Zendesk remplace toute la liste de tags, donc un tag absent de l'appel est retiré. Lis le ticket et fusionne avant, ou ajoute les tags via HTTP Request.

Renvoie la définition d'un champ de ticket : son titre, son type et, pour une liste déroulante, les valeurs d'option que Zendesk accepte.

• Ticket Field ID : l'identifiant numérique du champ, visible dans l'URL d'administration de ce champ.

Liste les champs système et les champs personnalisés en un appel, la façon la plus rapide de découvrir ce qu'une instance Zendesk stocke réellement sur un ticket.

• Return All : activé pour le catalogue complet des champs ; désactivé, Limit arrête la liste plus tôt.

Ajoute une personne dans Zendesk, comme utilisateur final, agent ou admin, et renvoie la fiche avec l'identifiant réutilisé partout ailleurs.

• Name : le seul champ obligatoire, le nom affiché.
• Email : l'adresse principale, dans Additional Fields, celle sur laquelle Zendesk rattache les mails entrants.
• Role : End User, Agent ou Admin.
• Organization Name or ID : l'organisation par défaut de la personne.
• Verified : activé, Zendesk considère l'identité comme confirmée et n'envoie pas le mail de vérification.

Retire une personne de Zendesk. Ses tickets restent, la fiche disparaît : cette opération se place en fin de workflow, jamais au milieu.

• User ID : l'identifiant numérique de la fiche, récupéré par une recherche plutôt que saisi à la main.

Lit une fiche et renvoie tout ce qu'elle contient : rôle, organisation, tags, langue, notes et champs utilisateur personnalisés.

• User ID : l'identifiant de la fiche à lire, souvent {{ $json.requester_id }} récupéré depuis un ticket.

Liste les utilisateurs du compte, avec un filtre sur le rôle quand seule une partie de l'annuaire intéresse le workflow.

• Return All : activé pour parcourir tout l'annuaire ; désactivé, Limit fixe le plafond.
• Roles : dans Filters, garde End User, Agent, Admin ou n'importe quelle combinaison des trois.

Renvoie les organisations auxquelles une personne appartient. Zendesk autorise plusieurs rattachements par utilisateur, et c'est l'opération qui les montre tous, pas seulement celui par défaut.

• User ID : la fiche dont on liste les rattachements.

Restitue les données que Zendesk tient autour d'une personne, c'est-à-dire ce qui gravite autour de la fiche plutôt que la fiche elle-même.

• User ID : la fiche à inspecter.

Trouve des personnes sans connaître leur identifiant Zendesk, ce qui correspond à la situation réelle de la plupart des workflows.

• Query : dans Filters, du texte libre comparé à l'annuaire, en pratique une adresse email.
• External ID : l'identifiant venu de ton propre système, s'il a été stocké sur la fiche à la création.
• Return All et Limit : contrôlent le nombre de correspondances ramenées, utile quand une requête ratisse plus large que prévu.

Réécrit des champs sur une fiche existante, un par un ou par lot, et renvoie la fiche mise à jour.

• User ID : obligatoire, la fiche modifiée.
• Email, Phone, Name : les coordonnées, dans Update Fields.
• Organization Name or ID : déplace la personne vers un autre compte.
• Role et Ticket Restriction : changent ce que la personne peut faire et quels tickets elle voit, parmi Organization, Groups, Assigned et Requested.
• Suspended : activé, la personne ne peut plus se connecter et ses tickets sont suspendus aussi.

Renvoie le nombre d'organisations du compte, sous forme d'un seul chiffre et non d'une liste. C'est l'appel le plus léger du nœud : rien à paginer, rien à filtrer.

Enregistre une entreprise dans Zendesk et la renvoie avec son identifiant, prête à être rattachée à des utilisateurs et à des tickets.

• Name : obligatoire, et c'est le libellé sur lequel les agents cherchent.
• Domain Names : les domaines séparés par des virgules. Zendesk s'en sert pour rattacher automatiquement les nouveaux contacts à cette organisation.
• Details et Notes : l'adresse et le contexte à lire avant de répondre.
• Tag Names or IDs : les tags portés par l'organisation, depuis la liste ou par identifiant.

Supprime une organisation du compte. Ses membres ne partent pas avec elle, ils se retrouvent simplement sans société rattachée, et leurs tickets restent en place.

• Organization ID : l'identifiant numérique de la fiche à retirer, que le workflow lit dans un nœud précédent plutôt que de le garder en dur.

Lit une fiche entreprise et renvoie tout ce qui y est stocké : domaines, notes, tags et champs d'organisation personnalisés.

• Organization ID : l'identifiant de la fiche à lire, souvent obtenu par user.getOrganizations plus tôt dans le workflow.

Liste les entreprises du compte, ce qui permet à un système externe d'avoir une vue complète du parc client Zendesk.

• Return All : activé, toutes les pages d'organisations sont récupérées ; désactivé, Limit décide où la liste s'arrête.

Restitue les données liées que Zendesk tient autour d'une entreprise, plutôt que la fiche de l'entreprise elle-même : c'est ce qu'il faut quand la question porte sur l'activité et pas sur les coordonnées.

• Organization ID : l'entreprise à inspecter, en général résolue plus tôt dans l'exécution à partir du demandeur rattaché au ticket.

Modifie une fiche entreprise sur place, ce qui conserve les tickets et les rattachements pendant que les détails changent.

• Organization ID : obligatoire, la fiche éditée.
• Name : dans Update Fields, pour un changement de marque ou une faute corrigée.
• Domain Names : la liste de domaines séparés par des virgules, à mettre à jour quand une société en ajoute un second.
• Notes et Details : le contexte que les agents lisent avant de répondre.
• Tag Names or IDs : les tags portés par l'organisation.