| Typ | Spustí sa, keď |
|---|---|
schedule | Zhoduje sa výraz cron. |
heartbeat | Uplynie interval, voliteľne v rámci denného okna. |
event | Vyšle sa udalosť so zhodným zdrojom. |
watch | Sledovač doplnku zapíše riadok výstupu. |
folder | Zmenia sa súbory v priečinku. |
manual | Spustí ho vlastník alebo zamestnanec. |
call | Zazvoní telefónna linka. Iba v stromoch telefonických hovorov. |
schedule
{ "type": "schedule", "cron": "0 8 * * 1-5", "schedule": "Weekdays at 8:00" } cron je päťpoľový výraz cron: minúta, hodina, deň v mesiaci, mesiac, deň v týždni. schedule je voliteľný popis pre ľudí. Plány bežia v miestnom časovom pásme bota. Nebo kontroluje plány každých päť sekúnd. Spustenie zmeškané, kým bol bot vypnutý, sa raz dobehne, ak mešká menej ako hodinu. Spustenie sa preskočí, kým ešte beží predchádzajúci beh.
heartbeat
{ "type": "heartbeat", "interval": "30m", "window": "08:00-18:00" } interval je úsek ako 30m, 1h alebo 2h30m. window v tvare HH:MM-HH:MM drží spustenia v pracovnom čase. Ďalšie spustenie je posledné spustenie plus interval, posunuté do okna; prvé nastane jeden interval po načítaní pracovného postupu. Časovače prežijú reštarty. Spustenie sa preskočí, kým ešte beží predchádzajúci beh, a neplatný interval sa nikdy nespustí.
event
{ "type": "event", "sources": ["support-coordinator.summary.ready", "assignment.*"] } sources uvádza názvy udalostí, ktoré sa majú zhodovať presne alebo so zástupným .* na konci. Prázdny zoznam je chyba, kvôli ktorej sa odmietne celý agent.json. Beh dostane _event_source, _event_payload a _event_origin. Ako vznikajú názvy, opisuje stránka Udalosti.
watch
{ "type": "watch", "plugin": "mail", "event": "email.new" } Sledovanie udržiava spustený proces doplnku a pre každý riadok, ktorý zapíše, spustí beh. Každý riadok príde ako _watch_payload. Rovnaké riadky v priebehu desiatich minút sa zahodia.
| Pole | Predvolené | Význam |
|---|---|---|
plugin | povinné | Schopnosť, napríklad mail, alebo slug doplnku. Uveďte schopnosť vždy, keď niektorá zodpovedá. |
event | žiadne | Udalosť zo zoznamu events doplnku. Nebo použije príkaz tejto udalosti a zároveň vysiela každý riadok ako <plugin>.<event>. |
command | žiadne | Argumenty, ktoré spúšťajú sledovač. Použijú sa, ak sú nastavené; inak sa prevezmú z event. |
restart_delay_secs | 5 | Čakanie pred reštartom sledovača, ktorý skončil. |
Schopnosť sa priradí nainštalovanému doplnku, ktorý ju poskytuje, prednostne takému, v ktorom má tento zamestnanec účet. Ak taký doplnok nie je, pracovný postup sa označí ako obmedzený a vlastník sa dozvie, čo má pripojiť. Sledovač, ktorý opakovane padá, sa reštartuje s oneskorením, ktoré sa zdvojnásobuje až na 300 sekúnd a vynuluje sa po 30 sekundách prevádzky.
{ "type": "watch", "plugin": "notes-sync", "command": "watch --notebook {{notebook}} --format ndjson" } {{key}} v command sa vypĺňa z odpovedí vlastníka na vstupy zamestnanca. Ak zástupný symbol nemá odpoveď, sledovanie sa nespustí.
folder
{ "type": "folder", "path": "{{inbox_folder}}", "extensions": ["pdf"], "recursive": false } | Pole | Predvolené | Význam |
|---|---|---|
path | povinné | Absolútna cesta k priečinku. {{key}} sa vyplní zo vstupov. |
extensions | všetky súbory | Prípony súborov na porovnanie, bez bodky. |
recursive | true | Zahrnúť podpriečinky. |
debounce_secs | 2 | Zmeny v tomto okne sa spoja do jedného behu. |
Beh dostane zmenené cesty v _watch_payload.files.
manual
{ "type": "manual" } Ručný pracovný postup sa spustí, iba keď ho spustí vlastník alebo keď zamestnanec zavolá run_workflow. Týmto spôsobom sa dá spustiť aj každý iný pracovný postup bez ohľadu na spúšťač.
call
{"type": "call", "line": "..."} je platné len v pracovnom postupe typu "type": "call_tree", ktorý nastavuje, ako zamestnanec odpovedá na telefónnej linke. Prázdne line platí pre každú linku, na ktorej zamestnanec odpovedá a ktorá nemá konkrétnejší strom. Strom hovoru musí mať presne jeden pozdrav a aspoň jeden pomenovaný zámer.
Webhooky
Vlastník môže pre zamestnanca vytvoriť aj webhook. Webhook naviazaný na pracovný postup spustí tento pracovný postup; webhook bez pracovného postupu doručí svoj obsah do chatu zamestnanca.