---
title: Como instalar o agente no WordPress e WooCommerce
description: 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.
section: platforms
keywords: WordPress, WooCommerce, instalar agente WordPress, widget WordPress, chat para site, chat online, footer.php, plugin de código WordPress, agente IA, agente de vendas IA, integrar chat WooCommerce, adicionar chat WordPress
updated: 2026-09-06
---
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:

```php
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.