Intégration Freshdesk n8nAutomatiser Freshdesk avec n8n.
Un ticket qui reste dans le helpdesk ne sert qu'au support. L'intégration Freshdesk n8n le fait circuler : 10 opérations réparties sur 2 ressources, tickets et contacts, derrière une seule clé API. Freshdesk n'a pas de nœud trigger dans n8n, le workflow démarre donc ailleurs.
Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth
À quoi sert l'intégration Freshdesk n8n ?
Le nœud Freshdesk est livré avec n8n et dialogue avec l'API Freshdesk grâce à une clé API et au sous-domaine de ton compte. Il couvre 2 ressources, Ticket et Contact, avec les mêmes gestes de chaque côté : créer, lire une fiche, en lister plusieurs, modifier, supprimer. Soit 10 opérations, de quoi ouvrir un ticket depuis n'importe quel canal, retrouver la personne derrière, et renvoyer le résultat là où ton équipe regarde vraiment.
Premier usage, la création de ticket depuis un canal que tes clients utilisent déjà. Un message arrive, le workflow le transforme en ticket avec ticket.create, et personne ne retape rien. Le template communautaire 368 fait ça depuis Telegram : message repéré, ticket créé, trace conservée ailleurs dans la même exécution. Renseigne Source avec le canal d'origine et le ticket garde cette information jusqu'à sa clôture.
Deuxième usage, le reporting que personne n'exporte à la main. Un Schedule Trigger, c'est-à-dire un déclencheur qui se lance à intervalle fixe, appelle ticket.getAll avec l'option Updated Since, puis le lot part dans Google Sheets. Le template 4238 part de la même opération pour envoyer une enquête de satisfaction après résolution et stocker les réponses.
Troisième usage, la fiche contact toujours à jour. contact.getAll avec le filtre State isole les adresses jamais confirmées, contact.update réinscrit un tag ou un identifiant d'entreprise dès qu'un autre outil en sait plus. Pour relancer ces personnes par mail, branche SendGrid derrière la liste plutôt que d'exporter un CSV.
Les limites méritent d'être connues avant de construire. Freshdesk n'a pas de nœud trigger dans n8n : rien ne réagit tout seul ici. Le déclencheur vient d'ailleurs, un Schedule Trigger, le nœud Webhook de n8n (une URL qu'un service tiers appelle quand un événement se produit chez lui), ou le trigger d'un autre outil. Le nœud s'arrête aussi aux tickets et aux contacts. Pour tout ce que l'API Freshdesk propose au-delà de ces 2 ressources, le nœud HTTP Request appelle l'endpoint voulu en réutilisant le même credential, donc la clé reste stockée à un seul endroit.
Dernier point à vérifier tôt : certains champs optionnels dépendent du plan Freshdesk. Language et Time Zone réclament la fonctionnalité multi-langue ou multi-fuseau (plan Garden et au-dessus), Other Companies réclame Multiple Companies (plan Estate et au-dessus). Un champ qui reste sans effet vient souvent de là. L'avis n8n détaille le reste de l'outil, et la formation n8n reprend ce montage pas à pas.
Comment connecter Freshdesk à n8n ?
- 01
Récupérer la clé API dans Freshdesk
Freshdesk authentifie n8n avec une clé API, une longue chaîne de caractères qui remplace ton identifiant et ton mot de passe. Elle se récupère depuis ton profil Freshdesk, selon la documentation d'authentification de l'API Freshdesk. Traite-la comme un mot de passe : celui qui l'a peut lire et écrire les tickets du helpdesk. Copie-la au moment où elle s'affiche, c'est la seule valeur que le credential ne peut pas deviner.
- 02
Identifier le domaine, sous-domaine uniquement
Le second champ s'appelle Domain et c'est lui qui bloque la plupart des premières tentatives. Freshdesk attend le sous-domaine seul, pas l'adresse complète. Si tu accèdes à ton helpdesk par
https://n8n.freshdesk.com, la valeur à saisir estn8n. Regarde l'URL de ton navigateur pendant que tu es connecté, prends la partie qui précède.freshdesk.com, et laisse de côté le protocole et la barre oblique finale. - 03
Enregistrer le credential une fois pour toutes
Dans n8n, ouvre le menu Credentials et crée un credential Freshdesk avec ces 2 valeurs : API Key et Domain. Un credential, c'est un accès enregistré une fois et proposé ensuite dans une liste déroulante par chaque nœud qui en a besoin, donc la clé ne se colle jamais dans un workflow. Le même credential sert aussi au nœud HTTP Request via son authentification prédéfinie.
Que sait faire le nœud Freshdesk ?
Le nœud Freshdesk expose 10 opérations sur 2 ressources. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.
Contact
5 opérationsCreate a contact
contact.createCe que tu vois dans n8n
Notes & cas d'usage
Ajoute une personne au répertoire de contacts Freshdesk et renvoie la fiche créée avec son identifiant, utilisable par le nœud suivant.
Paramètres clés
- Name : le seul champ obligatoire, le nom affiché du contact, souvent
{{ $json.name }}repris d'un formulaire ou d'un CRM. - Email : l'adresse principale. Les adresses supplémentaires vont dans Other Emails, pas ici.
- Additional Fields : 17 attributs optionnels, dont Phone, Company ID, Tags et Unique External ID, pratique pour garder l'identifiant de ta propre base.
Delete a contact
contact.deleteCe que tu vois dans n8n
Notes & cas d'usage
Quand une personne demande à disparaître de tes fichiers, cette opération supprime sa fiche contact dans Freshdesk.
Paramètres clés
- Contact ID : l'identifiant Freshdesk de la personne à retirer, pas son nom ni son email. Récupère-le d'une étape Get many contacts placée avant, avec une expression comme
{{ $json.id }}, qui lit un champ de l'élément entrant.
Get a contact
contact.getCe que tu vois dans n8n
Notes & cas d'usage
Lit une fiche contact et renvoie tous ses champs, ce qui évite aux nœuds suivants de travailler à l'aveugle.
Paramètres clés
- Contact ID : l'identifiant de la fiche à lire. Un champ marqué requis bloque l'exécution du nœud s'il est vide, donc vérifie que l'étape précédente produit bien un identifiant.
Get many contacts
contact.getAllCe que tu vois dans n8n
Notes & cas d'usage
Ramène les contacts par lot, avec des filtres qui réduisent le volume avant qu'il ne traverse le reste du workflow.
Paramètres clés
- Filters : 6 critères optionnels, Company ID, Email, Mobile, Phone, State et Updated Since.
- State : au choix
verified,unverified,blockedoudeleted, le moyen le plus rapide d'isoler les adresses jamais confirmées. - Updated Since : une date qui évite à une exécution planifiée de repasser sur toute la base.
Update a contact
contact.updateCe que tu vois dans n8n
Notes & cas d'usage
Les gens changent de poste, de numéro, d'entreprise. Cette opération inscrit ces changements sur une fiche existante, sans créer de doublon.
Paramètres clés
- Contact ID : la fiche à modifier, en général héritée d'une recherche placée juste avant.
- Additional Fields : les mêmes 17 attributs qu'à la création. Seul ce que tu remplis est écrit, donc une exécution peut ne toucher que Job Title.
- View All Tickets : autorise le contact à voir tous les tickets de son entreprise, utile pour un interlocuteur unique.
Ticket
5 opérationsCreate a ticket
ticket.createCe que tu vois dans n8n
Notes & cas d'usage
Ouvre un ticket dans Freshdesk à partir de ce que le workflow vient de recevoir, et renvoie le ticket créé pour la suite de l'exécution.
Paramètres clés
- Requester Identification et Value : la façon dont Freshdesk reconnaît la personne, par
email,phone,requesterId,twitterId,facebookIdouuniqueExternalId. Sur un email inconnu, Freshdesk crée le contact au passage. - Status, Priority, Source : les trois sont obligatoires, Source gardant le canal, de
chatàportal. - Options : 13 champs en plus, dont Subject, Description en HTML, Due By et Agent Name or ID.
Delete a ticket
ticket.deleteCe que tu vois dans n8n
Notes & cas d'usage
Certains tickets n'auraient jamais dû rejoindre la file. Du spam, un doublon né d'une exécution relancée, un essai oublié. Celui-là, on l'enlève.
Paramètres clés
- Ticket ID : l'identifiant du ticket à supprimer. Alimente-le avec le ticket que tu viens de créer,
{{ $json.id }}, quand une branche du workflow conclut à une erreur.
Get a ticket
ticket.getCe que tu vois dans n8n
Notes & cas d'usage
Relit un ticket précis et renvoie son état du moment, ce qu'il faut avant de décider quoi que ce soit à son sujet.
Paramètres clés
- Ticket ID : le ticket à lire. Conserve-le au moment de la création, puis réutilise-le plus loin dans le même workflow ou dans un workflow de suivi.
Get many tickets
ticket.getAllCe que tu vois dans n8n
Notes & cas d'usage
Sort les tickets par lot, point de départ de tous les rapports et de toutes les enquêtes construits sur ce nœud.
Paramètres clés
- Return All : coché, n8n enchaîne les pages de l'API et ramène tous les tickets correspondants ; décoché, Limit fixe le nombre maximal renvoyé.
- Options : 7 réglages, dont Updated Since, Requester Email, Order By et Include pour joindre
requester,company,descriptionoustatsà chaque ticket.
createdAt alimente le tableau que l'équipe relit le lundi.Update a ticket
ticket.updateCe que tu vois dans n8n
Notes & cas d'usage
La plupart des automatisations de support finissent ici : le ticket existe déjà, et quelque chose doit changer dessus sans qu'un agent l'ouvre.
Paramètres clés
- Ticket ID : le ticket à modifier, seule valeur obligatoire.
- Update Fields : 16 attributs, dont Status, Priority, Agent Name or ID, Group Name or ID, Tags et Type (
Incident,Problem,Question,Feature Request,Refund). - Due By et FR Due By : l'échéance de résolution et celle de la première réponse, si ton process les recalcule.
open.Besoin d'aide pour automatiser Freshdesk avec n8n ?
L'équipe te répond directement.
Chaque message est lu par une personne.
