receita

Receita: FAQ gerado e revisado

Perguntas reais, rascunho assistido por IA, revisão humana e marcação FAQPage opcional.

resposta curtaUm FAQ útil nasce de perguntas reais (Search Console, atendimento, comentários), com respostas de 40 a 80 palavras conferidas por uma pessoa. A IA pode rascunhar, mas quem responde por cada afirmação é o editor. Em WordPress, guarde os pares em um campo do post, exiba com details e, se quiser, publique FAQPage em JSON-LD. O rich result de FAQ deixou de existir no Google em maio de 2026.
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

  1. 01Levante de 8 a 15 perguntas reais e agrupe as duplicadas.
  2. 02Peça o rascunho a um modelo de linguagem, informando o contexto e as fontes que ele deve usar, sem colar dados pessoais.
  3. 03Revise cada resposta: fato, número, data e tom. Corte o que não conseguir comprovar.
  4. 04Grave os pares no post e exiba com details.
  5. 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.

  1. Rode o validador de marcação do schema.org com a URL e confirme o tipo FAQPage com os pares.
  2. Conte as palavras de cada resposta. Fora da faixa, reescreva.
  3. Procure "VERIFICAR" no campo antes de publicar: nenhuma ocorrência pode sobrar.
  4. Teste com o teclado: Tab chega a cada summary, Enter e Espaço abrem.
  5. 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

  1. FAQ structured data (aviso de descontinuação), Google Search Central (2026-10-08)
  2. FAQPage, schema.org (2026-10-14)
  3. 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.