Attendre et planifier

Deux façons de faire agir un Blueprint plus tard : attendre au milieu d'un flow, ou planifier son départ.

Attendre

Le node Attendre (famille Logique) met en pause la suite de sa branche : pendant une durée, ou jusqu'à une date. Supprimer un avertissement après 10 secondes, retirer un rôle temporaire après 7 jours, expulser un nouveau membre qui ne s'est pas vérifié en 10 minutes, rappeler quelque chose dans 2 heures.

Durée ou date

• Pendant une durée : un nombre et une unité (secondes, minutes, heures, jours).
• Jusqu'à une date : une date, ou une formule qui en donne une, comme add(now(), 7, "days") ou une Variable Date. Une date déjà passée continue tout de suite.

Une attente dure 30 jours au plus. Sa sortie resumeAt dit quand la suite reprend.

Seule sa branche attend

Les autres branches n'attendent pas. Après « Commande /giveaway », avec deux liens :

1. Attendre 24 heures, puis tirer le gagnant ;
2. Répondre « Giveaway lancé ! ».

La réponse part tout de suite ; le tirage a lieu le lendemain. La suite reprend comme une exécution à part, marquée Suite dans la section Exécutions.

Ce qu'il faut savoir

• Les données restent celles du départ : après l'attente, le pseudo d'un membre ou le contenu d'un message sont ceux du moment où l'Event est arrivé. Pour une valeur à jour, relis-la après l'attente (« Lire un membre », « Lire un message »). Une Action sur quelque chose qui a disparu entre-temps (un membre parti, un salon supprimé) prend sa sortie Échec.
• Répondre après une attente : Discord accepte une réponse à une interaction pendant 15 minutes. Une réponse après une attente plus longue est refusée par la validation ; après une date calculée, l'éditeur t'avertit, et si le délai est dépassé la réponse prend sa sortie Échec. Pour plus tard, envoie plutôt un message dans le salon. Afficher un modal après une attente est impossible : un modal doit être la première réponse.
• Déployer une nouvelle version ne change rien aux attentes en cours : elles reprennent sur la version qui les a lancées.
• Mettre en pause ou supprimer le Blueprint annule ses attentes ; la confirmation dit combien. Un Blueprint suspendu les garde, et elles reprennent avec lui.
• 500 attentes au plus par serveur : au-delà, Attendre prend sa sortie Échec.

Suivre et annuler

En tête de la section Exécutions de l'éditeur, les attentes en cours, les plus proches d'abord, avec l'heure de reprise. Chacune peut être annulée : ce qui la suit ne s'exécutera pas. Annuler une attente du Blueprint déployé demande la permission de déployer.

En test

Une attente pendant un test tourne comme en production. Le bouton Passer l'attente de la section Test la fait reprendre tout de suite : pas besoin d'attendre 24 heures pour voir la suite. Une session « une fois par Event » ne se termine pas tant qu'une attente n'a pas repris, et arrêter la session annule celles qui restent.

Planifier

L'Event Planifié démarre une exécution selon un horaire, sans rien côté Discord : une annonce chaque lundi, un salon « Membres : 1 245 » tenu à jour, un ménage chaque nuit.

• Toutes les… 10, 15, 20 ou 30 minutes, ou 1, 2, 3, 4, 6, 8 ou 12 heures. Calé sur la journée : toutes les 15 minutes part à :00, :15, :30 et :45.
• Chaque jour, certains jours de la semaine ou chaque mois, à l'heure choisie. Un mois sans le jour choisi (le 31) part son dernier jour.
• Fuseau horaire : prérempli avec le tien, et les changements d'heure sont suivis. Une heure qui n'existe pas (le passage à l'heure d'été) part à la première minute qui existe ; une heure qui existe deux fois part une seule fois.

Le panneau affiche les trois prochaines exécutions. Ses sorties : scheduledAt, l'heure prévue, et firedAt, l'heure réelle de départ (quelques secondes plus tard au plus).

• Personne n'agit : après un Event planifié, répondre à une interaction est impossible, et une Variable « par membre » doit dire de quel membre.
• Bot arrêté à l'heure prévue : l'exécution part à son retour si le retard est de moins d'une heure, une seule fois ; au-delà, elle est sautée.
• 25 Events planifiés au plus par serveur, tous Blueprints confondus.
• Pause : un Blueprint en pause ou suspendu ne lance plus ses Events planifiés ; à la reprise, ils repartent à leur prochaine heure.
• En test : un Event planifié du brouillon ne part jamais seul pendant la session. Le bouton Déclencher maintenant de la section Test le lance. Le Blueprint déployé continue de tourner normalement.