Como instalar o agente no WordPress e WooCommerce

Três formas de inserir o código no WordPress, como o agente lê o catálogo do WooCommerce, o que fazer com os plugins de cache e como ligar o chat ao carrinho de compras.

6 de setembro de 2026

No WordPress, o código pode ser inserido de três formas. Escolha a que melhor se adapta ao seu nível de conforto com a edição de ficheiros de tema.

Método 1: Plugin de inserção de código (recomendado)#

A opção mais segura: a alteração não se perderá ao atualizar o tema.

1. Instale qualquer plugin para inserir scripts: WPCode, Insert Headers and Footers, Code Snippets.
2. Abra as definições do plugin e encontre o campo para o código no rodapé — geralmente, chama-se Footer ou Body (before closing tag).
3. Cole a linha do painel de controlo e guarde.

Método 2: Ficheiro do tema#

1. Aparência → Editor de ficheiros do tema.
2. Abra footer.php.
3. Insira o código antes de </body>.
4. Atualize o ficheiro.

Importante: edite o tema filho. Ao atualizar o tema pai, o ficheiro será substituído, incluindo o seu código.

Método 3: Via functions.php#

Para quem tem mais afinidade com código. Em functions.php do tema filho:

add_action('wp_footer', function () {
`echo '<script src="https://comag.vibevox.pro/widget.js" data-slug="o-seu-slug" async></script>';`
});

Obtenha a linha exata do script no painel de controlo, através do botão «Copiar código».

Catálogo do WooCommerce#

Indique o endereço do site nas definições e inicie a análise. O rastreador lê os produtos WooCommerce através dos dados estruturados das páginas: nome, preço, disponibilidade, descrição, fotografias, categorias.

O que deve saber:

• Produtos variáveis aparecem na ficha com um intervalo de preços e características.
• Ocultos e rascunhos não são lidos — e é assim que deve ser.
• Produtos apenas para utilizadores autenticados não serão vistos pelo agente: ele navega no site como um visitante comum.
• Se tiver uma exportação de produtos em CSV, pode carregá-la na secção «Catálogo» — por vezes, é mais rápido e preciso do que o rastreamento.

Carrinho e pagamento#

No WooCommerce, o pagamento no chat geralmente não é ativado: a loja tem o seu próprio sistema de checkout com entrega, impostos e cupões.

Indique nas definições o link para o carrinho, geralmente https://o-seu-domínio/cart ou /carrinho. O agente irá direcionar o comprador para lá.

Para ver quais diálogos se transformam em encomendas, adicione o fragmento do pixel de compra à página «Obrigado pela encomenda». No WooCommerce, isto é o template checkout/thankyou.php ou o mesmo plugin de inserção de código com uma condição para a página de encomenda.

O botão no chat adiciona o produto ao carrinho WooCommerce#

As fichas de produto nas respostas do agente não são apenas imagens decorativas. Cada uma tem um link para a página do produto na sua loja, e o agente sabe usar o mecanismo padrão do WooCommerce para adicionar ao carrinho: um endereço do tipo ?add-to-cart=123.

O comprador clica no botão no chat, o produto é adicionado ao carrinho, e o seu sistema de checkout funciona com todos os plugins de entrega, cupões e impostos. Não são necessárias integrações ou chaves para isto: o mecanismo está integrado no WooCommerce desde o seu início.

Se o link levar a uma página de produto variável, o agente abre-a — o comprador deve escolher o tamanho e a cor por si mesmo, e isso é correto: predefinir uma opção para ele é arriscado.

Outra coisa que deve saber: o agente vê a página onde o chat está aberto. Ele lê a marcação do produto — nome, SKU, preço — e responde no contexto. Se um visitante estiver na ficha de produto e escrever «há mais barato?», o agente compreende com o que comparar e oferece uma alternativa do seu catálogo, em vez de um conselho abstrato.

A principal razão para o «widget não aparecer» no WordPress é a cache. Após inserir o código:

1. Limpe a cache do plugin: WP Rocket, W3 Total Cache, LiteSpeed ou o que estiver a usar.
2. Limpe a cache da CDN, se usar Cloudflare.
3. Verifique o site em modo de navegação anónima.

Se a «combinação e carregamento diferido de scripts» estiver ativada no plugin, adicione o nosso script às exceções: a fusão de scripts de terceiros por vezes quebra o carregamento.

Tema claro e escuro#

O widget suporta ambos. Nas definições, pode escolher o tema claro, o escuro ou «como o visitante» — este último segue as definições de sistema do dispositivo e é o padrão.

Isto é útil se o seu tema WordPress tiver um seletor de dia e noite: mantenha «como o visitante», e o chat corresponderá ao que a pessoa já escolheu no seu dispositivo.

Plugins de cache#

Verificação#

• O botão do chat aparece no canto inferior direito em qualquer página do site.
• Uma pergunta sobre um produto resulta numa ficha com o preço.
• O botão de checkout leva ao carrinho WooCommerce.
• No telemóvel, o botão não sobrepõe o menu e o carrinho.

Perguntas frequentes#

É necessário um plugin Commerce Agents separado#

Não. Uma linha de código é suficiente; um plugin separado não é necessário nem instalado.

O widget não apareceu, o que verificar primeiro#

A cache: o plugin de cache e a CDN. Em seguida, verifique se o código foi inserido no rodapé e não num widget arbitrário da barra lateral, e se o tema realmente exibe wp_footer().

O agente saberá sobre descontos e cupões#

Sobre os cupões, não: eles são aplicados no carrinho WooCommerce. O agente mostra os preços que estavam presentes durante o rastreamento, incluindo o preço com desconto, se este for exibido na página do produto.

Isto irá abrandar o site#

O script é assíncrono, pesa pouco e não bloqueia a renderização da página. O impacto no PageSpeed é mínimo.

É possível mostrar o widget apenas na loja, e não no blog#

Sim, se o código for inserido através de um plugin com condições de exibição ou em functions.php com a verificação is_woocommerce(). Num caso simples, o agente em todas as páginas não interfere: ele também responde a perguntas sobre entrega do blog.