Intégration Zammad n8nAutomatiser Zammad avec n8n.

Les groupes sont les files dans lesquelles atterrissent les tickets. Cette opération en crée une depuis un workflow, sans passer par l'écran d'administration. Utile quand une nouvelle équipe ou une nouvelle offre a besoin de sa propre file.

• Group Name : le seul champ requis, le libellé que les agents verront dans le sélecteur de file, souvent alimenté par une expression comme {{ $json.team }}.
• Additional Fields : trois entrées optionnelles, Active pour ouvrir ou geler la file tout de suite, Notes pour la description interne, Custom Fields pour les champs ajoutés à ton instance.

Retire une file de l'instance. À réserver à la fin d'un workflow de nettoyage, pas à une exécution horaire : le nœud n'offre aucune opération inverse pour rattraper le coup.

• Group ID : l'identifiant du groupe, pas son nom. Il se remplit par expression, typiquement {{ $json.id }} récupéré depuis une étape Get many groups.

Lit un groupe et renvoie sa fiche. Un workflow s'en sert pour confirmer qu'une file existe, et pour relire ses notes, avant d'y router quoi que ce soit.

• Group ID : le groupe à récupérer. Le champ accepte une expression, une valeur portée par un nœud précédent s'y branche directement.

Renvoie les groupes configurés sur l'instance. C'est le moyen le plus court de transformer des noms de files en identifiants, que réclament toutes les autres opérations Group.

• Return All : coché, n8n demande à l'API de Zammad page après page jusqu'à ramener tous les groupes. Décoché, l'exécution s'arrête à Limit.
• Limit : le nombre maximal de groupes renvoyés quand Return All reste décoché, pratique le temps de mettre au point un workflow.

Modifie une file en place. Renommer une équipe ou geler une file pendant une migration passe par ici, plutôt que par une suppression suivie d'une recréation qui ferait perdre l'identifiant.

• Group ID : désigne la file à modifier, obligatoire même pour un seul champ.
• Update Fields : quatre entrées optionnelles, Group Name pour le nouveau libellé, Active pour geler ou rouvrir, Notes, Custom Fields.

Les entreprises existent dans Zammad sous forme d'organisations. Cette opération en crée une à partir de ce qu'envoie un CRM ou un formulaire, pour que les tickets suivants se rattachent à un compte et non à une adresse orpheline.

• Organization Name : requis, le nom de l'entreprise affiché sur chaque ticket lié.
• Additional Fields : sept entrées optionnelles. Domain couplé à Domain Assignment rattache les utilisateurs selon leur domaine d'email, VIP signale un compte clé, puis Shared, Active, Notes et Custom Fields.

Sort une fiche entreprise de l'instance. À placer derrière une étape de validation dans un workflow d'hygiène des données, parce que d'autres enregistrements pointent vers une organisation et que rien dans le nœud ne la remet en place.

• Organization ID : la fiche à supprimer, renseignée par expression quand la valeur vient d'un nœud précédent.

Récupère une organisation et renvoie ses champs, notes et indicateur VIP compris, ceux qu'un agent irait autrement lire dans un onglet de navigateur.

• Organization ID : la fiche à lire. Un nom d'entreprise ne marchera pas ici, le champ attend l'identifiant.

Lit la liste des organisations. C'est l'opération d'export de la ressource, celle qui alimente les tableaux de suivi qui vivent en dehors du support.

• Return All : activé, toutes les organisations reviennent page après page, ce qu'exige un export complet.
• Limit : avec Return All désactivé, ce champ plafonne le nombre d'organisations renvoyées par exécution.

Applique des changements à une entreprise déjà présente. Rien n'est requis au-delà de l'identifiant, un workflow peut donc toucher un seul champ et laisser le reste de la fiche intact.

• Organization ID : la fiche à modifier.
• Update Fields : sept entrées optionnelles, le même jeu qu'à la création. VIP et Active changent le traitement du compte, Domain et Domain Assignment changent qui s'y rattache.

La plupart des workflows Zammad se terminent sur cette opération. Elle ouvre un ticket dans une file choisie, pour un client connu, avec un premier message attaché.

• Title : requis, ce que les agents lisent en balayant la file.
• Group Name or ID : requis, la file propriétaire du ticket. À choisir dans la liste, First-Level Helpdesk par exemple, ou à passer par expression.
• Customer Email Name or ID : requis, l'adresse email du client concerné, du type {{ $json.email }}.
• Article : requis, le premier message, avec Body, Article Type (chat, email, fax, note, phone ou sms) et Visibility, où internal reste réservé au support.

Supprime un ticket à partir de son identifiant. Rarement dans un flux de routine, plutôt en étape de nettoyage pour les tickets de test ou pour les doublons créés par une boucle qui a tourné deux fois.

• Ticket ID : le ticket à supprimer, donné comme identifiant via une expression quand il vient d'une étape antérieure.

Récupère un ticket avec ses champs à l'instant T. C'est ainsi qu'un workflow lit l'état, le propriétaire et la priorité avant de décider de la suite.

• Ticket ID : le ticket à lire, passé comme identifiant, le plus souvent {{ $json.id }} depuis l'item qui a ouvert la branche.

Liste les tickets de l'instance. Associée à un Schedule Trigger, c'est ce qui ressemble le plus à un déclencheur ici, puisque Zammad n'a pas de nœud trigger dans n8n.

• Return All : coché, n8n enchaîne les pages jusqu'à récupérer la liste entière, ce dont un reporting a besoin.
• Limit : Return All décoché, ce champ fixe le nombre maximal de tickets renvoyés, suffisant pour un résumé quotidien.

C'est ici que se joue l'essentiel de l'automatisation quotidienne. Un seul appel réaffecte, repriorise, change l'état et dépose une note interne sur le même ticket.

• Ticket ID : la seule valeur requise.
• Update Fields : neuf entrées optionnelles. State, Priority, Owner, Group et Customer viennent de listes ou d'expressions, Note ajoute un commentaire interne, Title réécrit le sujet.
• Pending Time : la date et l'heure de réactivation d'un ticket en attente, requise pour les états pending reminder, pending close et snooze.

Ajoute une personne dans Zammad. Deux noms suffisent à créer la fiche, tout le reste voyage dans la collection optionnelle.

• First Name et Last Name : les deux champs requis, John et Smith dans les exemples du nœud.
• Additional Fields : 13 entrées optionnelles. Email Address compte le plus, puisque la création de ticket identifie un client par son email, puis Organization Name or ID, Phone (Mobile), Department, VIP et Verified.

Efface une fiche utilisateur. L'identifiant est la seule entrée, ce qui rend l'opération facile à câbler et tout aussi facile à déclencher par erreur. Mets un filtre devant.

• User ID : la fiche à retirer, indiquée par expression quand la valeur arrive d'un nœud précédent.

Lecture d'une fiche unique. Renvoie la personne derrière un identifiant, avec son organisation, ses coordonnées et les indicateurs renseignés.

• User ID : l'identifiant de l'utilisateur à lire, pas son adresse email.

Cherche dans la base des utilisateurs et renvoie une liste. Cette opération embarque une collection Filters que les autres listes n'ont pas, ce qui en fait une vraie recherche plutôt qu'un déversement.

• Query : une chaîne de recherche comme user.firstname:john, qui restreint le résultat avant qu'il n'arrive dans n8n.
• Sort : ordonne les résultats à la sortie.
• Return All et Limit : tous les résultats, ou un nombre plafonné le temps d'affiner la requête.

Renvoie le compte sous lequel le credential s'authentifie, avec son identifiant et ses informations telles que Zammad les stocke. Rien à configurer : pas d'identifiant de fiche, pas d'expression, pas de collection optionnelle. C'est donc le moyen le plus rapide de prouver qu'un credential fonctionne avant de construire quoi que ce soit dessus.

Maintient une fiche contact à jour. L'identifiant décide qui change, la collection optionnelle décide quoi, et les champs non renseignés restent en l'état.

• User ID : requis, la fiche à modifier.
• Update Fields : 15 entrées optionnelles, la collection la plus large du nœud. Organization Name or ID déplace quelqu'un vers une autre entreprise, Email Address, Phone (Landline) et Website rafraîchissent les coordonnées, Active retire un compte de la circulation sans l'effacer.