Configurer l'intégration WordPress + Shopify

Écrire des articles dans le AI Content Editor puis les copier manuellement dans le CMS ? Inutile. Rankion dispose d'intégrations natives pour WordPress et Shopify : vous déposez le token une fois, ensuite vous poussez les articles d'un clic (ou d'un appel API) directement — en brouillon ou en ligne.

WordPress : configurer un Application Password

WordPress (à partir de 5.6) propose les Application Passwords dans son cœur. Voici comment en créer un :

1. Admin WP → Utilisateurs → Profil
2. Faire défiler jusqu'à Mots de passe d'application
3. Nom : Rankion, puis Ajouter un nouveau mot de passe d'application
4. Vous obtenez un token de 24 caractères du type xxxx xxxx xxxx xxxx xxxx xxxx — copiez-le immédiatement, il ne sera plus affiché

Dans Rankion : Settings → Integrations → Ajouter WordPress. Saisissez :

• URL du site : https://votre-blog.fr
• Nom d'utilisateur : votre nom d'utilisateur WP
• Application Password : le token que vous venez de générer

Cliquez sur le bouton de test. Si vert : c'est bon. Si rouge, regardez la section dépannage ci-dessous.

Note : la création d'une intégration CMS passe actuellement exclusivement par l'UI (Settings → Integrations). Un endpoint dédié POST /api/v1/integrations n'est pas (à ce jour) publiquement disponible. Une fois l'intégration créée, vous pouvez la référencer via cms_integration_id dans POST /api/v1/articles/{article_id}/publish — voir la section suivante.

Shopify : Admin API access token

Shopify nécessite une Custom App :

1. Shopify Admin → Settings → Apps and sales channels → Develop apps
2. Create an app → Nom : Rankion Publisher
3. Configure Admin API scopes → au minimum : write_content, read_content, write_files, read_files
4. Install app → vous obtenez un Admin API access token

À saisir dans Rankion sous Settings → Integrations → Shopify :

• Domaine de la boutique : votre-boutique.myshopify.com
• Token Admin API : le token que vous venez de générer

Flux de publication

Une fois l'intégration en place, vous avez un bouton Publish dans l'éditeur. Via l'API :

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

status est draft ou publish. Recommandation : d'abord en draft, puis revue finale dans le CMS, puis mise en ligne.

Important : si une publication est déjà en vol (par exemple parce qu'un appel précédent est bloqué), vous recevez un HTTP 409 Conflict. Attendez simplement (15 à 30 secondes), puis réessayez — Rankion sérialise les publications par article pour éviter les doublons.

Image à la une

Si votre article a une image héroïque générée (depuis le AI Content Editor), elle est automatiquement téléversée à la publication comme image à la une — sur WordPress comme image d'article, sur Shopify comme image d'article.

Si vous ne voulez pas cela, mettez "featured_image": false dans le corps de la requête de publication.

Dépannage

Échec d'authentification (401 / 403)

• WordPress : Application Password copié correctement avec les espaces ? Certaines installations WP acceptent les deux variantes (avec/sans espaces), d'autres non — essayez les deux.
• WordPress : API REST accessible ? Test : curl https://votre-blog.fr/wp-json/wp/v2/posts doit renvoyer du JSON. Si 404 → ressauvegardez les permaliens (Settings → Permalinks → Save).
• Shopify : le token de l'app a-t-il vraiment le scope write_content ?

Échec de l'upload d'image

• WordPress : l'utilisateur a besoin de la capability upload_files. Standard pour Editor / Admin, restreint pour Author.
• Shopify : oublié le scope write_files ? Réinstallez la Custom App.
• Les deux : une image à la une > 8 Mo est rejetée — Rankion compresse en amont, mais en cas de limites serveur très restrictives, vérifiez quand même.

La publication reste bloquée sur « processing »

Au bout de 5 minutes : relancez les jobs (dans l'UI via le menu d'actions → « Retry Publish ») ou contactez le support.

Documentation complète de l'éditeur dans AI Content Editor, référence API pour les articles sous API Articles.