Hermes Agent para o suporte ao cliente da Shopify: o que funciona em 2026

Por que olhei para o Hermes na Shopify

Construo integrações na eesel, e a Shopify é a que mudou debaixo dos meus pés este ano. A ligação da eesel à Shopify costumava pedir aos lojistas que criassem uma app personalizada e colassem um token. Esse caminho acabou, porque a Shopify deixou de permitir criar novas apps personalizadas criadas no admin, por isso passei-a para aprovação no ecrã de instalação da Shopify. Quem liga hoje o Hermes a uma loja esbarra na mesma parede, e é disso que trata grande parte deste artigo.

O Hermes Agent é o agente open source e auto-hospedado da Nous Research, com 251.791 estrelas no GitHub sob licença MIT e a versão mais recente v2026.9.24. Já tratei a questão geral do suporte em Hermes Agent para o suporte ao cliente e a versão de helpdesk num artigo sobre o Freshdesk. A Shopify merece o seu próprio artigo porque a parte difícil não é o helpdesk. É obter o pedido.

A eesel há anos que coloca IA em filas de suporte reais, e as filas de ecommerce são todas parecidas: "onde está o meu pedido?", "isto tem stock?", "como devolvo isto?". A lição que se repete é que uma resposta confiante sem dados de pedido em tempo real é pior do que nenhuma resposta. Um lojista da Shopify no Reddit disse-o sem rodeios:

"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

Portanto, a pergunta para o Hermes não é "consegue conversar?". É "consegue ver o pedido e quem o trava quando não deve agir?".

O que o Hermes realmente consegue ver numa loja Shopify

A Shopify tem agora quatro vias oficiais para um agente de IA chegar a uma loja, e respondem a perguntas muito diferentes. Eu leria esta tabela antes de escrever uma linha de configuração:

A primeira linha mudou recentemente. A página do Storefront MCP da Shopify abre agora com um banner vermelho: "The catalog and cart tools on https://{shop}/api/mcp were removed." Essas passaram para o Universal Commerce Protocol, o padrão mais recente da Shopify para o comércio agêntico. A ferramenta de políticas, search_shop_policies_and_faqs, ficou onde estava, e "No authentication is required" (Policy and FAQs tool).

A ferramenta de pedidos do UCP, mais recente, também não ajuda. O Order MCP da Shopify diz "You can only fetch orders that were placed through your agent." Foi feito para o checkout de agentes, não para o pedido que um cliente fez no seu site na terça-feira passada.

Isso deixa a Admin API da Shopify como a porta de que o trabalho de suporte precisa. A sua consulta orders filtra por e-mail "to provide customer support" e por número do pedido com name:1001 (orders query). Tudo o que se segue pressupõe esse caminho.

O que o Hermes traz hoje para a Shopify

O Hermes tem três coisas com feitio de Shopify, e nenhuma é uma integração de suporte:

• Sem entrada no catálogo MCP. O catálogo selecionado do Hermes, com 65 servidores MCP, não tem entrada da Shopify. Stripe, PayPal e Klaviyo estão lá; a Shopify não.
• Uma skill opcional shopify. A Nous lista uma skill da comunidade que permite "Query Shopify Admin/Storefront GraphQL APIs via curl" (página da skill). Lê um SHOPIFY_ACCESS_TOKEN estático a partir do .env.
• O AI Toolkit da Shopify. O AI Toolkit da própria Shopify lista "Hermes (plugin only)" como ferramenta suportada. É para programadores: documentação, validação de esquemas e tarefas de gestão da loja que você próprio executa, o mesmo toolkit por trás do meu guia de Claude para Shopify.

No skills.sh, que o Hermes consegue pesquisar, as skills da Shopify mais populares vêm da organização GitHub da própria Shopify, lideradas por shopify-admin com 17.013 instalações (pesquisa no skills.sh). Nenhum dos 100 primeiros resultados é uma skill de suporte ao cliente. Ou seja, está a montar isto você próprio, que é mais ou menos o que as pessoas da comunidade do Hermes descrevem fazer. O meu guia de MCP para suporte ao cliente explica como é uma boa superfície de ferramentas para suporte.

Como configurar com segurança

Esta é a ordem em que eu construiria. O objetivo é a forma que funciona: o Hermes lê a Shopify, escreve um rascunho no seu helpdesk e uma pessoa envia-o.

1. Crie uma app no Dev Dashboard com permissões só de leitura

O caminho antigo, criar uma app personalizada no admin da Shopify e copiar um token, está fechado. A documentação da Shopify diz "You can no longer create new admin-created custom apps" e encaminha os novos projetos para o Dev Dashboard (admin-created custom apps). A skill do Hermes regista a mesma mudança.

No Dev Dashboard, escolha apenas o que uma consulta de suporte precisa:

• read_orders, read_customers, read_products, read_fulfillments.
• Dispense write_orders. É a permissão de que o refundCreate precisa, e um bot que não consegue reembolsar não reembolsa por engano. A verdadeira automação de reembolsos precisa de aprovações, não de esperança.
• Conheça o limite de 60 dias. read_orders cobre "orders created within the last 60 days", e os mais antigos precisam de read_all_orders, ao qual "you must request access to" (access scopes). O cliente que pergunta por um pedido de março receberá um confiante "não consigo encontrar" se não planear isto.

Nomes, e-mails, telefones e moradas de clientes são dados protegidos de clientes, e os campos para os quais a sua app não está aprovada voltam como null (protected customer data). Teste com um pedido real antes de assumir que o filtro de e-mail devolve o que espera.

2. Planeie o token de 24 horas

As apps novas na sua própria loja obtêm o token através do client credentials grant. A Shopify é precisa: expires_in é "Always 86399 (24 hours)", não há token de renovação e "only works when the app and the store belong to the same Shopify organization" (client credentials grant). Uma agência que ligue o Hermes à loja de um cliente não o pode usar de todo.

O Hermes não gera esse token por si. A sua configuração MCP aceita headers estáticos resolvidos a partir de ${VAR} no .env, ou auth: oauth, que é o fluxo interativo de authorization code com PKCE (MCP config reference). Não há opção de client credentials, e a skill da Shopify também lê um token estático.

A solução que eu usaria é aborrecida e funciona: uma tarefa cron que pede um token novo a cada 20 horas e reescreve SHOPIFY_ACCESS_TOKEN em ~/.hermes/.env. O próprio agendador do Hermes pode executá-la. Trate-a apenas como infraestrutura de produção, porque na manhã em que falhar em silêncio é a manhã em que todas as consultas de pedidos devolvem 401.

3. Dê ao Hermes uma ferramenta estreita, não GraphQL em bruto

A skill da comunidade dá ao Hermes o curl e toda a GraphQL Admin API. A sua própria nota de segurança diz que as mutações "create products, charge refunds, cancel orders" e pede ao agente que primeiro "confirm with the user" (página da skill). Isso é um prompt, não uma fechadura.

Prefiro envolver duas ou três consultas só de leitura num pequeno servidor MCP seu, get_order_by_number, get_orders_by_email, get_fulfillment, e listar apenas essas:

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

É uma montagem minha a partir da documentação do Hermes, não um exemplo oficial. Depois de definir include, o Hermes regista apenas essas ferramentas (documentação MCP do Hermes). Uma ferramenta de reembolso que não existe não pode ser convencida a executar. O seu wrapper guarda o token da Shopify, por isso o Hermes nunca o vê.

4. Redija no seu helpdesk, não para o cliente

A maioria das lojas Shopify atende o suporte num helpdesk como o Gorgias, Zendesk ou Freshdesk, cada um com a sua própria barra lateral da Shopify (aqui está a configuração do Gorgias com a Shopify). O Hermes também não tem entradas MCP de helpdesk, por isso ligaria um como mostrei em Hermes Agent para o Freshdesk e daria ao Hermes uma única ferramenta de escrita: uma nota interna. No Zendesk, é a mesma integração com a Shopify que os seus agentes já usam, mais um comentário privado.

A comunidade do Hermes chega à mesma forma. Um utilizador que usava o Hermes sobre a sua caixa de entrada descreveu a falha de que isto protege:

"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

Os números da própria eesel dizem o mesmo com outro sotaque. Uma joalharia online alemã no Zendesk e na Shopify executou a eesel com tráfego real durante um teste: 93 % de precisão na triagem e 88 % dos rascunhos a apontar na direção certa, mas os agentes enviaram apenas 12 % dos rascunhos tal como estavam, e cerca de 7 % continham um erro factual. É por isso que cada implementação da eesel é agora simulada com tickets históricos antes de entrar em produção, e por isso os rascunhos vêm antes dos envios. É o padrão de assistência ao agente, e é também o primeiro passo certo para o Hermes.

5. Escolha um gatilho e atenção ao cabeçalho do webhook

O Hermes precisa de saber quando olhar para algo. Tem três opções:

• Sob pedido. Um agente cola um número de pedido no Slack e pergunta ao Hermes. O mais simples, e há uma pessoa no circuito o tempo todo.
• Sondagem por cron. O Hermes verifica o helpdesk à procura de tickets novos a cada poucos minutos. Não é preciso um endpoint público.
• Webhook da Shopify. Um evento orders/fulfilled ou refunds/create avisa diretamente o Hermes.

A terceira tem uma armadilha. A Shopify assina os webhooks com "a base64-encoded HMAC signature in the X-Shopify-Hmac-SHA256 header" (verify webhook deliveries). O Hermes aceita as assinaturas do GitHub, GitLab, Standard Webhooks e as suas próprias genéricas, e "If a secret is configured but no recognized signature header is present, the request is rejected" (webhooks do Hermes). O cabeçalho da Shopify não está na lista.

Precisaria de um pequeno relay, um worker ou um fluxo n8n, que verifique a assinatura da Shopify e volte a assinar com X-Webhook-Signature-V2. Dois detalhes de tempo também contam. A Shopify dá cinco segundos para todo o pedido e apaga uma subscrição criada por API após 8 novas tentativas falhadas ao longo de 4 horas. O Hermes limita cada rota a 30 pedidos por minuto, por isso uma rajada de orders/create numa venda relâmpago precisa da definição coalesce.

A ação Send HTTP request do Shopify Flow é outra fonte de gatilhos, com segredos e novas tentativas até 24 horas, e uma boa porta de entrada para a automação da Shopify em geral. Mais sobre o lado da Shopify no meu artigo sobre gatilhos de webhooks de pedidos.

6. Teste com os tickets do mês passado antes de confiar

O Hermes não tem modo de repetição. Para saber se está pronto, recolha 100 tickets resolvidos de WISMO e devoluções, execute o Hermes sobre eles num perfil de sandbox e compare os seus rascunhos com o que a sua equipa realmente enviou. Avalie duas coisas: se encontrou o pedido certo e se disse algo que os dados do pedido não sustentam.

Um tópico do Reddit sobre exatamente esta configuração tinha o melhor aviso numa linha que encontrei. Um utilizador sugeriu uma regra rígida no ficheiro SOUL.md do Hermes para não adivinhar. A resposta:

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

u/Sjsamdrake, Reddit

É justo. O que evita respostas inventadas, como toda a equipa de suporte de ecommerce acaba por aprender, é uma consulta que falha em voz alta e uma pessoa a ler o rascunho, não uma frase no prompt. O meu guia sobre alucinações de IA no suporte aprofunda os testes.

Que pergunta da Shopify precisa de que porta?

Esta é a parte que as pessoas saltam, por isso aqui está como algo em que pode clicar. Escolha a pergunta que um cliente envia e veja que superfície da Shopify lhe responde e se o Hermes a consegue alcançar:

O padrão fica claro quando o vê assim, e é por isso que a maioria dos chatbots de rastreamento de pedidos começa pelo WISMO e pára antes dos reembolsos. As perguntas sobre políticas são grátis. As perguntas sobre pedidos custam-lhe uma app, uma tarefa de token e um wrapper. Tudo o que movimenta dinheiro fica com uma pessoa.

Onde os clientes falam e onde o Hermes escuta

Mesmo com os dados resolvidos, há a questão de onde decorre a conversa. O gateway do Hermes cobre uma longa lista de apps de chat, mas as que os clientes da Shopify realmente usam só em parte coincidem:

• Chat da loja: não. O Hermes não tem widget para sites, que é o que a maioria entende por chatbot de ecommerce. O mais próximo é o seu servidor de API, sobre o qual a documentação avisa que "gives full access to hermes-agent's toolset, including terminal commands" (API server). Não é algo para pôr atrás de uma caixa de chat pública.
• E-mail: sim. O Hermes consulta uma caixa IMAP a cada 15 segundos por predefinição e responde em texto simples (documentação de e-mail).
• WhatsApp: sim, com uma lacuna. O Hermes suporta a Cloud API oficial da Meta, mas "Message-template support... is not yet implemented in Hermes" (documentação do WhatsApp Cloud). Sem modelos, não consegue enviar uma atualização de envio passadas 24 horas desde a última mensagem do cliente, o que exclui o suporte proativo por WhatsApp.
• Instagram e Messenger: não. Nenhum aparece na lista de canais do gateway.

E há o acesso predefinido. "If no allowlists are configured... all users are denied" (documentação de segurança). Remetentes desconhecidos recebem um código de emparelhamento que aprova à mão. Para responder a desconhecidos teria de definir GATEWAY_ALLOW_ALL_USERS=true, algo que a mesma documentação diz para nunca fazer em produção num bot com acesso ao terminal. É o sinal mais claro de que o Hermes foi construído como o seu agente, não como o dos seus clientes.

Como comparação, a resposta da própria Shopify para o chat da vitrine é o Shopify Inbox. A página de migração da Shopify diz aos lojistas que querem chat com IA sem código para "use the Inbox agent in Shopify Inbox."

É gratuito e tem classificação de 4,6 em 5.804 avaliações, mas é primeiro um assistente de vendas, e as suas consultas de pedidos exigem que o cliente inicie sessão. As avaliações também mencionam as lacunas que uma equipa de suporte sente:

"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

A Shopify respondeu que o agente "always shows buyers an option to connect to staff after every message", por isso pode ser um problema de configuração. E o Shopify Sidekick está fora de questão para este trabalho: "Sidekick can't talk to your customers or handle customer support conversations on your behalf" (configuração do Sidekick).

Quanto custa realmente o Hermes na Shopify

A licença é gratuita e a Admin API da Shopify não cobra por chamada. A fatura está em tudo o resto.

Tokens do modelo. O Nous Portal tem Free a 0 $, Plus a 20 $/mês com 22 $ de crédito, Super a 100 $ e Ultra a 200 $. Também pode ligar um plano ChatGPT elegível para a inferência.

Limites de taxa da Shopify. Não custam dinheiro, mas limitam a velocidade das consultas e são partilhados com todas as outras apps da loja (rate limits):

Uma consulta de suporte custa poucos pontos, por isso raramente atrapalha a redação de rascunhos. Atrapalha quando uma tarefa de avaliação noturna e uma app de relatórios atingem a mesma loja em simultâneo. Os preços dos planos estão no meu detalhe dos preços da Shopify.

A infraestrutura. Uma tarefa de renovação de token, um relay de webhooks, um wrapper MCP só de leitura, uma ligação ao helpdesk e um sistema de avaliação. Cada um é um fim de semana. Juntos, são um pequeno produto que passa a manter. Quando um utilizador do Hacker News descreveu a ligação do Hermes às suas próprias ferramentas de negócio, foi uma vitória interna, não voltada para o cliente:

"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

Esse é o ponto ideal, e vale a pena reparar nele. O meu comparativo de construir ou comprar põe números no lado da engenharia.

Onde o Hermes na Shopify deixa de funcionar

Tudo o que ficou acima pressupõe a forma de rascunho. Aponte o Hermes diretamente aos clientes e esbarra nas paredes da minha análise de suporte:

• As aprovações vão para quem estiver a conversar. Em plataformas de mensagens, o Hermes "waits for the user to reply" yes ou approve (documentação de segurança). Num fio de WhatsApp com um cliente, esse utilizador é o cliente. E a barreira cobre comandos de shell, não chamadas à API.
• A memória é por perfil. A memória integrada é MEMORY.md (2.200 caracteres) e USER.md (1.375), partilhada por todos os chats que o perfil executa (documentação de memória). Não a deixe guardar dados de clientes.
• As execuções por webhook não podem perguntar a uma pessoa. Em superfícies sem supervisão, como os webhooks, os comandos perigosos são negados por predefinição. Bom para a segurança, mas significa que uma execução por evento de pedido só pode redigir ou alertar.
• A janela de 60 dias. Tratada acima, e é a que produz respostas erradas em vez de erros.

O conselho da comunidade do Hermes para quem se sinta tentado a ir para produção é o mesmo que o meu:

"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

"Quase-FAQ" é exatamente aquilo de que uma fila de ecommerce está cheia: uma pergunta de WISMO com um "podem também alterar a morada?" colado no fim.

Hermes vs Shopify Inbox vs eesel para o suporte da Shopify

Para o panorama mais amplo, o meu levantamento das melhores IA para o suporte da Shopify e a lista dos melhores helpdesks com IA para a Shopify vão mais fundo, e as alternativas ao Hermes Agent cobrem o lado dos agentes gerais.

Se o seu helpdesk é o Gorgias, tenha em conta os preços do Gorgias para lojas Shopify, já que a sua IA é faturada por interação automatizada.

Deve usar o Hermes no suporte da sua Shopify?

Depois de ler as duas documentações, é aqui que chego.

Sim, se tiver um engenheiro que goste disto e a tarefa for um ajudante interno: a sua equipa pergunta ao Hermes por um pedido no Slack, ou ele redige respostas WISMO no helpdesk para uma pessoa enviar. Uma app do Dev Dashboard com permissões só de leitura, uma tarefa de renovação e um wrapper de três ferramentas é uma configuração defensável, e o cron do Hermes torna-a útil.

Não, se quer a IA a falar com clientes no chat da sua loja, a emitir reembolsos ou a cobrir pedidos com mais de 60 dias sem aprovação adicional. A mesma resposta se ninguém puder assumir uma tarefa de token e um relay de webhooks. Isso não são falhas do Hermes. É um agente geral feito para trabalhar para o seu operador, e o suporte da Shopify é um trabalho com um desconhecido do outro lado.

O caminho do meio em que a maioria das lojas acaba é um chatbot de IA para a Shopify já pronto ou um agente de helpdesk para os clientes, com o Hermes como assistente de retaguarda da própria equipa se alguém lá gostar de experimentar. Tomei a mesma decisão na versão com ChatGPT desta questão, e a malta dos chatbots open source chega ao mesmo sítio.

Experimente a eesel para o suporte da Shopify

Se o que quer é uma IA a responder a "onde está o meu pedido?" na sua loja Shopify esta semana, a eesel funciona como uma nova contratação de suporte que já conhece o seu catálogo. Aprova-a no ecrã de instalação da Shopify, sem token para colar, e ela consulta pedidos por número ou e-mail, verifica o rastreamento e lê produtos em tempo real, dentro do Gorgias, Zendesk, Freshdesk ou do seu próprio widget de chat. Devoluções, alterações de morada, reembolsos e cancelamentos podem, cada um, aguardar a aprovação de uma pessoa, que é a proteção que o Hermes o obrigaria a construir sozinho.

Também é confortável para o público do Hermes. A CLI da eesel executa a mesma colega a partir de um terminal: eesel integrations connect shopify liga a loja, eesel approvals list mostra os reembolsos à espera de si, e agentes de programação como o Claude Code ou o Cursor também a podem conduzir. O preço é simples: 100 créditos grátis, depois planos desde 299 $/mês por 500, em que um ticket ou chat é um crédito, independentemente de quantas consultas exija. Experimente a eesel na sua própria loja.