Hermes Agent pour Freshdesk : comment le connecter en toute sécurité (2026)

Pourquoi j'ai regardé Hermes sur Freshdesk

Mon travail quotidien chez eesel consiste à construire des intégrations, et l'API de Freshdesk est de celles où j'ai passé assez de temps pour avoir des opinions sur ses limites de débit. eesel fait tourner de l'IA sur des files de support réelles depuis des années, et la même leçon revient sans cesse : le modèle est la partie facile. Le difficile, c'est de décider ce que l'IA a le droit de toucher, et de savoir qu'elle est prête avant qu'un client soit le premier à découvrir qu'elle ne l'est pas.

Hermes Agent est l'agent open source et auto-hébergé de Nous Research, avec 251 479 étoiles GitHub sous licence MIT. La question générale, je l'ai déjà traitée dans Hermes Agent for customer support. Ce que vous lisez est la version Freshdesk, qui méritait son propre article parce que Freshdesk a changé la réponse le mois dernier.

Précisons d'emblée que Hermes ne fournit rien de spécifique à Freshdesk. Son catalogue sélectionné de 68 serveurs MCP n'a aucune entrée Freshdesk, et quand j'ai cherché sur Hacker News, Reddit et X, personne ne décrivait non plus une configuration Hermes plus Freshdesk. Tout ce qui suit, je l'ai donc assemblé à partir de la documentation des deux éditeurs, ce qui est à peu près la façon dont vous devriez le construire vous-même de toute façon.

Ce qui a changé : Freshdesk a désormais son propre serveur MCP

Jusqu'à récemment, pour brancher un agent externe sur Freshdesk, il fallait du code communautaire ou un wrapper écrit par vous autour de l'API v2 de Freshdesk. Désormais, Freshdesk exploite son propre serveur. D'après son article sur MCP, "Starting September 10, 2026, the Freshworks MCP integration is generally available."

Les faits essentiels, tous tirés des FAQ MCP de Freshdesk et de ce même article :

• Offres : Growth, Pro et Enterprise, uniquement dans les versions 2021 Standalone ou Omni 2026. Les comptes hérités ne sont pas pris en charge.
• Point d'accès : https://<subdomain>.freshdesk.com/mcp. Les domaines personnalisés ne fonctionnent pas.
• Authentification : clé d'API uniquement, et les appels suivent les permissions du rôle de cet utilisateur.
• Outils : 37, couvrant tickets, conversations, contacts, agents, groupes, entreprises et articles du centre d'aide. Aucun outil de suppression ou de fusion.
• Activé par défaut. Un administrateur peut le désactiver dans Admin Settings > Apps & Integrations > MCP.

Il est aussi facturé à l'usage, et c'est nouveau chez Freshdesk. La ligne apparaît directement sur chaque carte d'offre :

Freshdesk documente Claude Code, Claude Desktop, Cursor, Copilot Studio et VS Code comme clients, et ajoute que "any AI tool that provides MCP support" fonctionne. Comme Hermes parle MCP sur HTTP, il en fait partie. Pour ceux qui ont déjà lu mon article Claude for Freshdesk, c'est le même serveur, sorti de l'accès anticipé et disponible sur des offres moins chères.

Quatre façons de connecter Hermes à Freshdesk

Voici toutes les voies que j'ai trouvées, avec qui a relu le code qui finit par détenir votre clé d'API :

Aujourd'hui, je prendrais la première. L'éditeur dont elle touche les données est celui qui la maintient, et vos identifiants du helpdesk ne font pas de détour par un tiers. Elle couvre aussi les articles du centre d'aide, ce que le serveur d'effytech ne fait pas (il n'a pas d'outils pour les articles de solutions). Quant à la voie webhook, c'est moins une quatrième alternative qu'un déclencheur : elle prévient Hermes qu'un ticket est arrivé, et Hermes a toujours besoin de l'une des trois autres pour le lire ou y écrire.

Comment le configurer en sécurité

Voici l'ordre que je suivrais. La plupart de ces étapes n'existent qu'à cause d'une seule phrase de la FAQ de Freshdesk : "tool-level access management is not available. All supported MCP tools are available by default to any user who connects using a valid API key."

1. Donnez à Hermes son propre siège d'agent

Le serveur MCP agit comme l'agent auquel appartient la clé d'API. Collez votre propre clé et Hermes peut faire tout ce que vous pouvez faire, chaque note qu'il écrit semblant écrite par vous.

Ce que je ferais : créer un agent dédié au bot, lui donner un rôle étroit et le nommer par exemple "Hermes (draft only)". Chez Freshdesk, cela signifie un siège payant, à partir de 19 $/agent/mois sur Growth en facturation annuelle. De tout ce qu'il y a dans cette configuration, c'est la fonction de sécurité la moins chère, puisque les permissions de rôle sont la seule limite que Freshdesk applique côté serveur.

2. Ajoutez le serveur et filtrez ses outils

Hermes range les serveurs MCP sous mcp_servers dans ~/.hermes/config.yaml et résout les espaces réservés ${VAR} depuis ~/.hermes/.env. Il permet aussi d'établir une liste blanche d'outils par serveur (documentation MCP de Hermes). En combinant cela avec le point d'accès et l'en-tête d'authentification de Freshdesk, on obtient la configuration ci-dessous, qui est mon propre assemblage des deux documentations et non un exemple officiel :

mcp_servers:
  freshdesk:
    url: "https://yourcompany.freshdesk.com/mcp"
    headers:
      Authorization: "${FRESHDESK_API_KEY}"
    tools:
      include:
        - fetchTicket
        - fetchTicketConversations
        - fetchSearchTickets
        - fetchSolutionArticle
        - createTicketNote

Une fois include défini, la documentation de Hermes dit : "Only those MCP server tools are registered." Cette courte liste fait donc le travail que les permissions de Freshdesk ne peuvent pas faire.

Hermes a aussi un réglage trust par serveur. Sur un serveur untrusted, "every write-capable tool call... requires user approval through the standard approval surface before it runs" (référence de configuration MCP). La valeur par défaut est full. Si vous lancez Hermes depuis un chat Slack ou Telegram avec quelqu'un qui surveille, passer à untrusted ajoute une seconde vérification sur chaque note.

3. Écrivez des notes privées, jamais des réponses

Freshdesk sépare les deux au niveau de l'API. Une note ajoutée via /notes est privée par défaut, et "Private notes are for collaboration between agents and are not visible to the customer." Le point d'accès de mise à jour, lui, indique "Only public & private notes can be edited" (API Freshdesk). Une fois la réponse envoyée, elle reste envoyée.

Le flux est donc le suivant : Hermes rédige dans une note privée, un agent la relit, puis envoie la réponse sous son propre nom. Les brouillons de réponse IA de Freshdesk fonctionnent sur le même schéma, tout comme chaque outil d'agent assist. Ma règle : s'y tenir jusqu'à ce que les erreurs deviennent ennuyeuses.

4. Choisissez un déclencheur : chat, cron ou webhook

Hermes doit savoir quand regarder un ticket, et il y a trois options :

• À la demande. Un agent colle un numéro de ticket dans Slack et demande un brouillon à Hermes. C'est la plus simple, et un humain reste dans la boucle tout du long.
• Interrogation par cron. Le planificateur de Hermes tourne toutes les 60 secondes, et un script de pré-vérification peut afficher {"wakeAgent": false} pour que "cron skips the agent run entirely" quand rien n'a changé (documentation cron). Pratique pour "toutes les 5 minutes, rédiger des notes sur les nouveaux tickets de ce groupe".
• Webhook. Une règle d'automatisation Freshdesk à la création d'un ticket déclenche "Trigger webhook" vers une route Hermes comme http://your-server:8644/webhooks/freshdesk.

Des trois, les webhooks sont les plus proches du temps réel et aussi les plus délicats. Hermes exige un secret sur chaque route et rejette toute requête sans "a recognized signature header" (documentation webhooks). La règle de Freshdesk peut ajouter des en-têtes personnalisés, mais je n'ai trouvé aucune option pour signer le corps ; avant de vous y fier, testez donc lequel des schémas acceptés par Hermes votre règle est réellement capable de satisfaire. En cas d'échec, Freshdesk réessaie toutes les 30 minutes, 48 fois, et les webhooks sont plafonnés à 1 000 appels par heure (aide Freshdesk).

Quelques autres détails sur les webhooks méritent d'être connus. Les exécutions par webhook démarrent avec un jeu d'outils par défaut restreint, ce qui signifie que la route a besoin d'une autorisation manuelle toolsets: ["mcp-freshdesk"] avant de pouvoir toucher le moindre ticket. La documentation avertit aussi : "HMAC validation authenticates the sender, not the content." Puisque c'est un client qui écrit le corps du ticket, traitez-le comme du texte non fiable, ce qui est une raison de plus pour que le seul outil d'écriture soit une note privée.

5. Testez sur d'anciens tickets avant de faire confiance

C'est là que j'investirais le plus de temps, et c'est aussi là que Hermes aide le moins. Il n'a pas de mode de rejeu pour passer sur les tickets du mois dernier et noter les brouillons par rapport à ce que votre équipe a réellement envoyé.

Vous pouvez le construire vous-même : récupérer des tickets résolus, faire tourner Hermes dessus dans un profil isolé, puis comparer. Il y a deux pièges côté Freshdesk. List Tickets ne renvoie "by default" que les tickets "created within the past 30 days" sauf si vous passez updated_since, et le point d'accès de recherche plafonne autour de 300 résultats (API Freshdesk). En plus, chaque lecture pendant l'évaluation compte dans votre quota MCP ; il est donc plus judicieux de mener l'évaluation par l'API REST. Pour savoir ce que veut dire "assez bien", mon guide sur l'entraînement d'une IA sur une base de connaissances l'explique.

Ce que coûte vraiment Hermes sur Freshdesk

La licence ne coûte rien. Les quatre autres postes de la facture, si.

Actions MCP. "Any call to an MCP server counts as one action, regardless of whether it reads or writes data" (FAQ MCP). Le quota est fixé par compte et par an, et ne se reporte pas :

Tout ce qui dépasse coûte 15 $ les 1 000, selon la page de tarifs. Les limites REST viennent de la documentation de l'API et sont partagées à l'échelle du compte avec toutes les autres intégrations que vous utilisez.

Un brouillon utile demande plus d'un appel. Hermes lit le ticket, puis le fil, recherche des tickets similaires et récupère un article d'aide avant d'écrire la note :

Avec cinq actions par ticket, Growth couvre environ 240 brouillons par an, soit à peu près 20 par mois. Au-delà, cela revient à 7,5 cents le ticket en actions, ce qui paraît peu par ticket mais se sous-estime facilement au total. Les agents réessaient et explorent aussi ; considérez donc cinq comme un plancher et non comme une moyenne. Vous pouvez entrer vos propres chiffres ici :

Jetons du modèle. Nous Portal Plus coûte 20 $/mois pour 22 $ de crédit, Super 100 $ et Ultra 200 $. Autre option : connecter une offre ChatGPT éligible et l'utiliser pour l'inférence.

Le siège du bot. De 19 à 89 $ par mois, selon l'offre dont vous disposez.

La construction. C'est le poste que l'on a tendance à oublier. Un acheteur Freshdesk rencontré lors des appels commerciaux d'eesel, une société de sécurité e-mail en route vers 20 000 tickets par an, a passé 200 interactions en une seule journée de test, et sa première question a été de savoir ce que cela donnerait à 9 000 par mois. Avec une IA facturée à l'usage, le volume devient la première question d'un responsable du support, et Hermes vous fait compter trois choses à la fois : les jetons et les actions MCP, puis par-dessus les heures d'ingénierie. Pour ce dernier point, mon analyse build vs buy chiffre le sujet.

Là où Hermes sur Freshdesk atteint ses limites

Tout ce qui précède suppose le schéma de brouillons. Dès que vous pointez Hermes directement vers les clients Freshdesk, vous butez sur les mêmes murs que ceux rencontrés dans l'avis général sur le support :

• La mémoire est par profil, pas par demandeur. La mémoire intégrée se compose de MEMORY.md (2 200 caractères) et USER.md (1 375), chargés dans chaque session que le profil exécute (documentation mémoire). Ce qu'il retient du ticket d'un client reste alors dans le prompt du suivant.
• Aucune cible de livraison Freshdesk. Les options deliver d'une exécution par webhook sont des plateformes de chat, l'e-mail ou un journal. Pour ramener la réponse dans le ticket, il faut toujours passer par un appel d'outil.
• Aucune répétition. Je l'ai traité plus haut, et c'est la lacune à laquelle je donnerais le plus de poids.
• Le bot natif existe déjà. Freddy AI Agent de Freshdesk est sur chaque offre avec 500 sessions uniques, puis 49 $ les 100. Si ce que vous voulez est un bot tourné vers le client dans Freshdesk, Hermes reconstruirait quelque chose que le helpdesk vend déjà.

Un utilisateur de Hacker News fait bel et bien tourner un helpdesk basé sur Hermes, et ce fil résume bien le compromis :

"We replaced our helpdesk with Hermes. It has long term memory about our business. When a customer messages us, Hermes gets all the relevant details about the customer and creates a Pi session using Gemma 4 running locally and customer talks to that agent."

theturtletalks, Hacker News

La première réponse demandait si cela risquait de provoquer "one customer's data leaking to another" (dezgeg, Hacker News). Regardez pourtant la conception. Hermes n'est pas l'agent avec lequel le client parle ; il lance à la place une session locale distincte pour chaque client. C'est une architecture sensée, et aussi beaucoup d'architecture.

Hermes vs Freddy AI vs eesel sur Freshdesk

Pour la comparaison plus large, mon panorama best AI for Freshdesk et la liste Freshdesk AI alternatives vont plus loin, tandis que Hermes Agent alternatives couvre le côté des agents généralistes.

Faut-il faire tourner Hermes sur votre file Freshdesk ?

Après avoir lu les deux documentations, voici où j'aboutis.

Oui, si vous avez un ingénieur qui aime ce genre de travail et que la mission est de rédiger des notes pour des agents qui les relisent, tant que votre volume tient dans le quota d'actions. Le serveur MCP officiel avec une liste include de cinq outils est une configuration propre que vous pouvez défendre, et par-dessus, les fonctions cron et webhook de Hermes offrent une vraie automatisation. Il convient aussi comme chatbot de support interne qui répond à votre propre équipe à partir de l'historique Freshdesk.

Non, si vous voulez que l'IA réponde aux clients, ou si vous avez besoin d'un journal de chaque action de l'IA qu'un responsable du support peut lire sans SSH. Même réponse si personne ne peut être libéré pour maintenir un fichier YAML et un banc d'évaluation. Et l'examen de sécurité Freshdesk que vous feriez chez n'importe quel éditeur devient un examen que vous menez désormais sur votre propre serveur.

La version honnête, c'est que Freshdesk vient de faire du câblage la partie facile. Ce qui reste, c'est le problème des hallucinations de l'IA, plus la répétition et les garde-fous autour, et c'est le vrai travail pour mettre de l'IA sur une file.

eesel pour Freshdesk

Si vous avez regardé Hermes parce que vous vouliez qu'une IA traite vos tickets Freshdesk, eesel est le coéquipier conçu exactement pour ce travail. Il se connecte avec votre sous-domaine Freshdesk et une clé d'API, sans application à installer, et apprend de votre centre d'aide et de vos réponses prédéfinies ainsi que de vos tickets résolus (documentation eesel).

Voici comment cela répond aux lacunes ci-dessus :

• Répétition d'abord. Il simule sur vos anciens tickets Freshdesk avant de répondre à un seul client.
• Vous choisissez le niveau d'écriture. Il peut laisser des notes internes, garder des brouillons de réponse en attente d'approbation, ou envoyer. L'étiquetage et l'assignation sont inclus, ainsi que la définition du statut et la mise à jour des champs, ce qui couvre aussi le tri automatique Freshdesk.
• Pas de comptage par appel. Un ticket coûte 1 crédit quel que soit le nombre de réponses échangées. Les offres démarrent à 299 $ pour 500 crédits, et l'offre gratuite comprend 100 crédits.
• Freshchat inclus. La même connexion couvre aussi le chat Freshdesk, sans seconde configuration.

Et si la moitié de l'attrait de Hermes était le terminal, eesel en a un aussi. La CLI eesel pilote le même coéquipier : eesel integrations connect freshdesk relie le compte, eesel integrations download start récupère l'historique des tickets et eesel automations définit ce qu'il fait à chaque déclencheur. Comme les commandes affichent du JSON, un script ou un agent de programmation comme Claude Code peut mener votre configuration Freshdesk de bout en bout. Il y a plus à ce sujet dans mon article CLI for customer support.

Gardez Hermes pour les tâches où il excelle. Pour la file Freshdesk, en revanche, essayez d'abord eesel sur vos vrais tickets.