Receita: FAQ gerado e revisado
Perguntas reais, rascunho assistido por IA, revisão humana e marcação FAQPage opcional.
Neste texto
Que problema esta receita resolve?
Perguntas e respostas curtas são o formato que leitores e sistemas de resposta mais reaproveitam. O problema é a qualidade: FAQs gerados em massa trazem perguntas que ninguém fez, respostas genéricas e, pior, afirmações erradas com tom seguro. Esta receita organiza um fluxo em que a IA acelera o rascunho e o controle de verdade fica com uma pessoa, e entrega o código para exibir o resultado de forma acessível.
A lógica vem de plugins de FAQ assistido por IA que Camillo Dantas desenvolveu. Esses plugins não são vendidos; aqui estão o método e o código.
O que mudou no Google
A documentação do Google informa que o rich result de FAQ não aparece mais na Busca: um aviso de descontinuação foi publicado em 8 de maio de 2026, com fim da exibição em 7 de maio de 2026, e a documentação foi removida em 15 de junho de 2026. Antes disso, desde setembro de 2023, o recurso estava restrito a sites governamentais e de saúde conhecidos.
Consequência prática: não faça FAQ esperando o recurso visual. O valor atual do FAQ é editorial, a resposta direta para quem lê e para quem extrai a informação. A marcação FAQPage do schema.org continua sendo um vocabulário válido; manter ou não é decisão sua, sem promessa de efeito em resultado.
Quando usar e quando não usar
Use quando existe dúvida recorrente documentada: perguntas que chegam por e-mail, chat, comentários ou aparecem nas consultas do Search Console.
Não use:
- para inflar a página com perguntas inventadas só para parecer completa;
- em temas sensíveis (saúde, finanças, direito) sem revisão por profissional habilitado;
- para repetir a mesma resposta já dada no corpo, sem acrescentar nada.
Pré-requisitos
- Fonte de perguntas reais (exportação de consultas do Search Console, caixa de entrada do suporte).
- Uma pessoa responsável pela revisão.
- Um mu-plugin para exibir e marcar.
- Nível: intermediário.
Passo a passo
- 01Levante de 8 a 15 perguntas reais e agrupe as duplicadas.
- 02Peça o rascunho a um modelo de linguagem, informando o contexto e as fontes que ele deve usar, sem colar dados pessoais.
- 03Revise cada resposta: fato, número, data e tom. Corte o que não conseguir comprovar.
- 04Grave os pares no post e exiba com details.
- 05Opcional: publique FAQPage em JSON-LD com o mesmo texto visível.
Passo 2: o pedido ao modelo
Use um texto como este, adaptando o contexto. Não coloque chaves de API em código de site; faça o rascunho em uma ferramenta de sua conta e cole o resultado no editor.
Contexto: página sobre [assunto], leitor [perfil].
Perguntas reais (lista abaixo). Para cada uma, responda em 40 a 80 palavras,
em português do Brasil, sem promessas de resultado, sem números que eu não tenha fornecido.
Se não souber, escreva "VERIFICAR".
Perguntas:
1. ...
A instrução "escreva VERIFICAR" cria um marcador que o revisor pode procurar antes de publicar.
Passo 4: gravar e exibir
Formato de entrada num campo do post (uma pergunta por linha iniciada com P: e a resposta na linha seguinte com R:):
P: Quanto tempo leva para o sitemap ser lido?
R: Não há prazo garantido. Envie o sitemap no Search Console e acompanhe o relatório.
Código do mu-plugin:
<?php
/**
* Plugin Name: FAQ revisado (receita)
*/
function faq_parse( $texto ) {
$pares = array();
$atual = null;
foreach ( preg_split( '/\R/u', (string) $texto ) as $linha ) {
$linha = trim( $linha );
if ( 0 === strpos( $linha, 'P:' ) ) {
$atual = array( 'p' => trim( substr( $linha, 2 ) ), 'r' => '' );
} elseif ( 0 === strpos( $linha, 'R:' ) && null !== $atual ) {
$atual['r'] = trim( substr( $linha, 2 ) );
if ( '' !== $atual['p'] && '' !== $atual['r'] ) {
$pares[] = $atual;
}
$atual = null;
}
}
return $pares;
}
add_filter( 'the_content', function ( $conteudo ) {
if ( ! is_singular( 'post' ) || ! in_the_loop() || ! is_main_query() ) {
return $conteudo;
}
$pares = faq_parse( get_post_meta( get_the_ID(), 'faq_texto', true ) );
if ( ! $pares ) {
return $conteudo;
}
$html = '<section class="faq"><h2>Perguntas frequentes</h2>';
foreach ( $pares as $par ) {
$html .= '<details><summary>' . esc_html( $par['p'] ) . '</summary><p>' . esc_html( $par['r'] ) . '</p></details>';
}
return $conteudo . $html . '</section>';
}, 15 );
add_action( 'wp_head', function () {
if ( ! is_singular( 'post' ) ) {
return;
}
$pares = faq_parse( get_post_meta( get_queried_object_id(), 'faq_texto', true ) );
if ( ! $pares ) {
return;
}
$itens = array();
foreach ( $pares as $par ) {
$itens[] = array(
'@type' => 'Question',
'name' => $par['p'],
'acceptedAnswer' => array( '@type' => 'Answer', 'text' => $par['r'] ),
);
}
$json = array( '@context' => 'https://schema.org', '@type' => 'FAQPage', 'mainEntity' => $itens );
echo '<script type="application/ld+json">' . wp_json_encode( $json, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_HEX_TAG ) . '</script>' . "\n";
}, 20 );
Por que details e summary: o elemento nativo é acessível por teclado, abre e fecha sem JavaScript e deixa o texto da resposta no HTML, visível a quem lê o código-fonte. A marcação usa o mesmo texto exibido, regra básica de dados estruturados: o que está no JSON-LD precisa estar na página.
Para preencher o campo faq_texto, use o painel "Campos personalizados" do editor. Para um campo de várias linhas mais confortável, registre uma caixa com add_meta_box().
Como testar
Critério de sucesso: cada pergunta é uma dúvida real, cada resposta tem de 40 a 80 palavras, o HTML mostra as respostas, e o validador não acusa erro de sintaxe no FAQPage.
- Rode o validador de marcação do schema.org com a URL e confirme o tipo FAQPage com os pares.
- Conte as palavras de cada resposta. Fora da faixa, reescreva.
- Procure "VERIFICAR" no campo antes de publicar: nenhuma ocorrência pode sobrar.
- Teste com o teclado: Tab chega a cada
summary, Enter e Espaço abrem. - Compare cada afirmação factual com a fonte original, de preferência documentação oficial.
Erros comuns e como desfazer
- Respostas copiadas do corpo do artigo: resuma e acrescente o ponto de decisão.
- Perguntas de marketing disfarçadas ("Por que somos os melhores?"): troque por dúvidas reais.
- Número inventado pelo modelo: remova ou comprove com fonte e data.
- Marcação diferente do texto visível: gere as duas saídas do mesmo campo, como no código.
- Expectativa de rich result: o recurso foi descontinuado.
Para desfazer, esvazie o campo faq_texto do post ou remova o arquivo. O corpo do texto não é alterado.
Checklist final
- Perguntas vindas de fonte real.
- Respostas de 40 a 80 palavras, conferidas por pessoa.
- Nenhuma ocorrência de "VERIFICAR".
- Texto visível igual ao JSON-LD.
- Sem promessa de resultado.
- Data de revisão anotada.
Próximos passos
Para organizar a revisão de conteúdo em lote, veja a receita de auditoria de conteúdo. A autoria e a revisão aparecem na receita de schema de autor e revisor. O método de escrever respostas citáveis está no curso Conteúdo para IA na prática, e o mini-curso Schemas com IA treina a marcação. O termo está no glossário em FAQPage.
Fontes
- FAQ structured data (aviso de descontinuação), Google Search Central (2026-10-08)
- FAQPage, schema.org (2026-10-14)
- The details disclosure element, MDN Web Docs (2026-10-14)
Não sabe por onde começar?
Compare as opções e escolha a trilha pelo seu objetivo.