Documentación

Todo lo que necesitas saber sobre cómo usar BlogFlux.ai para automatizar tu creación de contenido.

Primeros Pasos

1. Crea Tu Cuenta

Regístrate para una prueba gratuita de 14 días. Obtendrás acceso instantáneo a todas las funciones.

Regístrate Ahora →

2. Configura Tus Preferencias

Elige tu modelo de IA preferido (GPT-5 o Claude), establece el tono del contenido y configura las preferencias de SEO.

Ir al Panel →

3. Conecta Tu Blog

Conecta tu sitio WordPress o vincula cualquier CMS personalizado a través de webhooks. BlogFlux.ai soporta integración perfecta con WordPress y cualquier plataforma habilitada para HTTP.

4. Genera Tu Primera Publicación

Ingresa un tema, elige palabras clave y observa cómo BlogFlux.ai crea una publicación completa y optimizada para SEO en segundos.

Comenzar a Crear →

Integración WordPress

Conecta BlogFlux.ai a tu sitio WordPress usando la API REST nativa de WordPress. Nuestra integración maneja automáticamente la autenticación, creación de publicaciones y optimización de metadatos.

Pasos de Configuración:

  1. Navega a "Conexiones de Blog" en tu panel
  2. Haz clic en "Conectar Sitio WordPress"
  3. Ingresa la URL de tu sitio WordPress (ej. https://tublog.com)
  4. Proporciona tu nombre de usuario de WordPress y contraseña de aplicación
  5. Prueba la conexión y guarda

Nota: Necesitarás crear una Contraseña de Aplicación en WordPress (Usuarios → Perfil → Contraseñas de Aplicación) para autenticación segura.

Integración por webhook

Conecta BlogFlux.ai a cualquier CMS personalizado, plataforma headless o sistema habilitado para HTTP usando webhooks. Cuando se genera una publicación, BlogFlux.ai enviará una solicitud POST a tu URL de webhook con los datos completos de la publicación.

Pasos de Configuración:

  1. Navega a "Conexiones de Blog" en tu panel
  2. Haz clic en "Conectar vía Webhook"
  3. Ingresa tu URL de webhook (debe ser HTTPS)
  4. Opcionalmente agrega encabezados personalizados para autenticación (ej. claves de API)
  5. Prueba el webhook y guarda

Payload del 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"
}
Entendiendo el Array de Imágenes:
  • images - Array de todas las imágenes generadas para esta publicación (puede estar vacío)
  • images_count - Número total de imágenes (0 si no se generaron imágenes)
  • featured_image_url - Imagen destacada principal (misma que la primera imagen en el array)
  • Cada objeto de imagen contiene: url, alt_text, position, caption
  • Las imágenes ya están incrustadas en el HTML del contenido con el marcado adecuado

Respuesta Esperada:

Tu endpoint de webhook debe devolver un código de estado HTTP 200-299 para confirmar la recepción exitosa. Ejemplo:

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

Consejo: Usa encabezados personalizados para pasar tokens de autenticación, claves de API o cualquier metadato que tu plataforma requiera. Los encabezados se envían con cada solicitud de webhook.

Casos de Uso:

  • CMS Headless: Recibe publicaciones en cualquier CMS headless mediante un endpoint que tú creas y alojas
  • CMS Personalizado: Integra con tu sistema de gestión de contenido propietario
  • Generadores de Sitios Estáticos: Haz que tu receptor de webhook haga commit de la publicación o lance el build de tu sitio
  • Flujos de Trabajo Personalizados: Apunta tus propias herramientas de automatización al webhook; tú creas y mantienes el lado receptor

Referencia de la API

BlogFlux.ai proporciona una API REST completa para desarrolladores que desean integrar la generación de contenido con IA en sus aplicaciones. Nuestra API soporta todas las funciones principales disponibles en la interfaz web.

Documentación Interactiva:

Accede a nuestra documentación de API completa e interactiva construida con Swagger/OpenAPI:

Ver Documentación de la API

Obteniendo Tu Clave de API:

Todas las solicitudes a la API requieren autenticación con una clave de API. Sigue estos pasos para generar tu clave de API:

  1. Inicia sesión en tu cuenta - Debes estar conectado para generar claves de API
  2. Navega a Claves de API - Haz clic en el menú de tu perfil (esquina superior derecha) y selecciona "Claves de API", o haz clic aquí para ir directamente
  3. Genera una nueva clave - Haz clic en el botón "Generar Nueva Clave de API"
  4. Copia tu clave inmediatamente - La clave de API completa se muestra solo una vez. Cópiala y guárdala de forma segura
  5. Usa en tus solicitudes - Incluye la clave en el encabezado Authorization de todas las solicitudes de la API

Autenticación:

Incluye tu clave de API en el encabezado Authorization de cada solicitud usando el formato Bearer token:

Authorization: Bearer YOUR_API_KEY
Mejores Prácticas de Seguridad:
  • Nunca hagas commit de claves de API en repositorios públicos o control de versiones
  • Almacena claves en variables de entorno o sistemas seguros de gestión de secretos
  • Rota claves regularmente y revoca claves no utilizadas inmediatamente
  • Usa claves distintas para los entornos de desarrollo, preproducción y producción
  • Monitorea el uso de tu API en el panel para actividades sospechosas
Administrando Claves de API:

Puedes administrar tus claves de API en cualquier momento desde la página de Claves de API:

  • Ver todas las claves de API activas
  • Generar nuevas claves (hasta 5 claves activas por cuenta)
  • Revocar claves comprometidas o no utilizadas instantáneamente
  • Ver cuándo se creó y usó cada clave por última vez

Endpoints Principales:

POST /api/v1/posts

Generar una nueva publicación de blog con IA

GET /api/v1/posts

Listar todas las publicaciones generadas

GET /api/v1/posts/:id

Obtener una publicación específica por ID

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

Publicar una publicación en el sitio WordPress conectado o webhook

GET /api/v1/blog_connections

Listar todas las conexiones de blog (WordPress y webhooks)

GET /api/v1/user

Obtener información y límites del usuario actual

Ejemplo de Solicitud:

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
  }'

Ejemplo de Respuesta:

{
  "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"
    }
  }
}

Buenas Prácticas

1. Proporciona Temas Específicos

Cuanto más específico sea tu tema, mejor la IA puede generar contenido relevante. En lugar de "marketing", usa "estrategias de email marketing para empresas SaaS".

2. Usa Palabras Clave Dirigidas

Incluye 3-5 palabras clave enfocadas que coincidan con la intención de búsqueda. La IA las incorporará naturalmente manteniendo la legibilidad.

3. Revisa Antes de Publicar

Aunque el contenido generado por IA es de alta calidad, siempre revisa para la voz de marca, precisión y agrega insights personales antes de publicar.

4. Optimiza el Conteo de Palabras

Para SEO, apunta a 1.500-2.500 palabras para contenido pilar y 800-1.200 palabras para artículos de apoyo.

5. Usa Publicación Programada

Planifica tu calendario de contenido con anticipación y usa la publicación programada para mantener consistencia sin intervención manual.

Solución de Problemas

Conexión WordPress Falló

Problema: "Autenticación fallida" al conectar WordPress.

Solución:

  • Asegúrate de estar usando una Contraseña de Aplicación (no tu contraseña regular)
  • Verifica que la API REST de WordPress esté habilitada (está activa por defecto)
  • Verifica que la URL de tu sitio WordPress sea correcta (incluye https://)
  • Desactiva cualquier plugin de seguridad que pueda bloquear el acceso a la API REST

Webhook No Está Recibiendo Publicaciones

Problema: El endpoint del webhook no está recibiendo datos de publicaciones.

Solución:

  • Asegúrate de que tu URL de webhook sea HTTPS (HTTP no es soportado por seguridad)
  • Verifica que tu endpoint devuelva un código de estado 200-299
  • Verifica que las reglas de firewall no estén bloqueando las direcciones IP de BlogFlux.ai
  • Usa el botón "Probar Conexión" para depurar el webhook

Límite Mensual Alcanzado

Problema: Error "Límite mensual de publicaciones alcanzado".

Solución:

  • Actualiza a un plan de nivel superior para más publicaciones por mes
  • Espera hasta que tu ciclo de facturación se reinicie (mostrado en Configuración de Cuenta)
  • Contacta a soporte para límites personalizados Enterprise

Limitación de Tasa de la API

Problema: Recibiendo errores 429 "Demasiadas Solicitudes".

Solución:

  • Implementa backoff exponencial en tus llamadas a la API
  • Respeta los límites de tasa: 60 solicitudes/minuto para Pro, 120/minuto para Enterprise
  • Usa webhooks en lugar de polling para actualizaciones de estado

¿No Encuentras lo que Buscas?

Nuestro equipo de soporte está aquí para ayudar. Navega por el centro de ayuda o contáctanos directamente.

Preferencias de Cookies

Usamos cookies para mejorar tu experiencia de navegación, analizar el tráfico del sitio y personalizar el contenido. Al hacer clic en "Aceptar Todas", aceptas nuestro uso de cookies. Más información