Como verificar se o SeaText está sendo executado corretamente no Odoo

Para verificar se o SeaText está sendo executado corretamente no Odoo, comece pelo menu SeaText. Procure por uma marca de verificação verde ou um indicador de status que diga que a conexão está ativa. Se você vir, a integração está ativa. Se não vir, a próxima verificação é o próprio código: abra a página do Odoo, encontre o bloco Código de incorporação e confirme se o trecho de JavaScript SEATEXT AI ainda está lá e salvo.

Este guia fornece uma lista de verificação curta e, em seguida, um conjunto mais profundo de verificações para qualquer pessoa que queira confirmar a integração no nível do código.

Antes de verificar: o que você precisa

Antes de testar qualquer coisa, certifique-se de que estas três coisas sejam verdadeiras. Se uma estiver faltando, o status parecerá errado mesmo quando a configuração estiver próxima.

• Uma conta SEATEXT AI. Você precisa de uma conta antes que o script possa ser executado. Se você não tiver uma, crie-a primeiro.
• Um domínio válido e real. URLs de desenvolvimento, como localhost, são restritas por segurança, então não teste em localhost.
• A página deve estar no módulo Site do Odoo. A integração usa o bloco Código de incorporação em Conteúdo dinâmico.

Verificação passo a passo

Use estas etapas em ordem. Cada uma se baseia na anterior.

1. Procure no menu SeaText o indicador de status. Uma marca de verificação verde ou um rótulo “ativo” significa que a conexão está saudável. Se você não vir, vá para a próxima etapa.
2. Faça login no Odoo e abra o módulo Site. O módulo contém suas páginas editáveis.
3. Navegue até a página que deve ter o SeaText. Escolha a página onde você instalou o trecho. Se você o instalou em várias páginas, verifique cada uma.
4. Clique no botão “Editar” para abrir o painel de edição.
5. Role pelo painel de Blocos até chegar em “Conteúdo dinâmico”. O módulo Código de incorporação fica lá.
6. Clique no bloco Código de incorporação. Na área de entrada, procure o código fornecido pela SEATEXT AI. Deve ser o trecho de JavaScript que você copiou da sua conta SEATEXT AI.
7. Se o código estiver ausente, cole-o novamente. Em seguida, clique em “Salvar”.
8. Verifique as configurações de Visibilidade do bloco. A configuração oficial usa a opção “Ocultar no desktop” para que o bloco não apareça como uma caixa vazia. Selecione-a se não estiver selecionada.
9. Clique em “Salvar” novamente. Este salvamento final aplica a alteração de visibilidade.

Essa é a verificação principal. Se você fez tudo isso e ainda duvida que funcione, vá para a verificação no navegador abaixo.

Como verificar no seu navegador

Às vezes, a interface do Odoo parece correta, mas o script ainda não está carregando. Um teste rápido no navegador fornece prova.

1. Abra a página ao vivo em uma janela normal do navegador, não no editor do Odoo.
2. Clique com o botão direito na página e escolha “Ver código-fonte da página” (ou “Inspecionar” no Chrome).
3. Pesquise por “SEATEXT” ou uma parte única do trecho. Se você encontrá-lo, o código está presente na página entregue.
4. Abra as Ferramentas do desenvolvedor e vá para a aba Rede.
5. Recarregue a página e procure por solicitações aos servidores do SeaText. Se você não vir nenhuma, o script pode estar bloqueado ou o domínio pode estar errado.
6. Verifique a aba Console para erros de JavaScript que mencionem SeaText ou o trecho.

Esta verificação é genérica, mas funciona para qualquer integração baseada em JavaScript. Os sinais-chave são a presença no código-fonte e a atividade no log de rede.

Por que a conta e o domínio importam

O SeaText não é executado da mesma forma em todos os domínios. A conta e a URL precisam estar alinhadas.

• Cada conta SEATEXT AI está vinculada a uma única URL primária.
• Se o seu site Odoo usar um domínio diferente daquele na conta, o script pode carregar, mas a conexão pode ficar inativa.
• URLs de desenvolvimento, como localhost, são restritas por razões de segurança.
• Domínios de desenvolvimento dinâmicos podem não funcionar corretamente porque o SeaText pode não associar o tráfego à conta correta.
• Se você usar o SeaText em vários sites, crie uma conta para cada site.

Então, quando você verificar, pergunte-se: “Esta é a URL primária exata na conta que emitiu este trecho?” Se não for, a verificação de “executando corretamente” falhará sem culpa do código.

Fatos-chave que afetam sua verificação

Limitações e quando esta verificação não se aplica

Estas instruções assumem que você usou o módulo Site do Odoo e o bloco Código de incorporação. Se você inseriu o SeaText por um método diferente, como um tema personalizado ou um aplicativo de terceiros, as etapas exatas serão diferentes.

O indicador de status, se você tiver um, apenas informa sobre a conexão. Ele não garante que todos os agentes SeaText estejam ativos. Para uma verificação de saúde mais profunda, olhe o painel da sua conta SEATEXT AI e a atividade de rede da página.

Se você estiver usando um domínio de staging, uma VPN ou uma URL de pré-visualização, não se surpreenda se a integração não passar na verificação. Esses endereços frequentemente falham na regra da URL primária.

Finalmente, esta verificação confirma a instalação e a comunicação básica. Ela não cobre preços, limites de plano ou quais agentes estão habilitados. Para isso, verifique as configurações da sua conta SeaText e a página de preços.

Terminologia que você pode ver

Módulo Código de incorporação

Um bloco do Odoo na seção Conteúdo dinâmico que permite colar HTML bruto ou JavaScript. É onde o trecho SEATEXT AI vai.

Conteúdo dinâmico

Uma seção do painel de blocos do Odoo que contém widgets como Código de incorporação e outros elementos orientados a conteúdo.

Visibilidade

Configurações do Odoo que controlam quando um bloco aparece. As instruções do SeaText usam “Ocultar no desktop” para manter o bloco de incorporação de aparecer como um elemento vazio.

URL primária

O único domínio vinculado a uma conta SEATEXT AI. O script funciona com este domínio e pode não funcionar com outros, a menos que você crie outra conta.

Perguntas frequentes

Por que o SeaText não funciona em localhost?

URLs de desenvolvimento, como localhost, são restritas por razões de segurança. Use um domínio válido e real para testes.

Posso usar a mesma conta SeaText nos meus domínios de staging e produção?

Não. Cada conta SEATEXT AI está vinculada a uma única URL primária. Se você precisar do SeaText em mais de um domínio, crie uma conta separada para cada um.

E se o código desaparecer da minha página do Odoo?

Reabra o bloco Código de incorporação, cole o trecho da sua conta SEATEXT AI novamente, salve e ajuste a configuração de Visibilidade.

Eu realmente preciso selecionar “Ocultar no desktop”?

As etapas oficiais de integração do Odoo dizem para selecionar “Ocultar no desktop” na seção Visibilidade e salvar novamente. Isso oculta o bloco enquanto o script permanece ativo.

O que devo procurar nas Ferramentas do desenvolvedor do navegador?

Recarregue a página, abra a aba Rede e procure por solicitações aos servidores do SeaText. Se você não vir nenhuma, o trecho provavelmente não está carregando.

Se eu tiver dois sites, preciso de duas contas?

Sim. De acordo com o guia de integração, cada conta está vinculada a uma URL primária. Crie uma conta para cada site.