API/Webhook + AymarTech

Envie artigos gerados por IA ao seu endpoint automaticamente ou após aprovação usando webhooks assinados.

API/Webhook é para sites personalizados e stacks CMS não suportados. Seu site pode buscar artigos aprovados ou auto-publicados da AymarTech com uma chave API e receber notificações webhook quando o estado do artigo mudar.

Problemas

Por que a publicação SEO continua travando

A maioria das equipes não falha por falta de ideias. Ela trava porque cada artigo exige pequenas decisões manuais demais antes de ir ao ar.

A escolha de temas vira palpite

Demanda de palavras-chave, intenção de busca e fit com o negócio ficam espalhados entre abas, então o próximo artigo é escolhido por opinião em vez de evidência.

Cada artigo vira uma checklist operacional

Briefs, rascunhos, imagens, metadados, links internos e QA passam por várias ferramentas até o processo ficar lento e inconsistente.

A publicação trava na última milha

Rascunhos prontos esperam por slugs, formatação, campos da plataforma e alguém com tempo para colocar tudo no ar.

O que você recebe

Da demanda real de busca a artigos prontos para indexação

Palavras-chave que as pessoas já pesquisam

A AymarTech encontra buscas com demanda real, intenção clara e uma chance realista de trazer tráfego qualificado.

Pesquisa profunda em muitas fontes

Cada artigo é construído com pesquisa ampla de fontes, para cobrir o tema com substância em vez de texto genérico.

Publicação pensada para o Google

Estrutura limpa, metadados, slugs, links internos e publicação direta ajudam o Google a descobrir e indexar novos artigos mais rápido.

Fluxo de conteúdo

Da palavra-chave ao artigo SEO finalizado

01

Encontrar demanda

A AymarTech identifica temas de baixa concorrência que seus clientes já estão pesquisando.

02

Escrever e otimizar

O artigo é escrito, verificado, formatado, enriquecido com imagens e preparado com detalhes de SEO.

03

Entregar o payload

A AymarTech prepara o artigo para a Publishing API e eventos webhook, depois entrega automaticamente ou aguarda aprovação.

Para quem é

Use quando você controla o código, quer renderização personalizada ou precisa que a AymarTech notifique seu backend com entrega automática ou confirmação antes de expor os dados do artigo.

O que é publicado ou entregue

Carga útil A AymarTech expõe artigos publicados pela Publishing API e pode enviar webhooks article_published, article_updated e article_unpublished. Os payloads de webhook incluem event, article id, slug, headline, estado de publicação e updatedAt; as respostas de artigo da API incluem conteúdo e metadados para renderização.

Configuração

Todos os formulários de conexão, botões OAuth, seletores de destino, ajustes de modo de publicação e testes ficam no painel da AymarTech. Escolha publicação automática ou exija confirmação antes de ir ao ar.

Abrir integrações no painel →
  1. Abra o projeto na AymarTech e vá às configurações de publishing/API no painel.
  2. Gere uma chave API para o projeto.
  3. Defina BLOG_WRITER_BASE_URL como a URL base da publish API do projeto e BLOG_WRITER_API_KEY como a chave gerada no ambiente do seu site.
  4. Use GET /articles para listas, GET /articles?slug=... para páginas de artigo e GET /sitemap para sitemap dinâmico.
  5. Escolha entrega automática ou confirmação antes de expor dados do artigo e, opcionalmente, adicione uma URL de webhook e um secret para revalidação de cache ou fluxos posteriores.
  6. Envie um webhook de teste pelo painel e confirme que seu endpoint responde 2xx.

Como a publicação ou entrega de artigos funciona

  • A Publishing API retorna apenas dados de artigos aprovados ou auto-publicados do projeto associado à chave API.
  • Webhooks são enviados após aprovação ou auto-publicação nos eventos article_published, article_updated e article_unpublished.
  • Se um secret de webhook estiver configurado, a AymarTech envia os cabeçalhos X-Webhook-Signature e X-Webhook-Secret.
  • Assinaturas de webhook são HMAC-SHA256 sobre o corpo JSON do payload.
  • Seu site continua responsável por renderizar HTML, metadados SEO, URLs canônicas, hreflang e invalidação de cache.

Solução de problemas

  • 401 da Publishing API: confirme que a chave API está em X-API-Key ou Authorization: Bearer.
  • Nenhum artigo retornado: confirme que os artigos estão aprovados ou auto-publicados na AymarTech e que o ID do projeto/URL base está correto.
  • Assinatura do webhook não confere: verifique se seu servidor calcula HMAC sobre o corpo JSON bruto exato com o secret salvo.
  • Timeout do webhook: confirme rapidamente com 2xx e mova o processamento pesado para uma fila.
  • Sitemap desatualizado: gere dinamicamente ou revalide quando chegarem webhooks article_published.

Perguntas frequentes

A entrega API/Webhook pode ser automática?

Sim. Você escolhe o modo: entregar ou expor dados do artigo automaticamente quando estiver pronto, ou exigir confirmação primeiro. Seu site ou backend ainda decide como renderizar ou armazenar o conteúdo.

Quais endpoints eu preciso?

A maioria dos sites usa /articles para listas, /articles?slug=... para páginas de detalhe e /sitemap para descoberta SEO.

Webhooks são obrigatórios?

Não. São opcionais, mas úteis para revalidação de cache e fluxos posteriores.

Como devo verificar webhooks?

Use X-Webhook-Signature com seu secret compartilhado. X-Webhook-Secret também é enviado quando configurado, para validação mais simples.

Onde estão os valores exatos da API?

O painel mostra a chave API do projeto, a URL base da publish API, o campo de URL do webhook, o campo secret e as ações de teste.

Relacionados

NotionShopifyWordPress.orgVer todas as integrações

Controle a entrega de artigos SEO

Comece grátis, conecte seu endpoint e escolha entrega automática ou aprovação antes de os artigos otimizados chegarem ao seu backend.

Teste grátis