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 : tu déposes le token une fois, ensuite tu pousses 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. Tu obtiens un token de 24 caractères du type xxxx xxxx xxxx xxxx xxxx xxxx — copie-le immédiatement, il ne sera plus affiché

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

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

Clique sur le bouton de test. Si vert : c'est bon. Si rouge, regarde 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, tu peux 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 → tu obtiens un Admin API access token

À saisir dans Rankion sous Settings → Integrations → Shopify :

• Domaine de la boutique : ta-boutique.myshopify.com
• Token Admin API : le token que tu viens de générer

Flux de publication

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

curl -X POST https://rankion.ai/api/v1/articles/{article_id}/publish \
  -H "Authorization: Bearer TON_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é), tu reçois un HTTP 409 Conflict. Attends simplement (15 à 30 secondes), puis réessaie — Rankion sérialise les publications par article pour éviter les doublons.

Image à la une

Si ton 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 tu ne veux pas cela, mets "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 — essaye les deux.
• WordPress : API REST accessible ? Test : curl https://ton-blog.fr/wp-json/wp/v2/posts doit renvoyer du JSON. Si 404 → ressauvegarde 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éinstalle 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érifie quand même.

La publication reste bloquée sur « processing »

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

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