# Prova virtual por IA para WooCommerce: documentação

> O que o plugin faz O DF Google Try-On acrescenta um botão de prova virtual às suas fichas de produto WooCommerce. A cliente carrega uma fotografia ou usa a webcam,…

- Página: <https://www.datafirefly.com/pt/documentation/dfgoogletryonwp/>
- Idioma: pt
- Atualizado em: 2026-09-02
- Outros idiomas: [fr](https://www.datafirefly.com/documentation/dfgoogletryonwp/index.md), [en](https://www.datafirefly.com/en/documentation/dfgoogletryonwp/index.md), [es](https://www.datafirefly.com/es/documentation/dfgoogletryonwp/index.md), [de](https://www.datafirefly.com/de/documentation/dfgoogletryonwp/index.md), [it](https://www.datafirefly.com/it/documentation/dfgoogletryonwp/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfgoogletryonwp/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfgoogletryonwp/index.md)
- Índice: <https://www.datafirefly.com/pt/documentation/llms.txt>

## O que o plugin faz

O DF Google Try-On acrescenta um botão de prova virtual às suas fichas de produto WooCommerce. A cliente carrega uma fotografia ou usa a webcam, e a inteligência artificial gera uma imagem dela a usar a peça de roupa. A pré-visualização aparece numa modal, sem nunca sair da ficha de produto.

**Importante:** este plugin usa a API de programador _Vertex AI Virtual Try-On_ da Google Cloud. Não é a prova virtual de consumo visível na Pesquisa Google e no Google Shopping, que não é integrável num site de terceiros. Cada geração de imagem é faturada pela Google.

## Requisitos

- WordPress 6.2 ou superior, WooCommerce 7.0 ou superior
- PHP 7.4 ou superior, com a extensão OpenSSL ativa
- Um projeto Google Cloud com a faturação ativa
- A API Vertex AI ativada nesse projeto
- Uma conta de serviço com a função _Vertex AI User_

## Etapa 1: preparar a Google Cloud

### Ativar a API Vertex AI

Na consola da Google Cloud, selecione o seu projeto, vá à biblioteca de API e ative a _Vertex AI API_. Verifique que a faturação está mesmo ativa no projeto: sem ela, todas as chamadas falham.

### Criar a conta de serviço

1. Abra a secção IAM e administração, e depois Contas de serviço.
2. Crie uma conta de serviço (o nome não importa, por exemplo _woocommerce-tryon_).
3. Atribua-lhe a função **Vertex AI User**. Não conceda uma função mais ampla do que o necessário.
4. No separador Chaves, crie uma chave do tipo JSON e descarregue o ficheiro.

Este ficheiro JSON contém uma chave privada. Trate-o como uma palavra-passe: não o coloque num repositório, não o partilhe, e restrinja o acesso à sua administração do WordPress.

### Escolher uma região

O modelo tem de estar disponível na região que indicar. O valor predefinido _us-central1_ é o mais seguro. Se quiser uma região europeia, verifique previamente a disponibilidade do modelo Virtual Try-On na documentação da Google, porque a cobertura regional evolui.

## Etapa 2: instalar o plugin

1. No WordPress, vá a Plugins, Adicionar, Carregar plugin.
2. Selecione o ficheiro ZIP fornecido, instale e ative.
3. Aparece um novo menu: WooCommerce, Google Try-On.

## Etapa 3: configurar

Todas as definições estão em WooCommerce, Google Try-On.

### Ligação à Google

- **Identificador do projeto GCP**: o identificador do projeto, não o nome de apresentação.
- **Região**: por exemplo _us-central1_.
- **JSON da conta de serviço**: cole o conteúdo integral do ficheiro descarregado. O plugin valida o JSON na gravação e recusa uma chave mal formada.

Na gravação, a cache do token de acesso é limpa automaticamente: uma alteração de chave é portanto tida em conta de imediato.

### Apresentação

- **Ativar a prova**: interruptor geral. Enquanto estiver desassinalado, nada aparece do lado da loja.
- **Texto do botão**: o texto apresentado na ficha de produto.
- **Categorias elegíveis**: limita o widget a determinadas categorias. Deixe vazio para autorizar todos os produtos.

### Segurança e custos

- **Filtro de segurança**: nível de filtragem aplicado pela Google às imagens. O ajuste mais estrito é recomendado numa loja pública.
- **Marca de água**: acrescenta a marca de água SynthID da Google às imagens geradas. Recomendado, para assinalar que se trata de uma imagem sintética.
- **Limite mensal**: número máximo de provas bem-sucedidas por mês civil. Coloque 0 para não limitar, mas lembre-se de que cada geração é faturada.
- **Texto de consentimento**: a mensagem apresentada ao lado da caixa de seleção obrigatória.

O contador do mês em curso aparece no topo da página de definições.

## Etapa 4: controlar a apresentação produto a produto

Na ficha de um produto, separador Geral dos dados do produto, uma definição _Prova virtual_ propõe três valores:

- **Auto**: segue as categorias configuradas globalmente.
- **Apresentar sempre**: força a apresentação, mesmo fora das categorias elegíveis.
- **Nunca apresentar**: oculta o widget, seja qual for a configuração global.

A peça enviada à IA é a imagem principal do produto, obtida no servidor. Uma fotografia nítida da peça isolada, bem recortada e sobre fundo claro, dá resultados muito melhores do que uma fotografia vestida ou um cenário carregado.

## Como funciona do lado técnico

O percurso de uma prova é o seguinte:

1. A cliente abre a modal e fornece uma fotografia, por importação ou captura pela webcam. A imagem é redimensionada no navegador, pelo lado maior, antes de qualquer envio.
2. Assinala a caixa de consentimento, obrigatória: sem ela, o pedido é recusado pelo servidor.
3. O servidor verifica o token de segurança, o produto, a limitação por endereço IP e o limite mensal.
4. O plugin assina um token JWT em RS256 com a chave privada da conta de serviço, troca-o por um token de acesso OAuth2 e coloca-o em cache até perto da expiração.
5. A fotografia e a imagem do produto são enviadas ao modelo Vertex AI, que devolve a imagem gerada.
6. A imagem é devolvida ao navegador e apresentada na modal.

A imagem da peça nunca é fornecida pelo navegador: é sempre lida no servidor a partir da ficha de produto. Isso impede um visitante de desviar o serviço para provar uma imagem arbitrária.

## Dados pessoais e RGPD

A fotografia da cliente é um dado pessoal. O plugin foi concebido em conformidade:

- A fotografia nunca é guardada no seu servidor, nem na biblioteca de multimédia, nem na base de dados. Transita em memória durante o tempo da chamada.
- A imagem gerada é devolvida diretamente ao navegador e também não é guardada.
- Uma caixa de consentimento explícito, cujo texto redige, tem de ser assinalada antes de qualquer processamento.
- A fotografia é transmitida à Google, que atua como subcontratante. Mencione essa transferência na sua política de privacidade, indicando a finalidade e o destinatário.

O plugin não conserva qualquer imagem, mas compete-lhe documentar este tratamento no seu registo e na sua política de privacidade, e verificar as condições de utilização da Google Cloud aplicáveis ao seu projeto.

## Controlar os custos

Cada prova bem-sucedida corresponde a uma geração de imagem faturada pela Google. Estão integradas três salvaguardas:

- O limite mensal, que bloqueia as novas gerações depois de atingido.
- Uma limitação por endereço IP, que impede as chamadas em rajada.
- O uso exclusivo da imagem do produto no servidor, que proíbe qualquer uso desviado do serviço.

O contador é reposto automaticamente a cada novo mês civil. Vigie em paralelo o orçamento na consola da Google Cloud, onde pode definir alertas de faturação.

## Resolução de problemas

### O botão não aparece

Verifique por esta ordem: o interruptor geral está ativo, o identificador do projeto e o JSON estão preenchidos, o produto pertence a uma categoria elegível ou está forçado em Apresentar sempre, e o produto tem mesmo uma imagem principal.

### Mensagem de erro de autenticação

A chave JSON é inválida ou incompleta, ou a conta de serviço não tem a função Vertex AI User. Volte a colar o ficheiro completo e verifique a função na consola da Google Cloud. Verifique também que a extensão OpenSSL está disponível no seu alojamento.

### Nenhuma imagem gerada

O modelo pode recusar uma fotografia demasiado escura, desfocada, recortada ao rosto, ou com várias pessoas. Peça uma fotografia nítida, bem iluminada, de preferência de corpo inteiro e de frente. Um filtro de segurança muito estrito também pode bloquear certas imagens.

### Erro de região ou de modelo não encontrado

O modelo não está disponível na região introduzida. Volte a _us-central1_ e verifique a disponibilidade regional do modelo na documentação da Google.

### O serviço indica estar em plena capacidade

O limite mensal foi atingido. Aumente-o nas definições, ou espere pelo mês seguinte. O contador do mês em curso está visível no topo da página de definições.

## Perguntas frequentes

### É preciso instalar o Composer?

Não. O plugin usa um autoloader nativo e assina a autenticação da Google em PHP puro, através do OpenSSL.

### O plugin é compatível com HPOS?

Sim, a compatibilidade com o armazenamento de encomendas de alto desempenho está declarada.

### Funciona em telemóvel?

Sim. A captura usa a câmara frontal quando o navegador o permite, e a importação de fotografia está sempre disponível.

### É possível provar outra coisa que não roupa?

O modelo foi treinado para roupa vestida. Os resultados em acessórios, calçado ou objetos são muito menos fiáveis. Restrinja o widget às suas categorias de vestuário.

### O que acontece se desinstalar o plugin?

A desinstalação elimina as definições, o token em cache e os contadores mensais. A definição por produto é conservada, para não perder nada em caso de reinstalação.