Configurar la integración con WordPress + Shopify

¿Escribir artículos en el AI Content Editor y luego copiarlos a mano al CMS? Innecesario. Rankion tiene integraciones nativas para WordPress y Shopify: guardas el token una vez y, a partir de ahí, empujas artículos con un clic (o una llamada API) directamente — como borrador o en vivo.

WordPress: configurar Application-Password

WordPress (a partir de 5.6) tiene Application-Passwords en el core. Así creas uno:

1. WP-Admin → Usuarios → Perfil
2. Baja hasta Contraseñas de aplicación
3. Nombre: Rankion, después Añadir nueva contraseña de aplicación
4. Recibirás un token de 24 caracteres tipo xxxx xxxx xxxx xxxx xxxx xxxx — cópialo de inmediato, no se vuelve a mostrar

En Rankion: Settings → Integrations → Añadir WordPress. Introduce:

• URL del sitio: https://tu-blog.com
• Username: tu nombre de usuario de WP
• Application-Password: el token recién generado

Pulsa el botón Test. Si está verde: funciona. Si está rojo, mira el troubleshooting al final.

Aviso: la creación de una integración de CMS se hace actualmente solo a través de la UI (Settings → Integrations). Un endpoint dedicado POST /api/v1/integrations para el setup todavía no está públicamente disponible (a fecha de hoy). Una vez creada la integración, puedes referenciarla por cms_integration_id en POST /api/v1/articles/{article_id}/publish — consulta la siguiente sección.

Shopify: Admin-API-Access-Token

Shopify necesita una Custom App:

1. Shopify Admin → Settings → Apps and sales channels → Develop apps
2. Create an app → Nombre: Rankion Publisher
3. Configure Admin API scopes → al menos: write_content, read_content, write_files, read_files
4. Install app → recibirás un Admin API access token

En Rankion, regístralo en Settings → Integrations → Shopify:

• Dominio del shop: tu-shop.myshopify.com
• Admin-API-Token: el token recién generado

Flujo de publicación

En cuanto la integración está activa, tienes en el editor un botón Publicar. Vía API:

curl -X POST https://rankion.ai/api/v1/articles/{article_id}/publish \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "cms_integration_id": 42,
    "status": "draft"
  }'

status es draft o publish. Recomendación: primero como draft, luego revisión final en el CMS, después live.

Importante: si ya hay un publish en vuelo (p. ej. porque una llamada anterior está colgada), recibirás HTTP 409 Conflict. Espera un poco (15–30 segundos) y reintenta — Rankion serializa los publishes por artículo para que no recibas duplicados.

Imagen destacada

Si tu artículo tiene una imagen hero generada (desde el AI Content Editor), se sube automáticamente como Featured Image en el publish — en WordPress como imagen destacada del post, en Shopify como Article Image.

Si no la quieres, pon "featured_image": false en el body del publish.

Troubleshooting

Fallo de auth (401 / 403)

• WordPress: ¿has copiado el Application-Password con espacios? Algunos setups de WP aceptan ambas variantes (con o sin espacios), otros no — prueba las dos.
• WordPress: ¿la REST API es accesible? Test: curl https://tu-blog.com/wp-json/wp/v2/posts debe devolver JSON. Si da 404 → vuelve a guardar los permalinks (Settings → Permalinks → Save).
• Shopify: ¿el token de la app tiene realmente scope write_content?

Fallo de subida de imagen

• WordPress: el usuario necesita la capability upload_files. Estándar para Editor / Admin, restringido para Author.
• Shopify: ¿olvidaste el scope write_files? Reinstala la Custom App.
• Ambos: feature image > 8 MB se rechaza — Rankion comprime previamente, pero ante límites muy restrictivos del servidor conviene comprobarlo igualmente.

Publish se queda colgado en «processing»

Tras 5 minutos: reinicia los jobs (en la UI vía Action-Menu → «Retry Publish») o contacta con soporte.

Documentación completa del editor en AI Content Editor, referencia de API para Articles en API de Artículos.