---
title: Como instalar o agente no Wix
description: Onde inserir o código do widget no Wix, as diferenças na instalação no Wix Stores, o que fazer se o código não estiver disponível no plano gratuito e como verificar o funcionamento.
section: platforms
keywords: Wix, widget Wix, instalar widget Wix, adicionar widget Wix, código personalizado Wix, código HTML Wix, Wix Stores, chat para site Wix, agente IA Wix, chatbot IA Wix, integrar agente IA Wix, vendas IA Wix
updated: 2026-09-06
---
No Wix, a inserção de código de terceiros encontra-se numa secção separada das definições e requer um plano pago com um domínio conectado. A partir daí, é simples.

## Passo 1. Abra o código personalizado

1. No painel de controlo do site, abra **Settings** («Definições»).
2. Encontre a secção **Custom Code** («Código Personalizado») no bloco «Avançado».
3. Clique em **+ Add Custom Code**.

## Passo 2. Insira o código

1. No campo de código, insira a linha da sua conta Commerce Agents.
2. Atribua um nome claro: `Commerce Agents`.
3. **Add Code to Pages** — selecione **All pages** e o modo **Load once**.
4. **Place Code in** — selecione **Body — end**.
5. Guarde e publique o site.

O botão de chat aparecerá um segundo após o carregamento da página.

> [!warning] O código personalizado está disponível nos planos pagos do Wix com um domínio conectado. Não é possível inserir o script num plano gratuito — neste caso, use o link para o agente: coloque-o como um botão na página e no cabeçalho dos perfis nas redes sociais.

## Passo 3. Catálogo da Wix Stores

Indique o endereço do site nas definições e inicie a análise. O rastreador lê as páginas de produtos da Wix Stores: nome, preço, descrição, fotografias, disponibilidade.

Uma particularidade do Wix: parte do conteúdo é carregada por scripts. Normalmente, o catálogo é lido sem problemas, mas se forem encontrados poucos produtos, existem duas soluções alternativas:

- exportar os produtos para CSV a partir do painel do Wix e carregar o ficheiro na secção «Catálogo»;
- adicionar os artigos principais manualmente, e recolher o restante das publicações nas redes sociais.

## Passo 4. Carrinho

Se tiver Wix Stores, não ative o pagamento no chat. Indique nas definições o link para o carrinho — geralmente `https://o-seu-dominio/cart` — e o agente guiará o comprador até lá.

Se a loja não estiver conectada e os produtos estiverem descritos nas páginas, ative o pagamento no chat: o comprador fará e pagará a encomenda diretamente na conversa.

## O cartão no chat abre o produto na loja

O agente responde com cartões, não com texto: fotografia, nome, preço e um botão. Clicar abre a página do produto da Wix Stores na mesma janela — o comprador é direcionado para o seu cartão de produto, onde já existe o botão «Adicionar ao carrinho» e tudo o que configurou.

A ideia é que a pessoa não navegue pelo catálogo sozinha. Ela diz «preciso de um presente até quinhentos», o agente seleciona três opções do seu próprio sortido, mostra-as lado a lado e explica a diferença. O comprador clica no que mais gosta e é levado exatamente para onde precisa.

Os produtos recolhidos não do site, mas de publicações nas redes sociais, funcionam da mesma forma: o botão abre a publicação original. O catálogo pode ser compilado de diferentes locais, mas leva sempre para onde vende.

Além disso, o contexto da página: o agente lê a marcação do produto na página aberta, por isso entende a pergunta «e noutra cor?» sem necessidade de esclarecimentos — ele sabe o que o comprador está a ver.

- Abra o site em modo de navegação anónima, aguarde pelo botão de chat.
- Faça uma pergunta sobre o produto: o agente deve mostrar um cartão com o preço.
- Verifique no telemóvel: no Wix, os elementos flutuantes por vezes sobrepõem-se. Se isso for um problema, mude a posição do botão para a esquerda.
- Certifique-se de que, após a publicação do site, o código está no lugar: o Wix aplica o código personalizado apenas à versão publicada.

## Tema claro e escuro

O chat tem três modos de apresentação: claro, escuro e «como o visitante». Por predefinição, o terceiro modo está ativo — o tema adapta-se às definições do dispositivo.

Os modelos Wix são frequentemente construídos sobre um fundo contrastante, por isso, se o site for escuro, defina o tema escuro de forma fixa: assim, a janela de chat parecerá parte do design, e não um autocolante sobre ele.

## Verificação

## Problemas comuns

**O botão não apareceu.** O site não foi publicado após a adição do código ou o código não foi adicionado a todas as páginas. Verifique as definições de Custom Code: All pages, Body — end.

**O código desapareceu.** Isso pode acontecer após a mudança do modelo do site. Adicione-o novamente.

**O widget sobrepõe-se a elementos do Wix.** Mova o botão para a esquerda nas definições do widget ou remova o segundo elemento flutuante do Wix.

**Poucos produtos no catálogo.** Carregue o CSV a partir do painel do Wix: esta é uma solução mais fiável para sites onde o conteúdo é construído por scripts.

## Perguntas frequentes

### É necessário Velo ou um programador

Não. Basta inserir o código na secção Custom Code; não é necessária programação.

### O agente funciona num site Wix gratuito

A inserção de código não está disponível no plano gratuito. Mas o agente por link funciona lá também: o endereço curto pode ser colocado como um botão na página e nas redes sociais.

### O Wix detetará um script de terceiros

O código personalizado é uma funcionalidade padrão do Wix, não há restrições para tais scripts.

### Como atualizar o catálogo após alterações de preço

Execute a análise do site novamente. Os cartões existentes serão atualizados em termos de preço e disponibilidade; não aparecerão duplicados.

### É possível colocar o agente apenas na página do produto

Sim, nas definições de Custom Code, selecione páginas específicas em vez de All pages.
