| Type | S’exécute quand |
|---|---|
schedule | Une expression cron correspond. |
heartbeat | Un intervalle s’écoule, éventuellement dans une plage horaire quotidienne. |
event | Un événement dont la source correspond est émis. |
watch | Un observateur de plugin écrit une ligne de sortie. |
folder | Des fichiers changent dans un dossier. |
manual | Le propriétaire ou un employé le lance. |
call | Une ligne téléphonique sonne. Uniquement dans les arborescences d’appels téléphoniques. |
schedule
{ "type": "schedule", "cron": "0 8 * * 1-5", "schedule": "Weekdays at 8:00" } cron est une expression cron à cinq champs : minute, heure, jour du mois, mois, jour de la semaine. schedule est une description facultative destinée aux personnes. Les planifications s'exécutent dans le fuseau horaire local du bot. Nebo vérifie les planifications toutes les cinq secondes. Un déclenchement manqué pendant que le bot était éteint est rattrapé une fois s'il a moins d'une heure de retard. Un déclenchement est ignoré tant que l'exécution précédente est en cours.
heartbeat
{ "type": "heartbeat", "interval": "30m", "window": "08:00-18:00" } interval est une durée comme 30m, 1h ou 2h30m. window, au format HH:MM-HH:MM, maintient les déclenchements dans les heures de travail. Le déclenchement suivant correspond au dernier plus l'intervalle, ramené dans la plage ; le premier a lieu un intervalle après le chargement du workflow. Les minuteurs survivent aux redémarrages. Un déclenchement est ignoré tant que l'exécution précédente est en cours, et un intervalle invalide ne se déclenche jamais.
event
{ "type": "event", "sources": ["support-coordinator.summary.ready", "assignment.*"] } sources liste les noms d'événements à faire correspondre exactement, ou avec un joker .* final. Une liste vide est une erreur qui fait rejeter tout le fichier agent.json. L'exécution reçoit _event_source, _event_payload et _event_origin. Voir Événements pour savoir comment sont formés les noms.
watch
{ "type": "watch", "plugin": "mail", "event": "email.new" } Un watch maintient un processus de plugin en cours d'exécution et lance une exécution pour chaque ligne qu'il écrit. Chaque ligne arrive dans _watch_payload. Les lignes identiques en moins de dix minutes sont écartées.
| Champ | Par défaut | Signification |
|---|---|---|
plugin | obligatoire | Une capacité, comme mail, ou le slug d’un plugin. Indiquez une capacité chaque fois qu’il y en a une qui convient. |
event | aucun | Un événement de la liste events du plugin. Nebo utilise la commande de cet événement et émet aussi chaque ligne sous la forme <plugin>.<event>. |
command | aucun | Arguments qui démarrent l’observateur. Utilisés s’ils sont définis ; sinon repris de event. |
restart_delay_secs | 5 | Attente avant de relancer un observateur qui s’arrête. |
Une capacité correspond au plugin installé qui la fournit, de préférence celui sur lequel cet employé a un compte. Sans plugin de ce type, le workflow est marqué comme dégradé et le propriétaire est informé de ce qu'il faut connecter. Un observateur qui plante à répétition redémarre avec un délai qui double jusqu'à 300 secondes et se réinitialise après 30 secondes de fonctionnement.
{ "type": "watch", "plugin": "notes-sync", "command": "watch --notebook {{notebook}} --format ndjson" } {{key}} dans command est rempli à partir des réponses du propriétaire aux entrées de l'employé. Si un espace réservé n'a pas de réponse, la surveillance ne démarre pas.
folder
{ "type": "folder", "path": "{{inbox_folder}}", "extensions": ["pdf"], "recursive": false } | Champ | Par défaut | Signification |
|---|---|---|
path | obligatoire | Chemin absolu du dossier. {{key}} est rempli à partir des entrées. |
extensions | tous les fichiers | Extensions de fichier à faire correspondre, sans le point. |
recursive | true | Inclure les sous-dossiers. |
debounce_secs | 2 | Les changements survenus dans cet intervalle donnent une seule exécution. |
L'exécution reçoit les chemins modifiés dans _watch_payload.files.
manual
{ "type": "manual" } Un workflow manuel ne s'exécute que lorsque le propriétaire le lance ou qu'un employé appelle run_workflow. Tout workflow, quel que soit son déclencheur, peut aussi être lancé de cette façon.
call
{"type": "call", "line": "..."} n'est valide que dans un workflow de "type": "call_tree", qui définit la façon dont un employé répond sur une ligne téléphonique. Un line vide s'applique à toutes les lignes auxquelles l'employé répond et qui n'ont pas d'arbre plus spécifique. Un arbre d'appel doit avoir exactement un message d'accueil et au moins une intention nommée.
Webhooks
Le propriétaire peut aussi créer un webhook pour un employé. Un webhook lié à un workflow exécute ce workflow ; un webhook sans workflow transmet sa charge utile à la discussion de l'employé.