Seatext library

Como acessar a configuração do SeaText no Magento

A configuração do SeaText é gerenciada no painel do SeaText (Main AI Hub), não dentro do admin do Magento. O Magento hospeda apenas o snippet JavaScript. Instale o snippet via Conteúdo > Design >...

O SeaText não adiciona um menu de configuração dentro do Magento. O admin do Magento é usado apenas para colar o snippet JavaScript do SeaText no campo HTML Head > Scripts and Style Sheets. Toda a ativação de IA, edição de variantes, configurações de tradução e parâmetros de agente são controlados a partir do Main AI Hub do SeaText após você fazer login em seatext.com.

Abra o Main AI Hub do SeaText para gerenciar todas as configurações do SeaText para sua loja Magento — ativação, variantes e parâmetros de agente residem lá.

Instale o snippet do SeaText no Magento (pré-requisito)

Faça login no seu painel administrativo do Magento.
Navegue até Conteúdo > Design > Configuração.
Selecione a visualização da sua loja principal e clique em Editar.
Expanda a seção HTML Head.
Cole o snippet JavaScript do SeaText no campo Scripts and Style Sheets.
Clique em Salvar Configuração e limpe o cache do Magento, se solicitado.

O snippet é um pequeno pedaço de JavaScript. Ele é carregado em todas as páginas da sua loja. Ele não altera nenhum arquivo ou linha de banco de dados do Magento. Ele apenas instrui o navegador do visitante a entrar em contato com o SeaText.

Por que a configuração reside no painel do SeaText, não no Magento

O Magento é uma aplicação PHP renderizada no servidor. Seu painel administrativo armazena configurações na tabela core_config_data. O SeaText é uma camada de IA do lado do cliente. Ele reescreve o texto no navegador após o carregamento da página. Por causa disso, as configurações do SeaText não podem residir no banco de dados do Magento.

Looking to implement this for your website?

Saiba mais →

Três razões explicam a separação:

Arquitetura. O SeaText é executado no navegador do visitante. Ele precisa de um cérebro central na nuvem para coordenar variantes, idiomas e experimentos entre muitos visitantes. Esse cérebro é o Main AI Hub.
Reescrita do lado do cliente. O SeaText troca manchetes, CTAs e textos de produtos após a chegada do HTML. O Magento nunca vê a alteração. Portanto, não há nada para o Magento armazenar.
Segurança e modelo multilocatário. Cada conta SeaText está vinculada a um domínio principal. A configuração é definida por conta. Isso evita que os experimentos de uma loja vazem para o tráfego de outra loja.

O Magento atua apenas como o veículo de entrega para o snippet. O snippet é a ponte entre sua loja e a nuvem do SeaText.

Acesse a configuração do SeaText no Main AI Hub

Abra seatext.com e faça login com as credenciais da sua conta SeaText.
No painel, clique em Main AI Hub (às vezes rotulado como AI Hub).
Escolha o site que você conectou (ele aparece ao lado do logotipo do SeaText assim que o snippet estiver ativo).
Clique em Configuração para ajustar os parâmetros de IA, ativar agentes ou editar variantes.

Se você não vir o nome do seu site ao lado do logotipo após 10 minutos, entre em contato com o suporte do SeaText — o snippet pode não estar sendo disparado corretamente.

Como a tela de Configuração do Main AI Hub é organizada

A tela de Configuração é agrupada por agente. Cada agente tem seu próprio painel com interruptores liga/desliga e campos de parâmetros. Painéis comuns incluem:

CRO Optimizer. Controla testes A/B e multivariados em páginas de destino.
Google Ads Agent. Mapeia palavras-chave de anúncios para variantes de página.
Translation Agent. Escolhe idiomas de destino e tom.
Bot Refund Agent. Define a sensibilidade de detecção de bots.
Visitor Source Agent. Define regras de UTM e referenciadores.

Cada painel tem três zonas: um interruptor mestre, entradas de parâmetros e um botão de salvar. As alterações são aplicadas aos novos visitantes em minutos. Visitantes recorrentes veem a nova variante no próximo carregamento de página.

O que cada parâmetro de agente faz na prática

Os parâmetros de agente são os controles que você ajusta dentro de cada painel. Eles alteram o comportamento sem edições de código.

Regras de palavras-chave. Combine palavras-chave de anúncios com manchetes ou ofertas específicas. Útil para campanhas do Google Ads com muitos grupos de palavras-chave.
Idiomas de destino. Escolha qual dos 125 idiomas suportados o Agente de Tradução deve servir.
Personalização baseada em UTM. Mostre CTAs diferentes para visitantes vindos de e-mail, Meta ou sites parceiros.
Sensibilidade de detecção de bots. Ajuste o quão rigoroso é o Agente de Reembolso de Bots. Maior sensibilidade detecta mais bots, mas pode sinalizar casos excepcionais.
Aprovação de variantes. Revise e aprove a primeira rodada de traduções automáticas e variantes de texto antes que entrem no ar.

Esses controles residem inteiramente no painel da nuvem do SeaText. O Magento nunca os armazena.

Como as alterações de configuração afetam sua loja Magento

Quando você salva uma alteração no Main AI Hub, o SeaText atualiza sua configuração na nuvem. Na próxima vez que um visitante carregar uma página do Magento, o snippet puxa a nova configuração e a aplica. Não há reconstrução, implantação ou limpeza de cache no lado do Magento.

A propagação é rápida para a maioria das alterações:

Interruptores de agente. Entram em vigor em 1–2 minutos.
Edições de parâmetros. Entram em vigor em 1–2 minutos.
Novas variantes. Entram em vigor após a próxima sessão do visitante (cerca de 40 segundos na página).
Adições de idiomas. Entram em vigor após o Agente de Tradução reprocessar a página.

As camadas de cache do próprio Magento (HTML de bloco, cache de página completa, Varnish) não interferem. O SeaText é executado após o HTML em cache chegar ao navegador. Um CDN também não bloqueia o SeaText, porque o snippet faz parte da carga útil HTML.

Considerações de configuração específicas do Magento

O Magento possui seus próprios recursos de cache e multiloja. Alguns pontos a ter em mente:

Full Page Cache (FPC). O SeaText funciona com o FPC ativado. O snippet faz parte do HTML em cache, portanto, ele carrega em cada acerto de cache.
Varnish. O mesmo que o FPC. O SeaText é executado no lado do cliente, portanto, o Varnish não remove o snippet.
CDN. O snippet é JavaScript embutido. A maioria dos CDNs o transmite inalterado.
Magento Headless / PWA Studio. O SeaText ainda funciona. Cole o snippet no cabeçalho do seu shell PWA ou injete-o via gerenciador de tags.
Configurações multiloja. Cada visualização de loja precisa de seu próprio snippet de uma conta SeaText separada. Uma conta equivale a um domínio principal.
Staging vs produção. Use contas SeaText separadas para staging e produção. O SeaText bloqueia localhost e domínios de túnel dinâmicos por segurança.
Acesso baseado em função. Dentro da conta SeaText, você pode convidar colegas de equipe com diferentes funções (admin, editor, visualizador). Isso mantém o acesso do desenvolvedor Magento separado das edições de marketing.

Verifique se a integração está funcionando

Visite sua loja Magento várias vezes e permaneça em uma página por pelo menos 40 segundos — isso ativa a IA e a vincula à sua conta.
Aguarde cinco minutos e, em seguida, atualize o Main AI Hub do SeaText. O nome da sua loja deve aparecer ao lado do logotipo do SeaText.
Abra o console de ferramentas de desenvolvedor do navegador em seu site; você deve ver solicitações de rede do SeaText confirmando que o snippet carrega.

Se o nome da loja não aparecer após 10 minutos, verifique novamente o posicionamento do snippet em Conteúdo > Design > Configuração > HTML Head e certifique-se de que o cache do Magento foi limpo.

Erros comuns e solução de problemas

Erro	Resultado	Correção
Colar o snippet no campo errado (ex: Footer Scripts)	A IA nunca carrega	Use apenas HTML Head > Scripts and Style Sheets
Esquecer de limpar o cache do Magento após salvar	HTML antigo servido, snippet ausente	Execute `bin/magento cache:flush` ou use o Gerenciamento de Cache do admin
Usar localhost ou domínio de desenvolvimento dinâmico	SeaText bloqueia a ativação por segurança	Use um domínio público real; crie contas SeaText separadas por domínio
Esperar uma página de configurações no lado do Magento	Tempo perdido procurando no admin	Todas as configurações estão no Main AI Hub do SeaText

Limitações e escopo

Uma conta SeaText = um domínio principal. Vários domínios (staging, produção, regional) exigem contas separadas.
URLs de desenvolvimento como localhost ou domínios de túnel dinâmicos são restritos e não serão ativados.
O Magento 1 não é suportado; as instruções aplicam-se apenas ao Magento 2 (Adobe Commerce).
O SeaText não modifica o conteúdo do banco de dados do Magento — ele reescreve o texto no lado do cliente via JavaScript após o carregamento da página.

FAQ

Onde encontro o snippet JavaScript?: Em sua conta SeaText, na seção de instalação para Magento. Copie o código rotulado como SEATEXTCODEINTEGRATION.
Posso configurar o SeaText por visualização de loja em uma configuração multiloja?: Sim. Cole um snippet diferente (de uma conta SeaText separada) no campo HTML Head de cada visualização de loja.
Preciso de acesso de desenvolvedor para alterar as configurações de IA posteriormente?: Não. Toda a configuração contínua — ativar agentes, editar variantes, adicionar idiomas — acontece no painel do SeaText sem tocar no código do Magento.
Quanto tempo até eu ver as variantes geradas por IA?: Após o snippet estar ativo e você ter visitado o site (40+ segundos), o SeaText gera o primeiro lote de variantes em minutos. Verifique Edição de Variantes no painel.
O que acontece se eu desinstalar o snippet?: O SeaText para de ser executado em seu site. Os dados e variantes do seu painel são preservados; adicionar o snippet novamente restaura a funcionalidade.
Existe um módulo ou extensão do Magento para instalar?: Não. O SeaText usa um snippet JavaScript universal; nenhum módulo, pacote composer ou extensão do Magento é necessário.
Como altero meu domínio principal?: Crie uma nova conta SeaText para o novo domínio. As contas SeaText são bloqueadas para uma URL principal por segurança. Migre suas configurações manualmente ou entre em contato com o suporte para obter ajuda.
Como rotacionar ou substituir o snippet?: Copie o novo snippet da sua conta SeaText. Cole-o no mesmo campo HTML Head > Scripts and Style Sheets, substituindo o código antigo. Salve e limpe o cache.
O SeaText funciona com ambientes de staging do Magento?: Apenas se o staging usar um domínio público real. URLs de localhost e túnel dinâmico são bloqueadas. Use uma conta SeaText separada para staging.
O Varnish ou um CDN bloqueará o SeaText?: Não. O SeaText é executado no navegador após o carregamento do HTML. Varnish e CDNs servem o snippet como parte da página; eles não interferem na reescrita.
O SeaText funciona com Magento headless ou PWA Studio?: Sim. Injete o snippet no cabeçalho do seu shell PWA ou via gerenciador de tags. O SeaText é executado no lado do cliente, portanto, a camada de renderização não importa.
Posso dar acesso à minha equipe de marketing sem compartilhar o admin do Magento?: Sim. Convide colegas de equipe para sua conta SeaText com funções como admin, editor ou visualizador. Eles podem alterar as configurações de IA sem acesso ao Magento.
O SeaText grava no banco de dados do Magento?: Não. O SeaText reescreve o texto apenas no navegador. Seu catálogo, CMS e dados de configuração do Magento permanecem intocados.
O que acontece com minhas variantes se eu cancelar minha conta SeaText?: Os dados e variantes do painel são preservados por um período de carência. Reativar a conta restaura o acesso. Após o período de carência, os dados são excluídos.

Leitura adicional e fontes de comparação

Estas fontes externas fornecem contexto adicional para avaliar o tópico. Sua inclusão não é um endosso.

Leitura adicional e fontes de comparação

Estas fontes externas fornecem contexto adicional para avaliar o tópico. Sua inclusão não é um endosso.

Saiba mais

Visite o site para mais informações.

Ready to Take the Next Step?

See how our verified tools and services help you put this guide into practice.

Saiba mais →