O plugin do QA Proof para WordPress adiciona um menu QAProof dentro do seu admin do WP, onde você pode executar testes, agendar monitores e visualizar relatórios em PDF — tudo sem escrever nenhum código de API.

Requisitos

WordPress 6.0+ (versões mais antigas podem funcionar, mas não são testadas).
PHP 7.4 ou mais recente.
Uma conta QA Proof e uma chave de API — veja o Início Rápido caso ainda não tenha criado uma.
Acesso HTTPS de saída do seu servidor WP para api.qaproof.io.

1. Instale o plugin

Baixe o .zip do plugin a partir da sua conta QA Proof.
No admin do WP, vá em Plugins → Adicionar Novo → Enviar Plugin.
Escolha o .zip, clique em Instalar Agora e depois em Ativar Plugin.

Uma nova entrada QAProof aparece na barra lateral do admin do WP.

2. Conecte sua chave de API

Abra QAProof → Configurações → Geral.
Cole sua chave de API (de qaproof.io/app/api-keys) no campo Configuração de API.
Clique em Salvar Alterações.
O cartão abaixo do campo deve agora mostrar o e-mail da sua conta, o selo do plano atual, as gerações de IA usadas / limite, o limite de monitores e o período de retenção do histórico.

3. Verifique a conexão

Clique em Testar Conexão na mesma página de Configurações. Você deverá ver "Connected! API status: ok". Se você receber um erro, verifique:

A chave começa com qap_live_sk_ e não tem espaços em branco no início/fim.
Sua hospedagem permite HTTPS de saída para api.qaproof.io (alguns ambientes com firewall bloqueiam chamadas de API de terceiros).
A conta está em um plano pago se sua chave de API acabou de ser regenerada — chaves antigas param de funcionar imediatamente quando você as regenera.

O que você obtém dentro do admin do WP

Dashboard — visão geral: total de testes, pontuação média, monitores, gerações de IA usadas / limite.
Tests — execute um teste sob demanda (Fidelidade de Design, Responsividade, Regressão Visual, Acessibilidade ou Auditoria de Design) e navegue pelo histórico com download em PDF.
Monitors — agende verificações de regressão recorrentes (diárias / semanais / mensais) com notificações por e-mail quando as pontuações caem.
Settings — chave de API, padrões de monitoramento (e-mail de notificação, limite de alerta), opções de limpeza de dados.

Atualizando o plugin

Quando uma nova versão do plugin é lançada, você verá um aviso de atualização em Plugins. Clique em Atualizar Agora. Seus monitores, baselines e histórico de testes são preservados nas atualizações.

Desinstalando

Desative o plugin em Plugins e depois clique em Excluir. Por padrão, isso mantém seus monitores e histórico de testes no banco de dados. Para apagar tudo, ative Configurações → Limpeza de Dados → Remover todos os dados do plugin ao desinstalar antes de excluir.

Sua conta QA Proof, chave de API e quaisquer baselines armazenados em nosso servidor não são afetados — eles ficam no qaproof.io.

Solução de problemas

"Could not reach the API"

Problema de firewall ou DNS no nível do servidor. Tente:

Abra um terminal no seu servidor WP: curl -I https://api.qaproof.io/api/health — deve retornar 200 OK.
Se sua hospedagem bloqueia chamadas de saída, peça para colocar api.qaproof.io na lista de permissões.

"Invalid API key"

A chave foi digitada incorretamente, regenerada no qaproof.io (chave antiga invalidada) ou pertence a uma conta diferente. Abra qaproof.io/app/api-keys, copie a chave atual, cole novamente e salve.

O monitor não dispara no horário agendado

Os monitores dependem do WP-Cron. Se o seu site tem tráfego muito baixo, o WP-Cron pode não ser executado de forma consistente. O plugin aciona o WP-Cron pelo navegador quando você abre a página de Monitores; para produção, configure um cron job real que acesse o wp-cron.php a cada 5–10 minutos.