Automation (Triggers, Pipelines, Webhooks)

Automation en Rankion agrupa tres herramientas: Bulk-Generations (una lista de keywords → una lista de artículos), Autopilot (ejecuta módulos en cron-schedule, p.ej. «cada lunes AVI-Tracking») y Pipelines (workflows multi-stage con stages nombradas, p.ej. Generate → Humanize → Detect → Optimize → Publish). Además vienen webhooks para sistemas externos (fuentes de reviews, más adelante CMS-Sync). Módulo obligatorio para quien publique más que ocasionalmente — los clics manuales no escalan.

Qué puede hacer

• Bulk-Generations — vuelca una lista de keywords, Rankion genera N artículos en background.
• Autopilot — runs periódicos de módulos: frecuencia (daily, weekly, monthly), módulo (tracking, audit, freshness...), config-object propio por trigger.
• Pipelines — workflows nombrados con stages[]. Cada stage es una llamada a módulo con inputs de la anterior. El fail de una stage detiene la pipeline; el endpoint de retry la reanuda desde el punto del fallo.
• Async + persistente — todos los runs corren como Queue Jobs (ver ARCHITEKTUR-REGEL: Long-Running Processes en CLAUDE.md), el status vive en la DB, la UI muestra progreso live.
• Webhooks (entrantes) — sistemas externos pueden postear hacia Rankion, p.ej. agregadores de reviews vía /webhooks/reviews/{source} (público, key-auth).
• Webhooks (salientes) — las stages de pipeline pueden disparar URLs externas, p.ej. para notificar a tu CMS un nuevo artículo.

Cuándo usarlo

• Publicas regularmente 10+ artículos/semana y los Generate→Optimize→Publish manuales cuestan demasiado tiempo de clic.
• Quieres que tu AVI/Audit-Tracking corra solo cada lunes sin que tengas que acordarte.
• Construyes una verdadera «content factory» — entra una lista de keywords, salen artículos publicados.
• Integras Rankion en un stack más grande (Make, Zapier, backends propios) y necesitas webhook-triggers.

Workflow

1. Inicia un bulk-run — POST /bulk-generations con {project_id, keywords[]}. Status GET /bulk-generations/{id}.
2. Configura Autopilot — POST /autopilot con {module, frequency, config}. El cron corre del lado del servidor (Laravel Scheduler, tickeado cada minuto).
3. Define la pipeline — POST /pipelines con name + array de stages. Cada stage: module, params, opcional on_fail.
4. Ejecuta la pipeline — vía un trigger-event (p.ej. bulk-generation completed) o manualmente. El run recibe ID propio, cada stage-update se streamea a la UI.
5. Retry tras fallo — POST /pipelines/{id}/retry continúa desde la última stage exitosa.

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éditos y límites

• Bulk-Generation: 15 créditos base + coste estándar de Generate por artículo.
• Pipeline Setup: 20 créditos una sola vez al crear cada nueva pipeline.
• Pipeline Run: sin coste base — se pagan las stages (cada stage cuesta sus créditos normales del módulo).
• Autopilot: sin coste de setup; cada run ejecutado cuesta los créditos normales del módulo.
• Obligatoriedad async: todas las operaciones >10 s corren como Queue Job (Supervisor rankion-worker, 2 procesos). Si el worker se detiene: supervisorctl restart rankion-worker:*.
• Límite de retry: 3 retries automáticos por stage, después manual vía /pipelines/{id}/retry.

Módulos relacionados

• Webhooks API — los endpoints webhook en la referencia API.
• AI Content Editor — la stage más frecuente en pipelines (Generate, Score, Publish).
• Humanizer — un clásico como stage en «pipeline con quality assurance».
• AI-Detector — quality-gate natural antes del paso publish.
• Action Center — las pipelines pueden generar action-items automáticamente al producirse ciertos eventos.
• Agentic Chat — las pipelines también pueden dispararse vía master agent en lenguaje natural.