Claude para Gorgias: 4 formas reais de conectá-los em 2026

O Claude provavelmente já está na vossa conta do Gorgias

Eu construo agentes de IA na eesel, o que significa que passo a maior parte da minha semana na metade nada glamurosa desse problema: retrieval, chamadas de ferramentas e a lógica de handover que decide quando um modelo deve calar a boca e buscar um humano. Em milhares de filas de suporte ao vivo, a lição mais confiável é que o modelo raramente é o que quebra. O encanamento ao redor dele, sim.

Vale a pena guardar isso aqui, porque a resposta honesta para "qual modelo o Gorgias usa" está enterrada em um documento de segurança em vez de numa página de marketing. O FAQ de segurança do Gorgias afirma isso claramente:

"AI Agent uses a combination of multiple secure LLM providers, including OpenAI, Anthropic, and internally fine-tuned LLMs."

A página de produto do AI Agent conta uma história mais restrita, citando apenas uma parceria com a OpenAI e exibindo apenas um logo da OpenAI. Ambas são verdadeiras. A Anthropic está na mistura; a OpenAI é o distintivo na porta.

O que importa para quem está procurando o Claude aqui é o que nenhuma das duas páginas menciona: o Gorgias não publica nenhum nome de modelo, nenhuma versão de modelo, e nenhuma chave de troca. Vocês não podem rotear os tickets de reembolso para o Claude e as perguntas de produto para algo mais barato. Então a pergunta prática não é "posso usar o Claude com o Gorgias", mas "onde exatamente o Claude pode se encaixar."

Essa pergunta tem, aliás, uma resposta quase idêntica em outros helpdesks. Percorri o mesmo terreno para Claude para Zendesk, e a forma do problema mal muda: os fornecedores de modelo constroem diretórios, os fornecedores de helpdesk constroem agentes, e ninguém constrói a ponte que vocês realmente queriam.

As quatro rotas, e quais funcionam sem vocês

Existem exatamente quatro formas de colocar o Claude perto de uma fila do Gorgias em 2026. Duas são ferramentas de operador que só se movem quando uma pessoa as conduz. Duas podem rodar sem supervisão contra a fila, e ambas exigem que vocês construam o loop sozinhos.

O restante deste post percorre cada uma delas, com os limites que decidem se sobrevivem ao contato com uma fila real.

Rota 1: o conector MCP do Gorgias

Essa é a história oficial do Claude, e é muito boa no que faz. O Gorgias opera um servidor MCP remoto próprio em https://mcp.gorgias.com/mcp, e o próprio guia de configuração conduz vocês pela adição no Claude Desktop em Customize, depois Connectors, depois Add custom connector. Usuários do Claude Code recebem, em vez disso, uma linha única: claude mcp add --transport http gorgias https://mcp.gorgias.com/mcp.

O anúncio da beta aberta é refrescantemente direto sobre o acordo: está incluído sem custo adicional em qualquer plano, o AI Agent não é necessário, e vocês trazem a própria assinatura de modelo. A configuração é estimada em cerca de cinco minutos, e o Gorgias mantém um cookbook de MCP público com receitas de prompts.

O Gorgias também traça a linha entre seus dois produtos de IA com mais clareza do que a maioria dos fornecedores se dá ao trabalho de fazer. O AI Agent "vive dentro do vosso helpdesk e responde aos clientes em vosso nome", enquanto o MCP "permite que vocês operem a vossa conta do Gorgias a partir de uma ferramenta de IA externa."

O que ele consegue realmente tocar

As leituras estão ativas e são amplas. As escritas estão parcialmente cercadas enquanto a beta roda.

Segundo a documentação, a conexão consegue ler e analisar tickets, auditar e atualizar configurações, revisar handovers do AI Agent, editar informações de produto, revelar padrões de voz do cliente, consultar analytics, responder a clientes, postar notas internas, atualizar status e prioridade de tickets, gerenciar regras do Gorgias, e visualizar e atualizar artigos da central de ajuda. O anúncio da beta acrescenta a ressalva: edições de macros e escritas de configuração do AI Agent estão bloqueadas e serão liberadas ao longo dos próximos meses.

O bloqueio por plano fica do lado do Claude, não do lado do Gorgias. No Free, Pro e Max, um usuário adiciona o conector sozinho; no Team e Enterprise, um Owner precisa adicioná-lo primeiro no nível da organização. Contas Free são limitadas a um conector personalizado.

Onde ele brilha. Perguntem quais tags do Gorgias são peso morto, por que o vosso tempo de primeira resposta caiu na semana passada, ou em quais handovers a configuração do vosso agente continua errando. Isso é trabalho real, e é trabalho que nenhum dashboard faz bem.

Também é a forma mais rápida que conheço de auditar uma configuração já existente. Apontem para as vossas entradas de guidance e perguntem quais nunca foram recuperadas, ou façam com que ele leia os vossos analytics do Gorgias e explique uma queda de CSAT em linguagem simples.

Onde ele para. É uma ferramenta com pessoa no loop. Ninguém roda uma fila de reembolsos numa terça à noite deixando uma janela do Claude Desktop aberta, e o Gorgias não finge o contrário.

Rota 2: integrações HTTP e variáveis de macro

Essa é a rota que a maioria imagina quando diz "conectar o Claude ao Gorgias", e é aquela em que a documentação fecha a porta silenciosamente.

As HTTP Integrations permitem que o Gorgias faça POST para o vosso endpoint em eventos de ticket, e estão disponíveis em qualquer plano de Helpdesk. A pegadinha é um número: cada requisição tem um timeout de 5 segundos. Uma chamada de modelo com cold start e algum contexto real na frente não cabe de forma confiável em cinco segundos, e as regras de retry fazem a primeira tentativa importar mais do que vocês gostariam.

• Conexão aceita mas sem resposta em 5 segundos: o Gorgias tenta novamente apenas se a integração usar OAuth2. Integrações com autenticação por cabeçalho têm exatamente uma tentativa.
• Um status de erro como 429 ou 500: sem retry, de qualquer forma.
• Quando os retries se aplicam, são 3 tentativas com backoff de 10, 20 e 40 segundos.
• Após 500 falhas consecutivas, o Gorgias desativa a integração. O contador reseta a cada sucesso.

Existem três restrições adicionais que moldam o design mais do que o timeout. Primeiro, o construtor de regras não tem nenhuma ação HTTP em nenhuma de suas 21 opções THEN, então vocês não conseguem escrever "se a intenção for reembolso, chame meu modelo." Segundo, os hooks HTTP de macro disparam quando um agente aplica a macro e são de mão única, sem nenhum caminho documentado de volta da resposta para a reply. Terceiro, as condições de regra Customer Data e Customer Other Integrations estão ambas marcadas como temporariamente desativadas, então ramificar uma regra com base no que o vosso modelo retornou não está atualmente no cardápio.

A resposta ainda pode chegar a uma reply, mas apenas via variáveis de back-office, com sintaxe como {{ticket.customer.integrations[9141].data.delivery_cost}}, onde o número é o ID da integração pego na sua URL de configurações. E aqui está o modo de falha que me tiraria o sono: uma variável ausente é renderizada como um espaço em branco, não como um erro. Um caminho quebrado não falha em voz alta. Ele envia uma reply a um cliente com um buraco dentro.

A leitura honesta é que integrações HTTP são uma ótima forma de trazer uma busca de pedido para a barra lateral e uma forma ruim de colocar um modelo de linguagem na frente de um cliente. Quem as usa para o primeiro caso deveria ler primeiro nosso guia de automação do Gorgias, e em segundo o passo a passo do painel lateral do Shopify.

Vale notar que os mesmos muros se aplicam se vocês estivessem planejando trocar por outro fornecedor de modelo em vez do Claude. A rota Gorgias e ChatGPT esbarra no mesmo teto de 5 segundos, porque a restrição é o helpdesk, não o modelo.

Rota 3: a API e o vosso próprio serviço

Se vocês querem que o Claude realmente escreva respostas no Gorgias, essa é a rota que funciona, e é um projeto de verdade, não um fim de semana.

O formato é: confirmar a integração HTTP imediatamente, enfileirar a chamada do modelo, e depois escrever a resposta de volta com POST /api/tickets/{ticket_id}/messages. Ou pular o lado do push completamente e fazer polling em GET /api/events, que não tem penhasco de 5 segundos nem risco de auto-desativação, ao custo de latência.

A API do Gorgias autentica via HTTP Basic com o vosso e-mail e uma chave de API, embora apps públicos precisem usar OAuth2. Os limites de taxa merecem ser conferidos duas vezes, porque o Gorgias publica dois números diferentes: a página de preços lista 2 requisições por segundo como recurso do plano (4 no Enterprise), enquanto a referência para desenvolvedores dá 80 requisições a cada 20 segundos no OAuth2 e 40 a cada 20 segundos com uma chave de API, com o Enterprise recebendo esses mesmos números numa janela mais apertada de 10 segundos. Orcem pelo número mais baixo. Também não existe nenhuma API de assinatura de webhook, o que surpreende quem está migrando de outros helpdesks.

Dois detalhes operacionais que vale a pena sinalizar antes de definir o escopo. O Gorgias agora retém eventos por apenas 12 meses, com IDs mais antigos retornando 404. E chaves de API são por usuário com acesso total à conta, o que significa que a chave de um admin que está saindo é uma dependência de produção viva. Confiram os vossos papéis e permissões antes que alguém entregue um notebook.

Do lado do Claude, vocês têm três formas de entrada. O conector MCP da Messages API permite que o vosso backend chame ferramentas do Gorgias diretamente, com listas de permissão por ferramenta, embora apenas chamadas de ferramenta da especificação MCP sejam suportadas. O Claude Agent SDK coloca nas vossas mãos o loop de agente do Claude Code em Python ou TypeScript. Ou vocês escrevem o loop vocês mesmos contra a API bruta.

Nosso guia de integração do Claude cobre como essas três se diferenciam na prática, e Claude managed agents cobre a opção hospedada caso vocês prefiram não rodar o loop sozinhos.

Uma linha de licenciamento importa se vocês estivessem planejando entregar isso a clientes: desenvolvedores terceiros não podem oferecer logins do claude.ai nem limites de taxa aos seus usuários sem aprovação prévia. Vocês pagam tarifas de API.

Esse é o ponto em toda conversa de construir versus comprar em que alguém diz a parte silenciosa. Um cliente nosso colocou isso melhor do que eu conseguiria:

"We could try to write our own LLM application but we didn't want to invest our time into that. We wanted something that we would not have to maintain."

Karel, GENERAL BYTES

Rota 4: Claude no Chrome conduzindo a aba do Gorgias

Tecnicamente isso funciona. O Claude no Chrome está disponível em qualquer plano pago sem custo adicional, ele opera o navegador a partir de screenshots, e uma aba do Gorgias é só uma página web.

Eu não colocaria isso numa fila de suporte, e a Anthropic também não. Sua própria orientação de segurança desaconselha o uso com contas de trabalho que guardam dados sensíveis da empresa, e com sites que guardam informações pessoais de outras pessoas. Uma caixa de entrada de suporte é as duas coisas ao mesmo tempo, disfarçada. Também é exclusivo do Chrome, beta, bloqueado para organizações HIPAA, e de assento único por natureza.

Usem para explorar uma visualização do Gorgias desconhecida ou fazer engenharia reversa de uma tela de relatórios. Não usem para responder clientes. Nosso post sobre Claude for Chrome se aprofunda mais no que a extensão faz bem.

O que isso realmente custa por ticket

Aqui é onde a matemática do ecommerce fica interessante, porque a conta de tokens é quase irrelevante perto da conta do helpdesk.

Os preços atuais do Claude colocam o Sonnet 5 em US$ 2 por milhão de tokens de entrada e US$ 10 por milhão de saída. Uma chamada do tamanho de um ticket, generosamente dimensionada, fica perto de um centavo. O Opus 5 a US$ 5 e US$ 25 fica em alguns centavos. Leituras de prompt caching são cobradas a um décimo do input base, então um bloco de conhecimento estático fica barato rápido. Não há nenhum prêmio de contexto longo na linha Claude 5, então uma thread de ticket gorda custa o mesmo por token que uma curta.

Agora o lado do Gorgias. A página de preços roda dois medidores contra a mesma caixa de entrada, e essa é a parte que eu vejo equipes lerem errado com mais frequência.

Se vocês quiserem a leitura plano por plano em vez do resumo, nossa comparação de planos do Gorgias detalha cada um, e o guia de limite de tickets explica o que conta como faturável.

Duas coisas nessa tabela causam dano real se passarem despercebidas.

A primeira é que um ticket totalmente automatizado é cobrado duas vezes. Segundo a documentação de cobrança, uma tarifa de ticket se aplica a qualquer ticket com pelo menos uma mensagem enviada pelo Gorgias, seja enviada por um humano, pelo AI Agent ou por uma regra. A tarifa de automação se empilha em cima quando nenhum humano toca o ticket em 72 horas. Entreguem o ticket a uma pessoa e vocês pagam apenas a tarifa de ticket.

A segunda é que US$ 1,50 é a taxa de excedente, não a taxa. Dentro da vossa franquia, o preço efetivo fica em torno de US$ 0,90 por interação resolvida em planos anuais e cerca de US$ 1,00 no Starter, o que bate com o próprio enquadramento do Gorgias. Cruzem a linha e a mesma interação sobe pela metade no Starter e em dois terços em qualquer outro lugar.

Há uma consequência ao contrário aqui, e é o argumento mais forte para as rotas 2 e 3 que ninguém fala em voz alta. O medidor de interação automatizada conta AI Agent, Flows, Order Management e Article Recommendations. Uma resposta que o vosso próprio serviço posta via API é um ticket faturável, não uma interação automatizada. Construam vocês mesmos e vocês pulam o medidor caro completamente. Vocês só pegam uma conta de engenharia no lugar.

Coloquem os vossos próprios números:

O que nenhuma das quatro rotas resolve

Por baixo das quatro rotas estão as mesmas restrições, e são o motivo pelo qual eu não chamaria nenhuma delas de resposta pronta.

O vosso arquivo de tickets não é uma fonte de conhecimento. O Gorgias AI Agent se baseia em entradas de guidance (100 por loja, 30.000 caracteres cada), artigos da central de ajuda, uma sincronização do site público que pega uma página de cada vez sem subpáginas e sem login, arquivos enviados e dados do Shopify. As macros são um não explícito. Tickets resolvidos no passado não estão na lista. É uma pena, porque o arquivo é o único lugar onde a verdadeira voz de marca da vossa equipe vive, e é por isso que tantas configurações de resposta automática do Gorgias soam como uma central de ajuda em vez da vossa equipe.

Vocês não conseguem testar em modo seco contra o próprio histórico. O Playground reproduz um ticket existente por vez. Não há nenhuma simulação em lote ou histórica documentada em lugar nenhum, e as ações ficam desligadas por padrão nos testes mas afetam dados reais assim que ativadas. Ir ao ar é, portanto, uma decisão de julgamento em vez de uma medição, que é exatamente o momento em que os líderes de suporte ficam nervosos. Um avaliador no G2 colocou o peso da configuração com justiça:

"The AI Agent is powerful, but the training and knowledge base configuration can be complex. There are a lot of rule nuances and automation layers that require careful setup, and the learning curve can be steep when optimizing for more advanced use cases."

Hannah S., Operations, Feb 2026

Nada disso significa que o agente seja ruim. Um avaliador de 5 estrelas admitiu os dois lados numa única frase, que é mais ou menos o resumo mais justo disponível:

"While we still have quite a few snags with the AI agent who does give the wrong answers sometimes, it is still faster and more efficient than Zendesk."

Karolina C., Marketing, Mar 2026

E para ser justo com o produto, as ações são a metade que funciona bem: seis ações do Shopify cobrindo cancelamento, edição de endereço, remoção de item, substituição, reenvio grátis e notas de pedido, mais Recharge, Loop e vários 3PLs. O guia de fluxos de gestão de pedidos cobre como eles se encaixam. Os limites publicados, porém, são específicos o suficiente para planejar em torno deles: cancelamentos não se propagam para 3PLs, edições de endereço não conseguem reconciliar imposto ou frete, e substituições lidam com um item de cada vez.

Existe mais uma barreira que pega tarde os lojistas sem Shopify. O AI Agent exige Shopify e não é suportado no BigCommerce, no Magento nem no WooCommerce, mesmo que o próprio helpdesk os suporte. Um cliente pagante de longa data descreveu o padrão com precisão:

"The AI Agent follows the same pattern, offering full functionality only for Shopify and requiring an awkward email-per-store setup that doesn't fit every business."

Frank A., Digital, Mar 2026

E sobre custo, a reclamação mais comum é justamente a que o modelo de dois medidores cria:

"The main frustration with Gorgias is the pricing model, which is based on ticket volume rather than a flat monthly fee. As our order volume grows and customer inquiries increase, the cost scales up quickly in ways that can be difficult to predict and budget for. During peak seasons like the holidays when support volume spikes, the costs can increase significantly in a short period."

Mitchell O., Sales, Apr 2026

Vale dizer que o modelo por ticket também tem defensores de verdade. O mesmo avaliador do Capterra que sinalizou o teto do Shopify elogiou cobrar por ticket em vez de por usuário, porque isso deixava todo mundo na empresa usar a ferramenta sem ansiedade de assento. Qual modelo é melhor depende inteiramente de se o vosso headcount ou o vosso volume de pedidos cresce mais rápido.

O que eu realmente faria

Se vocês querem que o Claude leia o vosso helpdesk, instalem o conector MCP hoje. Não custa nada, leva cinco minutos, e é a melhor ferramenta de análise que o Gorgias lançou em um bom tempo. Apontem para os vossos handovers e para os vossos relatórios do Gorgias e deixem que ele diga o que está quebrado.

Se vocês querem que o Claude responda aos vossos clientes, sejam honestos sobre o que a rota 3 é. É um serviço que agora vocês possuem, com um timeout de 5 segundos a montante, uma janela de retenção de eventos de 12 meses, e uma escala de plantão. Equipes com um engenheiro de backend sobrando e requisitos incomuns deveriam absolutamente construir isso. A maioria das equipes de ecommerce não tem esse engenheiro sobrando, e as que tentam geralmente redescobrem o porquê no segundo mês.

Se vocês estão antes disso e ainda decidindo se vão automatizar de algum jeito, comecem pelo guia de configuração do Gorgias AI e pelo veredito honesto em vale a pena o Gorgias AI.

Se o que vocês realmente queriam era um modelo que responde na vossa voz com o vosso histórico por trás, nenhuma dessas quatro rotas é o caminho mais curto até lá, o que me leva ao viés óbvio deste post.

eesel AI para Gorgias

Eu trabalho nisso, então avaliem de acordo, mas é construído exatamente para a lacuna descrita acima.

O eesel AI se conecta ao Gorgias via OAuth e treina com as três fontes que o agente nativo não toca: os vossos tickets resolvidos no passado, as vossas macros, e a vossa central de ajuda. É isso que faz as respostas soarem como a vossa equipe em vez da vossa documentação. Ele adiciona Notion, Google Drive, Confluence e Slack em cima, e lê dados do Shopify ao vivo para pedidos, rastreamento e devoluções.

A parte que eu mais me importaria como comprador é a simulação. Antes de qualquer coisa ir para um cliente, vocês rodam o agente sobre os vossos tickets passados, comparam as respostas dele com o que a vossa equipe realmente enviou, e recebem um relatório de lacunas pontuado. Vocês podem rodar isso durante o teste gratuito, antes de gastar qualquer coisa. A configuração é estimada em menos de 30 minutos, e a conexão é com o próprio Gorgias via OAuth, em vez de por uma plataforma de loja, então não fica presa atrás do Shopify.

O preço é baseado em uso, US$ 0,40 por ticket, sem tarifa de plataforma e sem cobrança por assento. Contra US$ 1,50 por interação automatizada além da vossa franquia do Gorgias, essa diferença se acumula rápido em época de pico, exatamente quando dói mais. Há US$ 50 de uso grátis para começar, sem cartão exigido.

Se vocês estão avaliando isso contra o agente nativo, nosso panorama de Gorgias AI e o roundup de alternativas ao Gorgias aprofundam ambos, e experimentar o eesel leva mais ou menos o mesmo tempo que ler os dois.