Documentação

Tudo o que você precisa saber sobre como usar o BlogFlux.ai para automatizar sua criação de conteúdo.

Primeiros Passos

1. Crie Sua Conta

Cadastre-se para um teste gratuito de 14 dias. Você terá acesso instantâneo a todos os recursos.

Cadastre-se Agora →

2. Configure Suas Preferências

Escolha seu modelo de IA preferido (GPT-5 ou Claude), defina o tom do conteúdo e configure as preferências de SEO.

Ir para o Painel →

3. Conecte Seu Blog

Conecte seu site WordPress ou vincule qualquer CMS personalizado via webhooks. O BlogFlux.ai suporta integração perfeita com WordPress e qualquer plataforma habilitada para HTTP.

4. Gere Sua Primeira Postagem

Digite um tópico, escolha palavras-chave e veja o BlogFlux.ai criar uma postagem completa e otimizada para SEO em segundos.

Começar a Criar →

Integração WordPress

Conecte o BlogFlux.ai ao seu site WordPress usando a API REST nativa do WordPress. Nossa integração gerencia automaticamente autenticação, criação de postagens e otimização de metadados.

Passos de Configuração:

  1. Navegue até "Conexões de Blog" no seu painel
  2. Clique em "Conectar Site WordPress"
  3. Digite a URL do seu site WordPress (ex. https://seublog.com)
  4. Forneça seu nome de usuário WordPress e senha de aplicativo
  5. Teste a conexão e salve

Nota: Você precisará criar uma Senha de Aplicativo no WordPress (Usuários → Perfil → Senhas de Aplicativo) para autenticação segura.

Integração por webhook

Conecte o BlogFlux.ai a qualquer CMS personalizado, plataforma headless ou sistema habilitado para HTTP usando webhooks. Quando uma postagem é gerada, o BlogFlux.ai enviará uma requisição POST para sua URL de webhook com os dados completos da postagem.

Passos de Configuração:

  1. Navegue até "Conexões de Blog" no seu painel
  2. Clique em "Conectar via Webhook"
  3. Digite sua URL de webhook (deve ser HTTPS)
  4. Opcionalmente adicione headers personalizados para autenticação (ex. chaves de API)
  5. Teste o webhook e salve

Payload do Webhook:

{
  "id": 456,
  "title": "Your Post Title",
  "content": "<p>Full HTML content with embedded images...</p>",
  "content_markdown": "## Full Markdown source of the same post...",
  "meta_description": "SEO meta description (max 160 chars)",
  "slug": "your-post-title",
  "keywords": ["keyword1", "keyword2", "keyword3"],
  "status": "published",
  "featured_image_url": "https://storage.example.com/featured-image.jpg",
  "images": [
    {
      "url": "https://storage.example.com/image-1.jpg",
      "alt_text": "Description of first image",
      "position": 0,
      "caption": "Optional caption for image"
    },
    {
      "url": "https://storage.example.com/image-2.jpg",
      "alt_text": "Description of second image",
      "position": 1,
      "caption": null
    }
  ],
  "images_count": 2,
  "scheduled_for": "2025-11-10T14:00:00Z",
  "ai_model_used": "gpt5_mini",
  "created_at": "2025-11-06T10:30:00Z",
  "updated_at": "2025-11-06T10:30:00Z"
}
Entendendo o Array de Imagens:
  • images - Array de todas as imagens geradas para esta postagem (pode estar vazio)
  • images_count - Número total de imagens (0 se nenhuma imagem foi gerada)
  • featured_image_url - Imagem destacada principal (mesma que a primeira imagem no array)
  • Cada objeto de imagem contém: url, alt_text, position, caption
  • As imagens já estão incorporadas no HTML do conteúdo com marcação adequada

Resposta Esperada:

Seu endpoint de webhook deve retornar um código de status HTTP 200-299 para confirmar o recebimento bem-sucedido. Exemplo:

{
  "success": true,
  "post_id": "12345",
  "url": "https://yourblog.com/posts/post-slug"
}

Dica: Use headers personalizados para passar tokens de autenticação, chaves de API ou qualquer metadado que sua plataforma requer. Os headers são enviados com cada requisição de webhook.

Casos de Uso:

  • CMS Headless: Receba posts em qualquer CMS headless por meio de um endpoint que você cria e hospeda
  • CMS Personalizado: Integre com seu sistema de gerenciamento de conteúdo proprietário
  • Geradores de Sites Estáticos: Faça o seu receptor de webhook commitar o post ou disparar o build do seu site
  • Fluxos de Trabalho Personalizados: Aponte suas próprias ferramentas de automação para o webhook; você cria e mantém o lado que recebe

Referência da API

O BlogFlux.ai fornece uma API REST abrangente para desenvolvedores que desejam integrar geração de conteúdo com IA em suas aplicações. Nossa API suporta todos os recursos principais disponíveis na interface web.

Documentação Interativa:

Acesse nossa documentação de API completa e interativa construída com Swagger/OpenAPI:

Ver Documentação da API

Obtendo Sua Chave de API:

Todas as requisições à API exigem autenticação com uma chave de API. Siga estes passos para gerar a sua chave de API:

  1. Faça login na sua conta - Você deve estar conectado para gerar chaves de API
  2. Navegue até Chaves de API - Clique no menu do seu perfil (canto superior direito) e selecione "Chaves de API", ou clique aqui para ir diretamente
  3. Gere uma nova chave - Clique no botão "Gerar Nova Chave de API"
  4. Copie sua chave imediatamente - A chave de API completa é mostrada apenas uma vez. Copie-a e armazene-a com segurança
  5. Use em suas requisições - Inclua a chave no cabeçalho Authorization de todas as requisições da API

Autenticação:

Inclua sua chave de API no cabeçalho Authorization de cada requisição usando o formato Bearer token:

Authorization: Bearer YOUR_API_KEY
Melhores Práticas de Segurança:
  • Nunca faça commit de chaves de API em repositórios públicos ou controle de versão
  • Armazene chaves em variáveis de ambiente ou sistemas seguros de gerenciamento de segredos
  • Rotacione chaves regularmente e revogue chaves não utilizadas imediatamente
  • Use chaves diferentes para os ambientes de desenvolvimento, homologação e produção
  • Monitore o uso da sua API no painel para atividades suspeitas
Gerenciando Chaves de API:

Você pode gerenciar suas chaves de API a qualquer momento a partir da página de Chaves de API:

  • Visualizar todas as chaves de API ativas
  • Gerar novas chaves (até 5 chaves ativas por conta)
  • Revogar chaves comprometidas ou não utilizadas instantaneamente
  • Ver quando cada chave foi criada e usada pela última vez

Endpoints Principais:

POST /api/v1/posts

Gerar uma nova postagem de blog com IA

GET /api/v1/posts

Listar todas as postagens geradas

GET /api/v1/posts/:id

Obter uma postagem específica por ID

POST /api/v1/posts/:id/publish

Publicar uma postagem no site WordPress conectado ou webhook

GET /api/v1/blog_connections

Listar todas as conexões de blog (WordPress e webhooks)

GET /api/v1/user

Obter informações e limites do usuário atual

Exemplo de Requisição:

curl -X POST https://blogflux.ai/api/v1/posts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "AI Content Generation Best Practices",
    "keywords": ["AI writing", "SEO", "content marketing"],
    "tone": "professional",
    "word_count": 1500,
    "blog_connection_id": 123
  }'

Exemplo de Resposta:

{
  "status": "success",
  "data": {
    "post": {
      "id": 456,
      "title": "AI Content Generation Best Practices: A Complete Guide",
      "content": "<p>Full HTML content...</p>",
      "meta_description": "Learn the best practices...",
      "keywords": ["AI writing", "SEO", "content marketing"],
      "status": "draft",
      "word_count": 1523,
      "created_at": "2025-11-01T22:00:00Z"
    }
  }
}

Boas Práticas

1. Forneça Tópicos Específicos

Quanto mais específico seu tópico, melhor a IA pode gerar conteúdo relevante. Em vez de "marketing", use "estratégias de email marketing para empresas SaaS".

2. Use Palavras-chave Direcionadas

Inclua 3-5 palavras-chave focadas que correspondam à intenção de busca. A IA irá incorporá-las naturalmente mantendo a legibilidade.

3. Revise Antes de Publicar

Embora o conteúdo gerado por IA seja de alta qualidade, sempre revise para voz da marca, precisão e adicione insights pessoais antes de publicar.

4. Otimize a Contagem de Palavras

Para SEO, mire em 1.500-2.500 palavras para conteúdo pilar e 800-1.200 palavras para artigos de suporte.

5. Use Publicação Agendada

Planeje seu calendário de conteúdo com antecedência e use a publicação agendada para manter consistência sem intervenção manual.

Solução de Problemas

Conexão WordPress Falhou

Problema: "Autenticação falhou" ao conectar ao WordPress.

Solução:

  • Certifique-se de estar usando uma Senha de Aplicativo (não sua senha regular)
  • Verifique se a API REST do WordPress está habilitada (está ativada por padrão)
  • Verifique se a URL do seu site WordPress está correta (inclua https://)
  • Desabilite quaisquer plugins de segurança que possam bloquear o acesso à API REST

Webhook Não Está Recebendo Postagens

Problema: Endpoint de webhook não está recebendo dados de postagem.

Solução:

  • Certifique-se de que sua URL de webhook é HTTPS (HTTP não é suportado por segurança)
  • Verifique se seu endpoint retorna um código de status 200-299
  • Verifique se as regras de firewall não estão bloqueando os endereços IP do BlogFlux.ai
  • Use o botão "Testar Conexão" para depurar o webhook

Limite Mensal Atingido

Problema: Erro "Limite mensal de postagens atingido".

Solução:

  • Faça upgrade para um plano de nível superior para mais postagens por mês
  • Aguarde até que seu ciclo de cobrança seja reiniciado (mostrado nas Configurações da Conta)
  • Entre em contato com o suporte para limites personalizados Enterprise

Limitação de Taxa da API

Problema: Recebendo erros 429 "Muitas Requisições".

Solução:

  • Implemente backoff exponencial em suas chamadas de API
  • Respeite os limites de taxa: 60 requisições/minuto para Pro, 120/minuto para Enterprise
  • Use webhooks em vez de polling para atualizações de status

Não Encontrou o Que Procura?

Nossa equipe de suporte está aqui para ajudar. Navegue pelo centro de ajuda ou entre em contato diretamente.

Preferências de Cookies

Usamos cookies para melhorar sua experiência de navegação, analisar o tráfego do site e personalizar o conteúdo. Ao clicar em "Aceitar Todos", você concorda com o nosso uso de cookies. Saiba mais