Especificação pública para IA
A URL de aprendizado do Converto — o que a rota /spec expõe, como pedir o contrato completo de widgets e o que exige login.
Para que uma IA escreva Markdown Converto sem inventar widgets ou campos, o tema publica uma especificação legível por máquina.
Onde encontrar
Em Converto → Integrações → IA, o campo URL de aprendizado (somente leitura) mostra o endereço. Ele aponta para a rota REST converto/v1/spec do seu site, por exemplo:
https://seusite.com.br/wp-json/converto/v1/specAdicione esse link como fonte de aprendizado no seu serviço de IA e peça que a leia antes de escrever qualquer coisa.
O que a rota devolve
| Chamada | Resposta |
|---|---|
GET /wp-json/converto/v1/spec | Índice leve e público: regras da linguagem, formatos de valor, tipos de página recomendados, opções de página, guia de design e a lista de widgets (id, intenção, descrição, quando usar). |
GET …/spec?id=hero-01,cta-01 | Contrato completo só dos widgets pedidos: todos os campos, tipos, opções, faixas, condições e um exemplo. |
GET …/spec?intent=hero | Contrato completo dos widgets de uma intenção (hero, faq, pricing…). |
A resposta inclui um campo spec_revision (resumo do índice), que muda quando widgets são adicionados ou alterados, e é cacheada por cinco minutos.
Para que serve a lista de "playbook"
O índice também descreve tipos de página (captura, vendas, planos, webinar, institucional, informativa, obrigado e link na bio), a sequência de seções recomendada para cada um e as regras de composição (um único hero, header na frente, footer no fim).