Automations (mini-n8n natif)

Schéma Déclencheur → Condition → Action

Trigger (event, scheduled, ou webhook)
  ↓
Condition (logic AND/OR, avec rules sur user.*, event.*)
  ↓
Action (une ou plusieurs, exécutées séquentiellement)

Déclencheurs (3 types)

1. event

Déclenché par des événements de la plateforme via emitAutomationEvent() dans after().

{ "type": "event", "config": { "eventName": "lesson_completed", "filters": {} } }

Les 21 événements pris en charge : lesson_completed, module_completed, course_completed, quiz_submitted, assignment_submitted, enrollment_created, enrollment_completed, forum_post_created, forum_reply_created, grade_posted, announcement_created, live_class_scheduled, live_class_started, student_inactive, tag_added_to_user, tag_removed_from_user, webhook_received, scheduled_trigger, ainsi que les événements de gamification badge_earned, level_up, contest_ended.

2. scheduled

Basé sur le cron.

{
  "type": "scheduled",
  "config": {
    "mode": "interval|daily|weekly|cron",
    "hours": 24,
    "time": "08:00",
    "timezone": "America/Sao_Paulo"
  }
}

Traité par GET /api/cron/automations (CRON_SECRET).

3. webhook

Point de terminaison public authentifié par un token hexadécimal de 64 caractères.

URL: /api/automations/webhook/[token]
GET  → health check
POST → déclenche l'automation (le body JSON devient event.data)

Conditions

{
  "logic": "and",
  "rules": [
    { "field": "user.role", "operator": "eq", "value": "student" },
    { "field": "event.score", "operator": "gte", "value": 80 }
  ]
}

Opérateurs : eq, neq, gt, gte, lt, lte, contains, not_contains, in, not_in.

Champs accessibles :

• user.* — id, name, email, role, tags
• event.* — champs de l'événement (courseId, score, lessonTitle, etc.)

Les groupes imbriqués (AND/OR) sont pris en charge.

Actions (9 types)

Interpolation de gabarit

Les chaînes dans les actions prennent en charge les {{placeholders}} :

• {{user.name}}, {{user.email}}, {{user.role}}
• {{event.courseId}}, {{event.score}}, {{event.lessonTitle}}

Sécurité

• Isolation des tenants : toutes les requêtes filtrent par tenantId. L'automation d'un tenant n'est JAMAIS exécutée pour un utilisateur d'un autre tenant.
• Prévention SSRF : url-validator.ts bloque les IPs privées, localhost, les endpoints de métadonnées (169.254.169.254). IPv4 + IPv6.
• Timeout HTTP : 10s via AbortController.
• Token webhook : hexadécimal 64 caractères, renouvelable.
• Profondeur de chaîne : max 5 niveaux de trigger_automation récursif.
• Rate limit : maxRunsPerHour/maxRunsPerDay par automation (Redis INCR, fallback DB count).

Exemple : notifier un parent quand son enfant mineur est inactif depuis 5 jours

{
  "name": "Alerte inactivité — mineurs",
  "trigger": {
    "type": "event",
    "config": { "eventName": "student_inactive" }
  },
  "conditions": {
    "logic": "and",
    "rules": [
      { "field": "user.role", "operator": "eq", "value": "student" },
      { "field": "user.isMinor", "operator": "eq", "value": true },
      { "field": "event.inactiveDays", "operator": "gte", "value": 5 }
    ]
  },
  "actions": [
    {
      "type": "send_notification",
      "config": {
        "recipient": "users_with_tag",
        "tag": "parent_of_{{user.id}}",
        "title": "{{user.name}} inactif depuis {{event.inactiveDays}} jours",
        "message": "Nous vous encourageons à vous connecter. Accédez à [lien]."
      }
    }
  ]
}

Interface utilisateur

/institution/automations :

• Liste avec filtres (statut, type de déclencheur), bascule, recherche
• Assistant en 4 étapes (Déclencheur → Conditions → Actions → Récapitulatif)
• Historique des exécutions avec lignes extensibles (statut, durée, actionResults JSON)

Voir aussi

• Vue d'ensemble de la plateforme