betool betool

Documentation

Planification (cron)

Déclencher un pipeline à intervalles réguliers — quotidien, hebdomadaire, ou expression cron arbitraire.

Planification (cron)

Le canal schedule déclenche un pipeline selon un calendrier défini. C'est l'équivalent d'un cron, mais piloté depuis l'admin et journalisé comme tous les autres exchanges.

Pourquoi ce canal

Tous les pipelines ne sont pas réactifs (à un email, un appel, un webhook). Beaucoup sont proactifs : rapport quotidien, relance hebdomadaire, vérification horaire d'un système externe. C'est ce que couvre le canal schedule.

Configuration

  1. Administration → Planification → Nouvelle tâche.
  2. Choisissez :
    • Pipeline cible
    • Calendrier — expression cron classique (0 8 * * 1-5 = 8h en semaine) ou raccourci (@daily, @hourly)
    • Fuseau horaire — par défaut, fuseau de l'organisation. Configurable par tâche.
    • Payload statique — JSON arbitraire passé en entrée du pipeline

Un même pipeline peut être déclenché par plusieurs tâches planifiées avec des payloads différents. Utile pour le templating (ex. « relance clients FR » + « relance clients DE » via le même pipeline avec un paramètre langue).

Ce que le pipeline reçoit

À chaque déclenchement, un exchange est créé avec :

  • schedule.task_id — identifiant de la tâche planifiée
  • schedule.scheduled_at — horodatage prévu
  • schedule.actual_at — horodatage réel (en cas de drift)
  • schedule.payload — le JSON statique configuré (si présent)

Tolérance & rattrapage

Si betool est indisponible au moment d'un déclenchement (maintenance, incident), la tâche est rattrapée automatiquement au redémarrage, dans la fenêtre de tolérance que vous configurez (par défaut 1 heure).

Au-delà de la fenêtre, le déclenchement est noté comme manqué dans l'historique et n'est pas rejoué — mieux vaut un rapport manquant qu'un rapport tardif et désynchronisé.

Cas d'usage typiques

  • Rapport quotidien 8h — agent qui interroge plusieurs systèmes, synthétise et envoie un brief par email.
  • Sync horaire — pipeline qui pull les nouveaux items d'un système externe, les passe à un agent classifier, et pousse les résultats dans votre CRM.
  • Vérification hebdomadaire — agent qui audite l'état d'une infrastructure et signale les écarts.
  • Relance J+7 — sur les leads soumis il y a une semaine et toujours sans réponse.

Bonnes pratiques

  • Évitez les démarrages de minute pile — beaucoup de systèmes pulsent à 0 * * * *. Préférez 7 * * * * pour répartir la charge.
  • Loggez les tâches qui n'ont rien à faire. Une tâche qui s'exécute mais ne fait rien (parce qu'aucun item à traiter) doit le tracer explicitement. Sinon, vous ne saurez pas distinguer « tout va bien » de « la tâche ne s'exécute plus ».
  • Alertez sur les tâches manquées. Voir Crédits & metering → Alertes.