Hermes Agent pour le support client Shopify : ce qui fonctionne en 2026

Pourquoi j'ai regardé Hermes sur Shopify

Je construis des intégrations chez eesel, et Shopify est celle qui a changé sous mes pieds cette année. La connexion d'eesel à Shopify demandait autrefois aux marchands de créer une app personnalisée et de coller un jeton. Cette voie a disparu, parce que Shopify a cessé d'autoriser la création de nouvelles apps personnalisées créées dans l'admin, et je l'ai donc passée à une approbation sur l'écran d'installation de Shopify. Quiconque connecte aujourd'hui Hermes à une boutique se heurte au même mur, et c'est l'essentiel de cet article.

Hermes Agent est l'agent open source et auto-hébergé de Nous Research, avec 251 791 étoiles sur GitHub sous licence MIT et la dernière version v2026.9.24. J'ai déjà traité la question générale du support dans Hermes Agent pour le support client et la version helpdesk dans un article sur Freshdesk. Shopify mérite son propre article parce que le plus difficile n'est pas le helpdesk. C'est d'obtenir la commande.

eesel met de l'IA sur de vraies files de support depuis des années, et les files e-commerce se ressemblent toutes : « où est ma commande ? », « est-ce en stock ? », « comment retourner ceci ? ». La leçon qui revient sans cesse : une réponse assurée sans données de commande en direct est pire que pas de réponse. Un marchand Shopify sur Reddit l'a dit sans détour :

"One wrong price shown to a buyer kills the tool permanently, and it takes exactly one incident. I've watched it happen."

u/neon_bloom_alchemy, Reddit

La question pour Hermes n'est donc pas « peut-il discuter ? ». C'est « peut-il voir la commande, et qui l'arrête quand il ne doit pas agir ? ».

Ce qu'Hermes peut réellement voir dans une boutique Shopify

Shopify propose désormais quatre voies officielles pour qu'un agent IA accède à une boutique, et elles répondent à des questions très différentes. Je lirais ce tableau avant d'écrire la moindre ligne de configuration :

La première ligne a changé récemment. La page Storefront MCP de Shopify s'ouvre désormais sur un bandeau rouge : « The catalog and cart tools on https://{shop}/api/mcp were removed. » Ces outils sont passés au Universal Commerce Protocol, le standard plus récent de Shopify pour le commerce agentique. L'outil de politiques, search_shop_policies_and_faqs, est resté en place, et « No authentication is required » (Policy and FAQs tool).

Le nouvel outil de commandes UCP n'aide pas non plus. Le Order MCP de Shopify indique « You can only fetch orders that were placed through your agent. » Il est conçu pour le paiement par agent, pas pour la commande qu'un client a passée sur votre site mardi dernier.

Il reste l'Admin API de Shopify comme la porte dont le travail de support a besoin. Sa requête orders filtre par e-mail « to provide customer support » et par numéro de commande avec name:1001 (orders query). Tout ce qui suit suppose cette voie.

Ce qu'Hermes propose aujourd'hui pour Shopify

Hermes a trois éléments en forme de Shopify, et aucun n'est une intégration de support :

• Pas d'entrée dans le catalogue MCP. Le catalogue sélectionné d'Hermes, avec 65 serveurs MCP, n'a pas d'entrée Shopify. Stripe, PayPal et Klaviyo y sont ; Shopify non.
• Une skill optionnelle shopify. Nous liste une skill communautaire qui permet de « Query Shopify Admin/Storefront GraphQL APIs via curl » (page de la skill). Elle lit un SHOPIFY_ACCESS_TOKEN statique depuis .env.
• Le AI Toolkit de Shopify. Le AI Toolkit de Shopify liste « Hermes (plugin only) » comme outil pris en charge. Il est destiné aux développeurs : documentation, validation de schéma et tâches de gestion de boutique que vous exécutez vous-même, le même toolkit que dans mon guide Claude pour Shopify.

Sur skills.sh, que Hermes peut interroger, les principales skills Shopify viennent de l'organisation GitHub de Shopify, en tête shopify-admin avec 17 013 installations (recherche skills.sh). Aucun des 100 premiers résultats n'est une skill de support client. Vous assemblez donc cela vous-même, ce qui ressemble à ce que décrivent les gens de la communauté Hermes. Mon guide du MCP pour le support client explique à quoi ressemble une bonne surface d'outils pour le support.

Comment le configurer en sécurité

Voici l'ordre dans lequel je le construirais. L'objectif est la forme qui fonctionne : Hermes lit Shopify, écrit un brouillon dans votre helpdesk, et une personne l'envoie.

1. Créer une app Dev Dashboard avec des autorisations en lecture seule

L'ancienne voie, créer une app personnalisée dans votre admin Shopify et copier un jeton, est fermée. La documentation de Shopify dit « You can no longer create new admin-created custom apps » et oriente les nouveaux développements vers le Dev Dashboard (admin-created custom apps). La skill Hermes note le même changement.

Dans le Dev Dashboard, ne choisissez que ce dont une consultation de support a besoin :

• read_orders, read_customers, read_products, read_fulfillments.
• Évitez write_orders. C'est l'autorisation dont refundCreate a besoin, et un bot qui ne peut pas rembourser ne peut pas rembourser par erreur. Une vraie automatisation des remboursements demande des approbations, pas de l'espoir.
• Connaissez la limite de 60 jours. read_orders couvre « orders created within the last 60 days », et les plus anciennes exigent read_all_orders, pour lequel « you must request access to » (access scopes). Le client qui s'enquiert d'une commande de mars recevra un assuré « je ne la trouve pas » si vous ne l'anticipez pas.

Les noms, e-mails, téléphones et adresses des clients sont des données client protégées, et les champs pour lesquels votre app n'est pas approuvée reviennent à null (protected customer data). Testez avec une vraie commande avant de supposer que le filtre d'e-mail renvoie ce que vous attendez.

2. Prévoir le jeton de 24 heures

Les nouvelles apps sur votre propre boutique obtiennent leur jeton via le client credentials grant. Shopify est précis : expires_in est « Always 86399 (24 hours) », il n'y a pas de jeton de rafraîchissement, et il « only works when the app and the store belong to the same Shopify organization » (client credentials grant). Une agence qui connecte Hermes à la boutique d'un client ne peut pas l'utiliser du tout.

Hermes ne génère pas ce jeton pour vous. Sa configuration MCP accepte des headers statiques résolus depuis ${VAR} dans .env, ou auth: oauth, qui est le flux interactif authorization code avec PKCE (MCP config reference). Il n'y a pas d'option client credentials, et la skill Shopify lit elle aussi un jeton statique.

La solution que j'utiliserais est banale et fonctionne : une tâche cron qui demande un nouveau jeton toutes les 20 heures et réécrit SHOPIFY_ACCESS_TOKEN dans ~/.hermes/.env. Le planificateur d'Hermes peut l'exécuter. Traitez-la simplement comme de la plomberie de production, car le matin où elle échoue en silence est celui où chaque consultation de commande renvoie 401.

3. Donner à Hermes un outil étroit, pas du GraphQL brut

La skill communautaire donne à Hermes curl et toute la GraphQL Admin API. Sa propre note de sécurité dit que les mutations « create products, charge refunds, cancel orders » et demande à l'agent de d'abord « confirm with the user » (page de la skill). C'est un prompt, pas un verrou.

Je préfère envelopper deux ou trois requêtes en lecture seule dans un petit serveur MCP à vous, get_order_by_number, get_orders_by_email, get_fulfillment, et ne lister que celles-là :

mcp_servers:
  shop:
    url: "http://localhost:8787/mcp"
    headers:
      Authorization: "Bearer ${SHOP_MCP_KEY}"
    tools:
      include:
        - get_order_by_number
        - get_orders_by_email
        - get_fulfillment

C'est mon propre assemblage à partir de la documentation d'Hermes, pas un exemple officiel. Une fois include défini, Hermes n'enregistre que ces outils (documentation MCP d'Hermes). Un outil de remboursement qui n'existe pas ne peut pas être convaincu de s'exécuter. Votre wrapper détient le jeton Shopify, Hermes ne le voit donc jamais.

4. Rédiger dans votre helpdesk, pas pour le client

La plupart des boutiques Shopify gèrent le support dans un helpdesk comme Gorgias, Zendesk ou Freshdesk, chacun avec son propre panneau latéral Shopify (voici la configuration Gorgias avec Shopify). Hermes n'a pas non plus d'entrées MCP de helpdesk, vous en connecteriez donc un comme je l'ai montré dans Hermes Agent pour Freshdesk et donneriez à Hermes un seul outil d'écriture : une note interne. Sur Zendesk, c'est la même intégration Shopify que vos agents utilisent déjà, plus un commentaire privé.

La communauté Hermes aboutit à la même forme. Un utilisateur faisant tourner Hermes sur sa boîte de réception a décrit l'échec dont cela protège :

"Been training AI to write in my voice and draft replies to emails on my behalf, but my success rate (drafted emails worth using) is approx 50/50. It's learned my voice, it's learned about the business, but 50% of the time it just has to add something wrong enough into the email where I don't or can't use it."

u/SmugglingPineapples, Reddit

Les propres chiffres d'eesel disent la même chose avec un autre accent. Un bijoutier en ligne allemand sur Zendesk et Shopify a fait tourner eesel sur du trafic réel pendant un essai : 93 % de précision de tri et 88 % de brouillons allant dans la bonne direction, mais les agents n'ont envoyé que 12 % des brouillons tels quels, et environ 7 % contenaient une erreur factuelle. C'est pourquoi chaque déploiement d'eesel est désormais simulé sur des tickets historiques avant la mise en production, et pourquoi les brouillons viennent avant les envois. C'est le modèle d'assistance à l'agent, et c'est aussi la bonne première étape pour Hermes.

5. Choisir un déclencheur, et se méfier de l'en-tête du webhook

Hermes doit savoir quand regarder quelque chose. Vous avez trois options :

• À la demande. Un agent colle un numéro de commande dans Slack et interroge Hermes. Le plus simple, avec un humain dans la boucle en permanence.
• Interrogation par cron. Hermes vérifie le helpdesk à la recherche de nouveaux tickets toutes les quelques minutes. Aucun point d'accès public nécessaire.
• Webhook Shopify. Un événement orders/fulfilled ou refunds/create prévient directement Hermes.

La troisième a un piège. Shopify signe les webhooks avec « a base64-encoded HMAC signature in the X-Shopify-Hmac-SHA256 header » (verify webhook deliveries). Hermes accepte les signatures de GitHub, GitLab, Standard Webhooks et ses propres signatures génériques, et « If a secret is configured but no recognized signature header is present, the request is rejected » (webhooks d'Hermes). L'en-tête de Shopify n'est pas dans la liste.

Il vous faudrait un petit relais, un worker ou un flux n8n, qui vérifie la signature de Shopify et resigne avec X-Webhook-Signature-V2. Deux détails de timing comptent aussi. Shopify accorde cinq secondes pour toute la requête et supprime un abonnement créé par API après 8 nouvelles tentatives échouées sur 4 heures. Hermes limite chaque route à 30 requêtes par minute, donc une rafale d'orders/create lors d'une vente flash nécessite le paramètre coalesce.

L'action Send HTTP request de Shopify Flow est une autre source de déclencheurs, avec secrets et nouvelles tentatives jusqu'à 24 heures, et un bon point d'entrée vers l'automatisation Shopify en général. Plus de détails côté Shopify dans mon article sur les déclencheurs de webhooks de commandes.

6. Tester sur les tickets du mois dernier avant de lui faire confiance

Hermes n'a pas de mode de rejeu. Pour savoir s'il est prêt, prenez 100 tickets WISMO et retours résolus, faites tourner Hermes dessus dans un profil sandbox et comparez ses brouillons à ce que votre équipe a réellement envoyé. Notez deux choses : a-t-il trouvé la bonne commande, et a-t-il dit quoi que ce soit que les données de la commande ne soutiennent pas.

Un fil Reddit sur cette configuration précise contenait le meilleur avertissement en une ligne que j'aie trouvé. Un utilisateur suggérait une règle ferme dans le fichier SOUL.md d'Hermes pour qu'il ne devine pas. La réponse :

"Telling it not to hallucinate seems...unlikely to succeed."

u/Sjsamdrake, Reddit

Juste. Ce qui empêche les réponses inventées, comme toute équipe de support e-commerce finit par l'apprendre, c'est une consultation qui échoue bruyamment et une personne qui lit le brouillon, pas une phrase dans le prompt. Mon guide sur les hallucinations de l'IA dans le support approfondit les tests.

Quelle question Shopify demande quelle porte ?

C'est la partie que les gens sautent, la voici donc sous forme cliquable. Choisissez la question qu'envoie un client, et voyez quelle surface Shopify y répond et si Hermes peut l'atteindre :

Le schéma est clair une fois exposé ainsi, et c'est pourquoi la plupart des chatbots de suivi de commande commencent par le WISMO et s'arrêtent avant les remboursements. Les questions de politique sont gratuites. Les questions de commande vous coûtent une app, une tâche de jeton et un wrapper. Tout ce qui déplace de l'argent reste avec une personne.

Où les clients parlent, et où Hermes écoute

Même une fois les données réglées, reste la question de l'endroit où se déroule la conversation. Le gateway d'Hermes couvre une longue liste d'applications de chat, mais celles que les clients Shopify utilisent vraiment ne se recoupent qu'en partie :

• Chat de la boutique : non. Hermes n'a pas de widget de site, ce que la plupart des gens entendent par chatbot e-commerce. Le plus proche est son serveur d'API, dont la documentation avertit qu'il « gives full access to hermes-agent's toolset, including terminal commands » (API server). Pas quelque chose à placer derrière une zone de chat publique.
• E-mail : oui. Hermes interroge une boîte IMAP toutes les 15 secondes par défaut et répond en texte brut (documentation e-mail).
• WhatsApp : oui, avec une lacune. Hermes prend en charge la Cloud API officielle de Meta, mais « Message-template support... is not yet implemented in Hermes » (documentation WhatsApp Cloud). Sans modèles, il ne peut pas envoyer de mise à jour d'expédition plus de 24 heures après le dernier message du client, ce qui exclut le support WhatsApp proactif.
• Instagram et Messenger : non. Aucun n'apparaît dans la liste des canaux du gateway.

Et il y a l'accès par défaut. « If no allowlists are configured... all users are denied » (documentation de sécurité). Les expéditeurs inconnus reçoivent un code d'appairage que vous approuvez à la main. Pour répondre à des inconnus, il faudrait définir GATEWAY_ALLOW_ALL_USERS=true, ce que la même documentation déconseille formellement en production sur un bot ayant accès au terminal. C'est le signe le plus clair qu'Hermes a été conçu comme votre agent, pas celui de vos clients.

À titre de comparaison, la réponse propre de Shopify pour le chat de la vitrine est Shopify Inbox. La page de migration de Shopify dit aux marchands qui veulent du chat IA sans code de « use the Inbox agent in Shopify Inbox. »

Il est gratuit et noté 4,6 sur 5 804 avis, mais c'est d'abord un assistant commercial, et ses consultations de commandes exigent que le client se connecte. Les avis mentionnent aussi les lacunes que ressent une équipe de support :

"AI agent is great but without a way to handover the conversation to a human agent, I dont think there is a way I can use it 24x7. In fact, I have made the hard decision of turning it off completely."

303 Exclusive Diecasts, App Store

Shopify a répondu que l'agent « always shows buyers an option to connect to staff after every message », il pourrait donc s'agir d'un problème de configuration. Et Shopify Sidekick est exclu pour cette tâche : « Sidekick can't talk to your customers or handle customer support conversations on your behalf » (configuration de Sidekick).

Ce que coûte réellement Hermes sur Shopify

La licence est gratuite et l'Admin API de Shopify ne facture pas par appel. La facture est partout ailleurs.

Jetons du modèle. Nous Portal propose Free à 0 $, Plus à 20 $/mois pour 22 $ de crédit, Super à 100 $ et Ultra à 200 $. Vous pouvez aussi connecter un forfait ChatGPT éligible pour l'inférence.

Limites de débit de Shopify. Elles ne coûtent pas d'argent, mais elles plafonnent la vitesse des consultations, et elles sont partagées avec toutes les autres apps de la boutique (rate limits) :

Une consultation de support coûte peu de points, cela gêne donc rarement la rédaction de brouillons. Cela gêne quand une tâche d'évaluation nocturne et une app de reporting frappent la même boutique en même temps. Les prix des forfaits figurent dans mon détail des tarifs Shopify.

La plomberie. Une tâche de renouvellement de jeton, un relais de webhooks, un wrapper MCP en lecture seule, une connexion au helpdesk et un banc d'évaluation. Chacun prend un week-end. Ensemble, c'est un petit produit que vous maintenez désormais. Quand un utilisateur de Hacker News a décrit la connexion d'Hermes à ses propres outils métier, c'était une victoire interne, pas orientée client :

"I've added MCP servers to my internal business tools (Elixir apps) and can chat with the Nous Hermes agent over Telegram about pending orders, inventory level, historical product prices, etc., without having to click/dick around with a web UI."

leansensei, Hacker News

C'est le point idéal, et il vaut la peine d'être remarqué. Mon comparatif construire ou acheter chiffre le côté ingénierie.

Où Hermes sur Shopify cesse de fonctionner

Tout ce qui précède suppose la forme brouillon. Pointez Hermes directement sur les clients et vous heurtez les murs de mon test pour le support :

• Les approbations vont à celui qui discute. Sur les plateformes de messagerie, Hermes « waits for the user to reply » yes ou approve (documentation de sécurité). Dans un fil WhatsApp avec un client, cet utilisateur est le client. Et le verrou couvre les commandes shell, pas les appels d'API.
• La mémoire est par profil. La mémoire intégrée est MEMORY.md (2 200 caractères) et USER.md (1 375), partagées entre tous les chats que le profil exécute (documentation de la mémoire). Ne le laissez pas enregistrer des informations de clients.
• Les exécutions par webhook ne peuvent pas interroger un humain. Sur les surfaces sans surveillance comme les webhooks, les commandes dangereuses sont refusées par défaut. Bon pour la sécurité, mais cela signifie qu'une exécution sur événement de commande ne peut que rédiger ou alerter.
• La fenêtre de 60 jours. Vue plus haut, et c'est celle qui produit des réponses fausses plutôt que des erreurs.

Le conseil de la communauté Hermes à quiconque est tenté de passer en production est le même que le mien :

"Yes, but I would start with it as a draft-and-escalate helper before letting it answer everything live. For local customers, the dangerous cases are usually not the repeated FAQ questions. They are the almost-FAQ questions."

u/deelight_0909, Reddit

Le « presque-FAQ » est exactement ce dont une file e-commerce est remplie : une question WISMO avec un « pouvez-vous aussi changer l'adresse ? » collé à la fin.

Hermes vs Shopify Inbox vs eesel pour le support Shopify

Pour le paysage plus large, mon comparatif des meilleures IA pour le support Shopify et la liste des meilleurs helpdesks IA pour Shopify vont plus loin, et les alternatives à Hermes Agent couvrent le côté agents généralistes.

Si votre helpdesk est Gorgias, tenez compte des tarifs de Gorgias pour les boutiques Shopify, car son IA est facturée par interaction automatisée.

Faut-il faire tourner Hermes sur votre support Shopify ?

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

Oui, si vous avez un ingénieur que cela amuse et que la tâche est un assistant interne : votre équipe interroge Hermes sur une commande dans Slack, ou il rédige des réponses WISMO dans le helpdesk pour qu'une personne les envoie. Une app Dev Dashboard avec des autorisations en lecture seule, une tâche de renouvellement et un wrapper de trois outils est une configuration défendable, et le cron d'Hermes la rend utile.

Non, si vous voulez que l'IA parle aux clients dans le chat de votre boutique, émette des remboursements ou couvre des commandes de plus de 60 jours sans approbation supplémentaire. Même réponse si personne ne peut prendre en charge une tâche de jeton et un relais de webhooks. Ce ne sont pas des défauts d'Hermes. C'est un agent généraliste conçu pour travailler pour son opérateur, et le support Shopify est un travail avec un inconnu à l'autre bout.

La voie médiane où finissent la plupart des boutiques est un chatbot IA pour Shopify ou un agent de helpdesk tout prêt pour les clients, avec Hermes comme assistant interne de l'équipe si quelqu'un aime bricoler. J'ai fait le même choix pour la version ChatGPT de cette question, et la bande des chatbots open source arrive au même endroit.

Essayer eesel pour le support Shopify

Si vous voulez qu'une IA réponde à « où est ma commande ? » sur votre boutique Shopify cette semaine, eesel fonctionne comme une nouvelle recrue du support qui connaît déjà votre catalogue. Vous l'approuvez sur l'écran d'installation de Shopify, sans jeton à coller, et elle consulte les commandes par numéro ou e-mail, vérifie le suivi et lit les produits en direct, dans Gorgias, Zendesk, Freshdesk ou son propre widget de chat. Les retours, changements d'adresse, remboursements et annulations peuvent chacun attendre l'approbation d'une personne, ce qui est le garde-fou qu'Hermes vous obligerait à construire vous-même.

C'est aussi confortable pour le public d'Hermes. La CLI d'eesel fait tourner le même coéquipier depuis un terminal : eesel integrations connect shopify connecte la boutique, eesel approvals list affiche les remboursements qui vous attendent, et des agents de code comme Claude Code ou Cursor peuvent aussi le piloter. La tarification est simple : 100 crédits gratuits, puis des forfaits à partir de 299 $/mois pour 500, où un ticket ou un chat vaut un crédit, quel que soit le nombre de consultations nécessaires. Essayez eesel sur votre propre boutique.