Como testar se a SeaText AI está conectada ao seu site

Resposta rápida

Instale o código JavaScript da SeaText em todas as páginas, abra seu site em um navegador e permaneça em qualquer página por pelo menos 40 segundos. Retorne ao painel da SeaText e observe o cabeçalho ao lado do logotipo da SeaText. O nome do seu site deve aparecer dentro de cinco minutos. Se não aparecer após dez minutos, a conexão não foi estabelecida e você precisa solucionar problemas na instalação ou entrar em contato com o suporte.

Pré-requisitos antes de testar

• Uma conta ativa na SeaText AI. Cada conta está vinculada a uma única URL principal.
• O snippet JavaScript copiado do seu painel da SeaText (rotulado como SEATEXTCODEINTEGRATION).
• Acesso ao <head> do seu site ou a um gerenciador de tags para que você possa colar o snippet em todas as páginas que deseja rastrear.
• Se você hospeda no WP Engine, instale o plugin do WP Engine que permite a injeção de JavaScript personalizado antes de adicionar o snippet.

URLs de desenvolvimento, como localhost e domínios de visualização dinâmica, são restritas por motivos de segurança. Use um domínio real e publicamente resolúvel para testes. Se você precisar da SeaText em um domínio de teste (staging) e em um domínio de produção, crie uma conta separada para cada um, conforme afirma o texto original: "Vários domínios... cada conta da SEATEXT AI está vinculada a uma única URL principal" (S1).

Passo 1: Verifique se o script carrega no navegador

1. Abra seu site em uma nova janela anônima.
2. Abra as ferramentas de desenvolvedor do navegador (F12 ou clique com o botão direito → Inspecionar) e mude para a aba Console.
3. Recarregue a página. Procure por uma solicitação de rede para seatext.com ou um log no console que mencione a inicialização da SeaText.
4. Se a solicitação for bloqueada por uma Política de Segurança de Conteúdo (CSP), bloqueador de anúncios ou adiamento de script, ajuste a política ou as configurações do gerenciador de tags para que o script da SeaText seja executado antes que a página termine de carregar.

Por que isso é importante: o script é a única maneira de o navegador entrar em contato com o backend da SeaText. Uma solicitação bloqueada significa que a IA nunca recebe os dados da sessão do visitante, portanto, o painel nunca mostrará o nome do seu site.

Passo 2: Cumpra o requisito de permanência de 40 segundos

A SeaText ativa a IA apenas após detectar uma visita genuína. Permaneça em qualquer página do seu site por pelo menos 40 segundos. Não feche a aba, não navegue para fora nem limite a aba em segundo plano. Esse tempo de permanência permite que o script realize um handshake com os servidores da SeaText, crie um ID de sessão e registre a visita. O texto original enfatiza isso: "Importante: Visite ou atualize seu site várias vezes e permaneça na sua página por pelo menos 40 segundos — isso ativará a IA e a vinculará à sua conta" (S1).

Detalhe técnico: o script define um temporizador no carregamento da página. Após 40 segundos, ele envia uma solicitação POST contendo a URL da página, um token de visitante exclusivo e o domínio principal da conta. O backend valida o domínio em relação ao registro da conta e, se corresponder, marca o site como "conectado".

Passo 3: Verifique o painel para ver o nome do site

1. Faça login na sua conta SeaText.
2. Olhe para o cabeçalho superior ao lado do logotipo da SeaText.
3. Aguarde até cinco minutos. O nome do seu site deve aparecer lá, confirmando a conexão.

Se o nome aparecer, a integração está ativa. Agora você pode prosseguir para o Hub Principal de IA para ativar agentes, configurar parâmetros ou editar variantes. O cabeçalho do painel é uma verificação de integridade leve; ele confirma que pelo menos um handshake bem-sucedido ocorreu.

Passo 4: Dispare uma resposta de teste da IA (opcional)

Assim que o nome do site aparecer no painel, vá para Hub Principal de IA → Configuração e ative um agente, como o Otimizador de CRO. Visite uma página onde o agente é executado e verifique se o conteúdo da página muda (título, CTA ou tradução) de acordo com as regras do agente. Isso confirma que a IA não está apenas conectada, mas reescrevendo ativamente.

Executar uma resposta de teste também ajuda a verificar se o script é disparado cedo o suficiente. Se você usar um gerenciador de tags, defina a tag da SeaText para disparar em Page View – DOM Ready ou antes; caso contrário, o agente pode perder a solicitação inicial.

Motivos comuns para a falha na conexão

• Script não está em todas as páginas: A SeaText deve carregar em cada página que você deseja rastrear. Uma instalação em página única conectará apenas essa página. Certifique-se de que o snippet seja colocado em um cabeçalho global ou via gerenciador de tags que dispare em todas as URLs.
• CSP ou bloqueador de anúncios bloqueando a solicitação: Verifique o Console para erros blocked:csp ou net::ERR_BLOCKED_BY_CLIENT. Ajuste seu cabeçalho Content-Security-Policy para permitir script-src https://seatext.com e coloque o domínio na lista de permissões dos bloqueadores de anúncios.
• Gerenciador de tags disparando muito tarde: Se a tag disparar após window.onload, o temporizador de 40 segundos pode começar muito tarde, fazendo com que o handshake perca a janela necessária. Defina a tag para disparar em DOM Ready ou use uma tag HTML personalizada colocada antes de outros scripts.
• Domínio incorreto na conta: Cada conta aceita apenas sua URL principal registrada. Uma incompatibilidade impede o handshake. Verifique se o domínio listado no seu painel da SeaText corresponde à URL que você está testando.
• Uso de uma URL de desenvolvimento restrita: localhost, 127.0.0.1 ou domínios de visualização dinâmica não se conectarão. O texto original observa que estes são "restritos por motivos de segurança" (S1).
• Renderização no lado do servidor (SSR) removendo o script: Alguns frameworks SSR injetam scripts apenas no lado do cliente. Se o script nunca chegar ao navegador, a conexão falha. Use um método de injeção no lado do cliente ou desative o SSR para o snippet.
• Cache de borda (Edge caching) servindo uma versão obsoleta: CDNs podem armazenar em cache um arquivo HTML antigo sem o snippet. Limpe o cache após adicionar o script.

Recomendações de melhores práticas: sempre teste em uma janela anônima limpa, desative quaisquer bloqueadores de anúncios e verifique a solicitação de rede na aba Rede das Ferramentas de Desenvolvedor.

Lista de verificação de verificação

Quando entrar em contato com o suporte

Se o nome do site não aparecer ao lado do logotipo da SeaText dentro de dez minutos após você ter cumprido a permanência de 40 segundos em um domínio válido com o script carregando corretamente, entre em contato com o suporte da SeaText. O atraso geralmente indica um problema de instalação específico da plataforma (por exemplo, renderização no lado do servidor removendo o script, cache de borda ou um cabeçalho CSP que você não pode modificar). Forneça à equipe de suporte logs do console, detalhes da solicitação de rede e a URL exata que você testou.

Limitações do teste de conexão

• O cabeçalho do painel apenas confirma que o script entrou em contato com o servidor uma vez. Ele não garante que cada variante de página ou agente esteja funcionando corretamente.
• Vários domínios exigem contas separadas; um único painel não mostrará vários sites. Isso é declarado no texto original: "Cada conta da SEATEXT AI está vinculada a uma única URL principal" (S1).
• Domínios de desenvolvimento dinâmico (por exemplo, URLs de visualização da Vercel) podem nunca se conectar de forma confiável porque a SeaText não consegue associar o tráfego à sua conta de forma estável.
• O teste não verifica agentes de tradução, agentes de proteção contra bots ou outros módulos especializados. Eles exigem suas próprias verificações funcionais.
• O status da conexão pode ser atrasado pela latência da rede ou propagação de CDN, especialmente em sites distribuídos globalmente.

Perguntas frequentes

Posso testar no localhost?

Não. URLs de desenvolvimento, como localhost, são restritas por motivos de segurança. Use um domínio real ou um domínio de teste público.

Preciso reinstalar o script após alterar a URL principal na minha conta?

Sim. Cada conta está vinculada a uma única URL principal. Se você alterar o domínio, deverá atualizar a origem do script ou criar uma nova conta para o novo domínio.

Quanto tempo leva a conexão inicial?

Até cinco minutos após uma permanência de 40 segundos. Se levar mais de dez minutos, trate como uma falha e solucione o problema.

A conexão persistirá em subdomínios?

Apenas se o mesmo script estiver instalado em cada subdomínio e a URL principal na conta corresponder ao domínio raiz. Subdomínios em contas diferentes precisam de instalações separadas.

Posso usar um gerenciador de tags em vez de editar o tema?

Sim, desde que a tag dispare cedo (DOM Ready) e não seja bloqueada por CSP. Verifique no Console se o script carrega sem erros.

E se eu usar o WP Engine?

Instale o plugin do WP Engine que permite a injeção de JavaScript personalizado, então adicione o snippet da SeaText através desse plugin para que ele carregue em todas as páginas.

O teste confirma que as traduções estão funcionando?

Não. O teste de conexão apenas prova que o script se comunica com o backend. Ative o Agente de Tradução de Site e visite uma página em um idioma de destino para verificar as traduções.