Automation (Triggers, Pipelines, Webhooks)

Automation in Rankion bündelt drei Werkzeuge: Bulk-Generations (eine Liste Keywords → eine Liste Artikel), Autopilot (Module auf Cron-Schedule laufen lassen, z. B. „jeden Montag AVI-Tracking") und Pipelines (mehrstufige Workflows mit benannten Stages, z. B. Generate → Humanize → Detect → Optimize → Publish). Dazu kommen Webhooks für externe Systeme (Reviews-Quellen, später CMS-Sync). Pflicht-Modul für alle, die mehr als gelegentlich publishen — denn manuelle Klicks skalieren nicht.

Was es kann

• Bulk-Generations — Liste von Keywords reinkippen, Rankion generiert daraus N Artikel im Hintergrund.
• Autopilot — periodische Module-Runs: Frequency (daily, weekly, monthly), Module (tracking, audit, freshness...), pro Trigger eigenes Config-Object.
• Pipelines — benannte Workflows mit stages[]. Jede Stage ist ein Modul-Call mit Inputs aus der vorigen. Fail einer Stage stoppt die Pipeline; Retry-Endpoint nimmt sie ab dem Fail-Punkt wieder auf.
• Async + persistent — alle Runs laufen als Queue Jobs (siehe ARCHITEKTUR-REGEL: Long-Running Processes in CLAUDE.md), Status liegt in der DB, UI zeigt live Progress.
• Webhooks (extern) — externe Systeme können in Rankion reinposten, z. B. Reviews-Aggregatoren via /webhooks/reviews/{source} (public, key-auth).
• Webhooks (raus) — Pipeline-Stages können externe URLs anfeuern, etwa um deinem CMS einen neuen Artikel mitzuteilen.

Wann nutzen

• Du publishst regelmäßig 10+ Artikel/Woche und manuelles Generate→Optimize→Publish kostet zu viel Klick-Zeit.
• Du willst dein AVI/Audit-Tracking automatisch jeden Montag laufen lassen, ohne dass du dran denken musst.
• Du baust eine echte „Content-Factory" — Keyword-Liste rein, fertig publizierte Artikel raus.
• Du integrierst Rankion in eine größere Stack (Make, Zapier, eigene Backends) und brauchst Webhook-Triggers.

Workflow

1. Bulk-Run starten — POST /bulk-generations mit {project_id, keywords[]}. Status GET /bulk-generations/{id}.
2. Autopilot konfigurieren — POST /autopilot mit {module, frequency, config}. Cron läuft serverseitig (Laravel Scheduler, jede Minute getaktet).
3. Pipeline definieren — POST /pipelines mit Name + Stages-Array. Jede Stage: module, params, optional on_fail.
4. Pipeline ausführen — durch ein Trigger-Event (z. B. Bulk-Generation completed) oder manuell. Run bekommt eigene ID, jedes Stage-Update streamt in die UI.
5. Retry bei Fail — POST /pipelines/{id}/retry setzt vom letzten erfolgreichen Stage neu an.

API

Body von POST /pipelines:

{
  "name": "Generate-Humanize-Publish",
  "stages": [
    {"module": "ai-content-editor", "action": "generate", "params": {"length": "medium"}},
    {"module": "humanizer",         "action": "humanize", "params": {"level": "medium"}},
    {"module": "ai-detector",       "action": "detect",   "params": {"max_score": 40}},
    {"module": "content-optimizer", "action": "analyze"},
    {"module": "publish",           "action": "send_to_blog", "params": {"blog_id": 12}}
  ]
}

Body von POST /autopilot:

{
  "module": "ai-visibility-tracking",
  "frequency": "weekly",
  "config": {"day": "monday", "hour": 6}
}

Credits & Limits

• Bulk-Generation: 15 Credits Base + Standard-Generate-Kosten pro Artikel.
• Pipeline Setup: 20 Credits einmalig pro neu erstellter Pipeline.
• Pipeline Run: kein Base-Cost — gezahlt werden die Stages (jede Stage kostet ihre normalen Modul-Credits).
• Autopilot: kein Setup-Cost; jede ausgeführte Run kostet die normalen Modul-Credits.
• Async-Pflicht: alle Operationen >10 s laufen als Queue Job (Supervisor rankion-worker, 2 Prozesse). Bei Worker-Stillstand: supervisorctl restart rankion-worker:*.
• Retry-Limit: 3 automatische Retries pro Stage, dann manuell via /pipelines/{id}/retry.

Verwandte Module

• Webhooks API — die Webhook-Endpoints in der API-Referenz.
• AI Content Editor — häufigste Pipeline-Stage (Generate, Score, Publish).
• Humanizer — als Stage in „qualitätsgesicherter Pipeline" ein Klassiker.
• AI-Detector — natürlicher Quality-Gate vor dem Publish-Step.
• Action Center — Pipelines können bei bestimmten Events automatisch Action-Items erzeugen.
• Agentic Chat — Pipelines können auch via Master-Agent in natürlicher Sprache angetriggert werden.