WordPress + Shopify-Integration einrichten

Artikel im AI Content Editor schreiben und dann manuell ins CMS kopieren? Unnötig. Rankion hat native Integrationen für WordPress und Shopify: einmal Token hinterlegen, danach pusht du Artikel mit einem Klick (oder einem API-Call) direkt rüber — als Draft oder live.

WordPress: Application-Password einrichten

WordPress (ab 5.6) hat Application-Passwords im Core. So legst du eins an:

1. WP-Admin → Benutzer → Profil
2. Runterscrollen zu Anwendungspasswörter
3. Name: Rankion, dann Neues Anwendungspasswort hinzufügen
4. Du bekommst einen 24-stelligen Token wie xxxx xxxx xxxx xxxx xxxx xxxx — sofort kopieren, wird nicht nochmal angezeigt

In Rankion: Settings → Integrations → WordPress hinzufügen. Trag ein:

• Site-URL: https://dein-blog.de
• Username: dein WP-Username
• Application-Password: der eben erzeugte Token

Test-Button drücken. Wenn grün: läuft. Wenn rot, schau im Troubleshooting unten.

Hinweis: Das Anlegen einer CMS-Integration läuft aktuell ausschließlich über das UI (Settings → Integrations). Ein dedizierter POST /api/v1/integrations Setup-Endpoint ist (Stand jetzt) noch nicht öffentlich verfügbar. Sobald die Integration angelegt ist, kannst du sie per cms_integration_id in POST /api/v1/articles/{article_id}/publish referenzieren — siehe nächster Abschnitt.

Shopify: Admin-API-Access-Token

Shopify braucht eine Custom App:

1. Shopify Admin → Settings → Apps and sales channels → Develop apps
2. Create an app → Name: Rankion Publisher
3. Configure Admin API scopes → mindestens: write_content, read_content, write_files, read_files
4. Install app → du bekommst einen Admin API access token

In Rankion eintragen unter Settings → Integrations → Shopify:

• Shop-Domain: dein-shop.myshopify.com
• Admin-API-Token: das eben erzeugte Token

Publish-Flow

Sobald die Integration steht, hast du im Editor einen Publish-Button. Per API:

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

status ist draft oder publish. Empfehlung: erstmal als draft, dann im CMS final reviewen, dann live schalten.

Wichtig: Wenn ein Publish bereits in flight ist (z.B. weil ein vorheriger Call hängt), bekommst du HTTP 409 Conflict zurück. Einfach kurz warten (15–30 Sekunden), dann nochmal — Rankion serialisiert Publishes pro Artikel, damit du keine Duplikate bekommst.

Featured Image

Wenn dein Artikel ein generiertes Hero-Bild hat (aus dem AI Content Editor), wird es beim Publish automatisch als Featured Image mit hochgeladen — bei WordPress als Beitragsbild, bei Shopify als Article-Image.

Wenn du das nicht willst, setz "featured_image": false im Publish-Body.

Troubleshooting

Auth-Fail (401 / 403)

• WordPress: Application-Password korrekt mit Leerzeichen kopiert? Manche WP-Setups akzeptieren beide Varianten (mit/ohne Leerzeichen), manche nicht — beide ausprobieren.
• WordPress: REST-API erreichbar? Test: curl https://dein-blog.de/wp-json/wp/v2/posts muss JSON liefern. Wenn 404 → Permalinks neu speichern (Settings → Permalinks → Save).
• Shopify: Hat der App-Token wirklich write_content Scope?

Image-Upload-Fail

• WordPress: Der User braucht upload_files Capability. Standard für Editor / Admin, eingeschränkt für Author.
• Shopify: write_files Scope vergessen? Custom App neu installieren.
• Beide: Feature-Image > 8 MB wird abgelehnt — Rankion komprimiert vorher, aber bei sehr restriktiven Server-Limits trotzdem prüfen.

Publish bleibt auf „processing" hängen

Nach 5 Minuten: Jobs neu starten (im UI über Action-Menu → „Retry Publish") oder Support kontaktieren.

Volle Editor-Doku in AI Content Editor, API-Referenz für Articles unter Artikel-API.