Como adicionar um agente de IA ao seu site (que realmente responde)

Resumo

Adicionar um agente de IA ao seu site leva uma tag de script e cerca de cinco minutos. Se ele realmente responde aos clientes depende de três coisas que o snippet não faz: o que ele pode ler, para onde envia as perguntas que não sabe responder e com que lentidão você o amplia de um link de pré-visualização para o site inteiro.

Escolha o caminho de instalação pelo lugar onde o seu suporte já funciona, não pelo construtor do seu site. Se a sua equipe atende chat no Zendesk ou no Freshdesk, coloque a IA dentro desse widget para que os repasses caiam na sua fila. Se você ainda não tem chat, um widget independente com repasse por e-mail ou ticket é mais rápido de montar.

O chat bubble da eesel é um script assíncrono que responde a partir da sua central de ajuda, da sua documentação e do seu site, e entrega ao seu helpdesk, como ticket com resumo da conversa, tudo o que não consegue resolver. A SE Ranking o usa no chat ao vivo do Zendesk para três produtos e teve 2.100 chats respondidos primeiro pela IA em um mês, com cerca de 1.260 repassados para pessoas.

Por que "adicionar um agente de IA" quase não é sobre a instalação

Passo boa parte da semana olhando o que as pessoas digitam na busca antes de comprar software de suporte, e "como adicionar um agente de IA a um site" é uma dessas frases em que a busca é menor do que a pergunta. Quem digita isso raramente trava na tag de script. Trava três semanas depois, quando o bot diz a alguém que o prazo de devolução é de 60 dias (é de 30), ou quando responde "fale com uma pessoa" com um formulário de contato.

Quando fiz a ChatGPT essa mesma pergunta como um líder de suporte, ela foi direto para três buscas sobre widgets web, fontes de conhecimento e repasse, e terminou a resposta perguntando qual helpdesk eu uso. É o instinto certo. O chatbot de IA que vai para o seu site tem três camadas, e só a de cima é a que você cola.

• O widget. O balão, suas cores, a saudação. Todo fornecedor deste guia o instala da mesma forma por baixo: uma tag de script colada nas suas páginas.
• O conhecimento. Aquilo a partir do qual ele responde. Sua base de conhecimento, central de ajuda, páginas de produto, PDFs, tickets antigos. É a camada que decide se as respostas estão certas.
• As saídas. O que acontece quando ele não sabe responder, ou quando o cliente precisa que o pedido dele seja consultado. Um widget sem saída é o "formulário de contato sofisticado" que todo cliente aprendeu a detestar.

Já vi isso acontecer em implantações reais da eesel. Em um teste, um comprador fez uma avaliação metódica de 67 testes, achou as respostas de conhecimento sólidas e mesmo assim desistiu porque o widget em si "é bem lento e muitas vezes trava". Em outro, uma equipe de tecnologia médica mandou ao agente da eesel a mensagem "copiei o snippet e não funciona no netlify" e, depois, "Funcionou". Ambos são problemas da camada de instalação. Nenhum deles é onde a maior parte do tempo vai.

A diferença entre um chatbot e um agente aqui é prática, não de marketing. Um bot baseado em regras segue um roteiro; um agente de IA lê o seu conteúdo, responde com as próprias palavras e pode executar ações delimitadas, como criar um ticket. Esse poder extra é o motivo de o conhecimento e as saídas importarem mais.

O que preparar antes de colar qualquer coisa

Faça estas quatro coisas antes de o widget chegar perto de uma página no ar. Cada uma leva uma tarde, e pular qualquer uma delas é como você acaba com um bot que é retirado duas semanas depois do lançamento.

1. Liste as 20 a 30 perguntas que ele precisa responder bem

Puxe o último mês de tickets de chat e e-mail e anote as perguntas mais frequentes. Elas viram o seu conjunto de testes mais adiante. Se você usa o Zendesk, o guia de exportação de tickets explica como extrair as conversas completas; o mesmo conjunto serve também como material de treinamento.

2. Limpe o conhecimento que ele vai ler

Todo fornecedor que verifiquei responde a partir de praticamente as mesmas fontes: artigos da central de ajuda, páginas rastreadas da web, arquivos enviados e, às vezes, tickets antigos. O problema é que um rastreador lê tudo, inclusive aquele comunicado de imprensa de 2022 com preços antigos. Um avaliador do G2 de um agente de IA para sites descreveu isso sem rodeios:

"Com todo o conteúdo que a Piper rastreia na fase inicial de onboarding, a revisão de qualidade antes do lançamento dá um trabalho enorme... Ajudaria ter um filtro para ver a data de publicação do conteúdo, para que possamos excluir blogs e comunicados de imprensa antigos que não queremos que a Piper use como referência."

Stephanie C., G2

Faça primeiro uma auditoria da base de conhecimento. Apague ou exclua tudo o que estiver desatualizado e escreva os três ou quatro artigos de que as suas principais perguntas precisam e que ainda não existem.

3. Decida para onde vão as perguntas difíceis

Dê nome ao destino antes do lançamento: uma fila do helpdesk, uma caixa de entrada compartilhada ou um atendente ao vivo em horário comercial. Depois dê nome aos gatilhos. Os mais comuns são o cliente pedir uma pessoa, uma pergunta sem fonte boa e qualquer assunto que você nunca quer que a IA trate sozinha (reembolsos, questões jurídicas, segurança da conta). O guia de boas práticas de repasse traz mais sobre como escrever essas regras.

4. Escreva o que ele nunca deve prometer

Esta é a etapa que a maioria das equipes pula. Quando a SE Ranking configurou o seu agente de chat ao vivo, a orientação foi explícita: responder na hora, no idioma do cliente, sem prometer o que a equipe não poderia cumprir, como um atendente ao vivo entrando agora, um desconto ou um reembolso. Escrever essa lista transforma uma preocupação vaga com alucinação de IA em três ou quatro regras testáveis.

"Como cliente, eu só quero a informação de que preciso. Não quero falar com um chatbot, mas também não quero falar com um humano, pelo mesmo motivo: normalmente eles não têm a informação de que preciso."

mrandish, Hacker News

Esse comentário é o briefing inteiro. Os clientes não odeiam bots; odeiam não receber a resposta.

Escolha o seu caminho de instalação

Há cinco maneiras realistas de colocar um agente de IA em um site, e a certa depende muito mais do seu helpdesk do que de o seu site rodar em WordPress ou Webflow. Escolha a situação mais próxima da sua.

Escolha a sua configuração para ver o caminho de instalação, onde o código vai e a armadilha em que mais gente cai nesse caminho.

Caminho 1: ative a IA dentro do widget de chat que você já tem

Se a sua equipe já atende chat em um helpdesk, comece por aqui. Eu diria que é o caminho mais subestimado, porque é aquele em que a camada de "saídas" já está pronta. A IA responde primeiro, e tudo o que ela não resolve cai na mesma fila, com as mesmas tags e SLAs com que a sua equipe trabalha hoje.

Veja como os quatro grandes helpdesks colocam o seu próprio agente de IA no widget do site, tudo a partir da documentação deles:

Alguns detalhes dessa documentação que mudam a forma de configurar:

• A Zendesk cobra por resolução automatizada, US$ 1,50 com compromisso e US$ 2,00 pay-as-you-go na sua página de preços, com 5 incluídas por agente ao mês no Suite Team e 10 no Suite Professional. Desde 18 de maio de 2026, a Zendesk classifica os resultados em níveis de resolução, e só uma resolução verificada é cobrada. O guia de agentes de IA da Zendesk cobre a configuração em detalhe.
• A Freshworks conta como sessão toda interação em uma janela de 24 horas. Duas coisas pegam as pessoas de surpresa: uma mensagem de boas-vindas de um fluxo de início de conversa consome uma sessão mesmo que o visitante nunca responda, e pré-visualizar o agente enquanto você o constrói também consome sessões. Mais detalhes no artigo sobre consumo de sessões do Freddy.
• A Gorgias coloca o AI Agent no chat somente quando uma loja Shopify está conectada; a documentação diz que lojas BigCommerce, Magento e WooCommerce não são compatíveis. Um ticket totalmente resolvido pela IA é cobrado tanto pela taxa do ticket quanto pela taxa de automação, conforme a documentação de cobrança da Gorgias. Veja o post sobre o preço do Gorgias AI Agent para números calculados.
• A HubSpot permite definir uma porcentagem de cobertura de conversas, para que o agente assuma só alguns chats no início, e escolher o horário de funcionamento. Isso é um lançamento suave embutido. O guia do Breeze Customer Agent cobre o restante.

O agente nativo não é a sua única opção neste caminho. Você também pode conectar uma IA separada ao mesmo widget. Foi o que a SE Ranking fez: a eesel responde ao chat ao vivo do Zendesk da SE Ranking, da Planable e da SE Visible, um agente por produto, cada um alimentado pela sua própria central de ajuda. Entre 8 de agosto e 8 de setembro de 2026, ela respondeu a cerca de 2.100 chats ao vivo e repassou cerca de 1.260 para a equipe, com todo chat terminando em uma resposta ou em um repasse limpo. A equipe também pediu uma tag ai_handled em todo ticket que a eesel toca, para que a contenção seja contada no Zendesk em vez de estimada. Usar a IA nativa ou uma camada por cima é uma escolha real, e o guia IA nativa vs camada de IA a explica.

Caminhos 2 e 3: adicione um widget de chat com IA independente com uma tag de script

Se você não tem chat hoje, ou o chat do seu helpdesk não está no seu site, vai adicionar um widget independente. Todos funcionam da mesma forma por baixo: um script curto carrega o código do fornecedor, que desenha o balão e conversa com os servidores dele.

Este é o da eesel, da documentação do chat bubble:

<script>
(function(){
  var script = document.createElement('script');
  script.src = 'https://cdn.eesel.ai/loader.js';
  script.async = true;
  script.onload = function() {
    if (window.EeselWidgetWithTrigger) {
      window.EeselWidgetWithTrigger({ triggerId: 'YOUR_TRIGGER_ID' });
    } else {
      window.__EESEL_WIDGET_V2_CONFIG__ = { EESEL_TRIGGER_ID: 'YOUR_TRIGGER_ID' };
    }
  };
  document.head.appendChild(script);
})();
</script>

O loader é assíncrono, então não atrasa a página, e as configurações que você salva chegam ao balão no ar em cerca de 30 segundos, de modo que você só cola uma vez. A Tidio funciona com a mesma ideia: uma linha de JavaScript, ou um plugin de WordPress, ou um app da Shopify, e a documentação dela diz para usar apenas um método de instalação, não os dois. A Voiceflow pede que você publique primeiro uma versão do seu agente e depois copie o snippet na aba Widget.

Onde você cola, e se o seu plano permite, varia conforme a plataforma. Veja onde ele vai em cada plataforma, segundo a documentação de cada uma:

O caso da Shopify merece uma segunda olhada. A própria documentação para desenvolvedores da Shopify diz que os blocos de app embed ficam desativados depois que um app é instalado, até o lojista ativá-los no editor de temas. Esse único padrão é o motivo mais comum de alguém dizer a um fornecedor "instalei e não aparece nada". O levantamento de apps de chatbot para Shopify mostra quais cuidam disso por você.

Quando o script carrega, mas o chat não funciona

Se o seu site envia um cabeçalho Content Security Policy, um widget colado pode falhar de um jeito que parece um produto quebrado. A MDN divide isso em três regras de CSP: script-src decide se o script carrega, connect-src decide se ele consegue alcançar os servidores do fornecedor e frame-src decide se a janela de chat em iframe pode abrir. Se faltar só o connect-src, você tem um balão que abre e nunca responde. Para a eesel, a documentação diz para permitir https://cdn.eesel.ai para scripts e conexões.

Caminhos 4 e 5: quando você não tem helpdesk ou não pode mexer no código

Duas situações travam muitas equipes: não há helpdesk para onde repassar, ou o site pertence a outra pessoa e as mudanças levam um mês.

Para a primeira, escolha um widget cuja saída não dependa de um helpdesk. O bubble da eesel pode repassar por e-mail, ou criando um ticket em um helpdesk, se você tiver um, e você define a regra em linguagem simples ("sempre escale para uma pessoa se alguém mencionar um reembolso"). Ao repassar, ele pede o nome e o e-mail do visitante, cria o ticket com um resumo do chat como primeira mensagem e o etiqueta.

Para a segunda, ignore o site no início. Um link público de chat é uma página de chat hospedada pelo fornecedor que você linka no menu, no rodapé ou na central de ajuda. O da eesel não tem login, então qualquer pessoa com o link pode conversar; isso serve para conteúdo público de suporte e é inadequado para qualquer coisa específica de conta. Um embed inline é o meio-termo: um iframe (420 por 600 pixels por padrão) colado em uma única página, como a sua página de contato. A documentação da eesel observa que alguns editores de página removem iframes ao salvar, então cole-o no template da página.

Caminho 6: a rota do desenvolvedor, CLI e API

Se o seu site é um app próprio, ou você prefere que a configuração viva no código, carregue o script uma vez no layout raiz do app, em vez de em toda página. A documentação da eesel mostra como fazer isso no Next.js com next/script em app/layout.tsx e, para WordPress hospedado por você, a função do WordPress wp_enqueue_script com in_footer e defer evita que o widget bloqueie a página.

A mudança mais interessante é que a própria configuração não precisa mais de um painel. A CLI da eesel (@eesel/cli, Node 18.17 ou superior) é o mesmo agente que você configuraria no painel, conduzido a partir de um terminal. Uma pessoa pode rodá-la, um script pode automatizá-la, e um agente de código como Claude Code, Cursor ou Codex pode executar toda a configuração, porque cada comando imprime JSON:

npx @eesel/cli init chat-bubble --site https://your-site.com   # no account needed
eesel login                                                     # keep the workspace
eesel files upload ./refund-policy.pdf
eesel chat "what's our refund policy?"
eesel chat "run a simulation on our last 100 tickets and tell me what you would have got wrong"

init chat-bubble escolhe ou cria um agente, adiciona o canal de chat bubble e imprime o snippet de incorporação mais um link de teste hospedado; um workspace anônimo recebe US$ 5 de uso por 7 dias. Os comandos podem ser executados de novo com segurança, as gravações aceitam --dry-run e os comandos de configuração são gratuitos (só o chat é cobrado). Dois limites honestos: a estilização do bubble e a escrita das regras de repasse ainda não têm comando, então isso é feito no chat do painel. O workspace também é um servidor MCP, então eesel mcp token imprime uma linha claude mcp add pronta. Se você quer a IA sem nenhum widget, o guia de suporte headless cobre esse padrão, e o post sobre CLI de agentes de IA compara CLIs entre fornecedores.

Passo a passo: adicione um agente de IA ao seu site

Qualquer que seja o caminho escolhido, a sequência é a mesma. Esta é a ordem que eu seguiria, com a instalação deliberadamente perto do fim.

Passo 1: conecte o conhecimento

Aponte o agente para a sua central de ajuda, para as páginas públicas que respondem a perguntas de clientes e para quaisquer PDFs ou documentos com políticas. Os limites variam: a Freshworks permite 10 URLs por agente e até 3.000 páginas por site, a HubSpot pode rastrear até 5.000 URLs em um domínio, e a varredura de páginas prioritárias da Tidio para em 100 páginas. A HubSpot também avisa que fontes privadas não serão citadas, mas o conteúdo delas ainda pode aparecer nas respostas, então pense bem antes de enviar documentos internos. O guia de treinamento de um agente de suporte com IA aprofunda o assunto.

Passo 2: conecte os sistemas que ele deve consultar

O conhecimento explica a sua política de devolução. Só uma integração consegue dizer ao cliente onde está o pedido dele. Se você vende online, conecte a sua loja para que o agente leia pedidos, estoque e preços ao vivo; se você é SaaS, pense no status da conta. Comece só com leitura. A própria documentação da eesel recomenda manter reembolsos, cancelamentos e qualquer coisa que custe dinheiro atrás de uma aprovação no início. A automação de WISMO é o primeiro caso de uso clássico.

Passo 3: escreva as regras e o repasse

Escreva como instruções a lista de "nunca prometer" que vimos antes e depois defina as saídas: quem recebe o repasse, por qual canal e o que o agente diz enquanto isso acontece.

Todo fornecedor aqui faz o repasse diante de um pedido direto por uma pessoa. As diferenças estão nos padrões. A Gorgias tem sinais de repasse embutidos que não podem ser desligados, incluindo raiva e ameaças legais. A Tidio não desconta da sua cota do Lyro se o Lyro repassa imediatamente. A Freshworks interrompe o agente e passa os chats para atendentes ao vivo quando as sessões acabam. O que você deve verificar no seu é a mensagem que o visitante vê enquanto espera, porque "Alguém entrará em contato" sem coletar o e-mail é um beco sem saída.

"Se o único "atendimento ao cliente" que uma empresa oferece é conversar com um chatbot, eu encaro isso como exatamente a mesma coisa que não ter atendimento nenhum, mesmo que dê para convencer o chatbot a me deixar falar com um humano."

JohnFen, Hacker News

Passo 4: teste com perguntas reais antes que alguém o veja

Rode as suas 20 a 30 perguntas de antes, mais as incômodas: a mensagem irritada, as duas perguntas em uma, a pergunta sobre um produto que você descontinuou. O Evaluate agent da Freshworks executa até 50 consultas por lote e pode importar conversas passadas já resolvidas. A simulação da eesel executa o agente contra tickets reais do passado, dá nota a cada resposta e sugere mudanças nas instruções. De qualquer forma, leia você mesmo as respostas erradas. O guia de teste de um agente de IA traz um plano de testes mais completo.

A falha que você procura é a errada com confiança:

"O problema da 'alucinação' é bem evidente: o bot VAI gerar uma resposta totalmente errada com a maior eloquência e confiança do mundo, o que pode (com razão) assustar algumas pessoas."

Rik H., Capterra

Passo 5: instale o widget

Agora cole o snippet, usando o caminho do widget acima. Verifique no celular, verifique se ele não fica por cima do seu banner de cookies ou de uma barra fixa de adicionar ao carrinho (o bubble da eesel tem um deslocamento inferior justamente para isso) e verifique em uma conexão lenta. Um widget lento custa tanta confiança quanto uma resposta errada, como mostrou aquele teste de 67 avaliações.

Passo 6: amplie aos poucos

Não ative em todo o site no primeiro dia. Amplie por etapas e só suba um degrau quando as respostas do atual se sustentarem.

As ferramentas oferecem apoio de maneiras diferentes. A porcentagem de cobertura e o horário de funcionamento da HubSpot, a opção da Tidio de responder só quando os atendentes estão offline e o snippet por página da eesel (cole só nas páginas que você quiser) permitem começar pequeno. Um piloto de suporte de algumas semanas é uma boa primeira etapa.

Passo 7: meça o que importa

Acompanhe três números: com que frequência a IA respondeu sem repasse, com que frequência um repasse era de fato necessário e aconteceu, e que nota os clientes deram aos chats. Cuidado com o primeiro. Um cliente que fecha o chat frustrado não é uma resolução, e é por isso que a Zendesk agora só cobra resoluções verificadas e que a SE Ranking marca todo chat como útil ou não útil. Os guias do scorecard de piloto e de métricas de suporte com IA explicam como definir isso no seu helpdesk.

Erros comuns ao adicionar um agente de IA a um site

A maioria destes eu já vi mais de uma vez, e nenhum tem a ver com o modelo de IA.

• Entregar um bot que só coleta e-mails. Se a primeira coisa que o widget faz é pedir dados de contato e prometer uma resposta, é um formulário de contato com cara. Responda primeiro e colete os dados só no repasse.
• Deixar que ele leia tudo. Posts antigos de blog, produtos descontinuados e comunicados de imprensa acabam nas respostas. Exclua-os antes do lançamento.
• Nenhuma saída. A discussão do Hacker News acima não é um caso isolado; um operador de varejo com milhões de clientes escreveu que "tinha gente cancelando contas literalmente porque os atendentes de suporte não eram humanos" e arrancou o chatbot do site. Uma opção visível e funcional de "falar com uma pessoa" é o que impede um agente de IA de virar essa história.
• Dois balões na mesma página. Adicionar um widget de IA ao lado do chat do seu helpdesk existente confunde todo mundo. Ou coloque a IA no widget existente (Caminho 1) ou o substitua.
• Dar poderes antes de ele os merecer. Um comentarista do Hacker News descreveu bem o medo: "e se ele alucinasse e desse ao cliente atendimento gratuito para sempre?" A resposta são ações delimitadas atrás de aprovações, não nenhuma ação.
• Esquecer os detalhes da instalação. App embeds da Shopify deixados desativados, um site Webflow não republicado, uma troca de domínio no Wix que apagou o snippet, uma regra de CSP bloqueando o fornecedor. Nenhum desses mostra erro ao cliente; o balão simplesmente não está lá.

Para uma lista mais longa, veja os posts sobre problemas de chatbots de IA e alucinações de IA.

Quanto custa manter um agente de IA no seu site

A instalação é gratuita quase em todo lugar. O que você paga é o trabalho da IA, e cada fornecedor conta esse trabalho de um jeito. A unidade importa mais do que o preço de vitrine, porque um fornecedor que cobra por sessão cobra por chats que não deram em nada, e um que cobra por resolução não.

Lembre-se do custo de licenças que existe por baixo. Os agentes de IA da Zendesk ficam nos planos Suite a partir de US$ 55 por agente ao mês com cobrança anual, o Customer Agent da HubSpot exige o Service Hub Professional (a partir de US$ 90 por licença ao mês mais uma taxa de onboarding de US$ 1.500) e o agente de IA de chat da Freshworks exige um plano Freshdesk Omni. Para uma comparação mais profunda, o guia de custo de chatbot e os posts sobre preço do Lyro e preço da Voiceflow detalham cada um.

Como a eesel entra no seu site

A eesel é um colega de IA que você contrata para o suporte e, em um site, aparece como um chat bubble, um chat inline em uma página ou um link de chat hospedado, todos rodando o mesmo agente com o mesmo conhecimento. Ela responde a partir da sua central de ajuda, do seu site, do Google Drive, do Notion, do Confluence, da Shopify e de tickets antigos, e funciona com qualquer helpdesk ou com nenhum.

Veja como isso fica em sites reais:

• A SamCart usa um agente nos tickets de e-mail do Freshdesk e outro no chat bubble do site, cada um com a própria saudação e tom, ambos respondendo a partir de cerca de 280 artigos da central de ajuda. O chat pede nome e e-mail antes de responder, para que a equipe possa dar seguimento.
• A BEAUTEK usa um KI-Chat em alemão em beautek.de que responde a perguntas sobre produtos e pedidos, diz com clareza que é uma resposta de IA e informa o telefone da equipe para qualquer assunto importante. Em um mês, respondeu a 77 chats do site e criou 20 tickets no Zendesk, a maioria deles leads de vendas.
• A ClutchLoop deu ao seu agente o nome de Loopy. Ele responde sobre status de pedidos, devoluções e produtos em clutchloop.com, consulta preços e estoque ao vivo na Shopify e cria um ticket na Gorgias quando um chat precisa de uma pessoa.

Quanto ao preço, a eesel tem um preço mensal fixo: um chat é um crédito, não importa quantas mensagens sejam trocadas, os planos começam em US$ 299 por 500 créditos e não há taxa por licença nem taxa de plataforma. O teste gratuito é de 100 créditos por 7 dias, sem cartão.

Onde ela não é a escolha certa: se você está satisfeito com a IA do próprio Zendesk ou do Freshdesk e só precisa do básico, o agente nativo mantém tudo em uma única fatura. Um repasse do bubble da eesel para um segundo widget de chat ao vivo só funciona com o Zendesk Messenger ou o Freshchat. A auditoria SOC 2 Type II dela está em andamento, com o período de observação iniciado em 1º de outubro de 2026; ela usa processadores certificados SOC 2 Type II e não treina modelos com os seus dados.

Adicione um agente de IA ao seu site com a eesel

Se você quer um agente no seu site que responda a partir do que você já escreveu e entregue o resto à sua equipe com um resumo do chat, o chat bubble da eesel é uma tag de script, e você pode testá-lo por um link de pré-visualização antes que um único cliente o veja. Conecte a sua central de ajuda, reproduza as perguntas do mês passado na simulação e só então cole o snippet. Se a sua equipe já vive no Zendesk ou no Freshdesk, ela pode ficar dentro desse chat, como a SE Ranking a usa.

Experimente a eesel grátis por 7 dias, ou agende uma demo para ver a configuração rodando no seu próprio site.