Automation (Triggers, Pipelines, Webhooks)

L'Automation dans Rankion regroupe trois outils : Bulk-Generations (une liste de mots-clés → une liste d'articles), Autopilot (faire tourner les modules sur un schedule cron, par ex. « chaque lundi AVI Tracking ») et Pipelines (workflows multi-étapes avec stages nommées, par ex. Generate → Humanize → Detect → Optimize → Publish). S'y ajoutent les webhooks pour systèmes externes (sources de reviews, plus tard sync CMS). Module obligatoire pour quiconque publie plus qu'occasionnellement — car les clics manuels ne scalent pas.

Ce qu'il peut faire

• Bulk-Generations — verser une liste de mots-clés, Rankion génère N articles à partir en background.
• Autopilot — runs périodiques de modules : Frequency (daily, weekly, monthly), Module (tracking, audit, freshness...), config-object propre par trigger.
• Pipelines — workflows nommés avec stages[]. Chaque stage est un module-call avec inputs de la précédente. Le fail d'une stage stoppe la pipeline ; l'endpoint retry la reprend au point de fail.
• Async + persistant — tous les runs tournent en queue jobs (voir ARCHITEKTUR-REGEL: Long-Running Processes dans CLAUDE.md), le statut est en DB, l'UI montre la progression live.
• Webhooks (entrants) — les systèmes externes peuvent poster vers Rankion, par ex. les agrégateurs de reviews via /webhooks/reviews/{source} (public, key-auth).
• Webhooks (sortants) — les stages de pipeline peuvent appeler des URLs externes, par exemple pour notifier ton CMS d'un nouvel article.

Quand l'utiliser

• Tu publies régulièrement 10+ articles/semaine et un Generate→Optimize→Publish manuel coûte trop de temps de clic.
• Tu veux que ton tracking AVI/audit tourne automatiquement chaque lundi sans y penser.
• Tu construis une vraie « content factory » — liste de mots-clés en entrée, articles publiés en sortie.
• Tu intègres Rankion dans un stack plus large (Make, Zapier, backends propres) et tu as besoin de triggers webhook.

Workflow

1. Lancer un bulk-run — POST /bulk-generations avec {project_id, keywords[]}. Statut GET /bulk-generations/{id}.
2. Configurer Autopilot — POST /autopilot avec {module, frequency, config}. Le cron tourne côté serveur (Laravel Scheduler, cadencé chaque minute).
3. Définir une pipeline — POST /pipelines avec nom + array de stages. Chaque stage : module, params, optionnel on_fail.
4. Exécuter la pipeline — par un trigger event (par ex. bulk-generation completed) ou manuellement. Le run reçoit son propre ID, chaque update de stage stream dans l'UI.
5. Retry en cas de fail — POST /pipelines/{id}/retry repart de la dernière stage réussie.

API

Body de 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 de POST /autopilot :

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

Crédits et limites

• Bulk-Generation : 15 crédits de base + coûts standard de Generate par article.
• Pipeline Setup : 20 crédits une fois par pipeline nouvellement créée.
• Pipeline Run : pas de coût de base — payés sont les stages (chaque stage coûte ses crédits module normaux).
• Autopilot : pas de setup-cost ; chaque run exécuté coûte les crédits modules normaux.
• Async obligatoire : toutes les opérations >10 s tournent en queue job (Supervisor rankion-worker, 2 processus). En cas de standstill du worker : supervisorctl restart rankion-worker:*.
• Limite de retry : 3 retries automatiques par stage, puis manuellement via /pipelines/{id}/retry.

Modules associés

• API Webhooks — les endpoints webhook dans la référence API.
• AI Content Editor — stage de pipeline la plus fréquente (Generate, Score, Publish).
• Humanizer — comme stage dans une « pipeline qualité » c'est un classique.
• AI-Detector — quality gate naturel avant l'étape Publish.
• Action Center — les pipelines peuvent automatiquement créer des action items sur certains événements.
• Agentic Chat — les pipelines peuvent aussi être déclenchées via l'agent maître en langage naturel.