| Typ | Spustí se, když |
|---|---|
schedule | Odpovídá výraz cron. |
heartbeat | Uplyne interval, volitelně v rámci denního okna. |
event | Je vyslána událost s odpovídajícím zdrojem. |
watch | Sledovač pluginu zapíše řádek výstupu. |
folder | Ve složce se změní soubory. |
manual | Spustí ho vlastník nebo zaměstnanec. |
call | Zazvoní telefonní linka. Jen ve stromech telefonních hovorů. |
schedule
{ "type": "schedule", "cron": "0 8 * * 1-5", "schedule": "Weekdays at 8:00" } cron je pětipolový výraz cron: minuta, hodina, den v měsíci, měsíc, den v týdnu. schedule je volitelný popis pro lidi. Plány běží v místním časovém pásmu bota. Nebo plány kontroluje každých pět sekund. Spuštění zmeškané v době, kdy byl bot vypnutý, se jednou dožene, pokud je zpoždění kratší než hodina. Spuštění se přeskočí, dokud ještě probíhá předchozí běh.
heartbeat
{ "type": "heartbeat", "interval": "30m", "window": "08:00-18:00" } interval je doba, například 30m, 1h nebo 2h30m. window, HH:MM-HH:MM, drží spuštění v pracovní době. Další spuštění je poslední spuštění plus interval, posunuté do okna; první proběhne jeden interval po načtení pracovního postupu. Časovače přetrvají restarty. Spuštění se přeskočí, dokud ještě probíhá předchozí běh, a neplatný interval se nespustí nikdy.
event
{ "type": "event", "sources": ["support-coordinator.summary.ready", "assignment.*"] } sources obsahuje seznam názvů událostí, které se mají shodovat přesně, nebo se zástupným znakem .* na konci. Prázdný seznam je chyba, kvůli které se odmítne celý agent.json. Běh dostane _event_source, _event_payload a _event_origin. Jak vznikají názvy, popisuje stránka Události.
watch
{ "type": "watch", "plugin": "mail", "event": "email.new" } Sledování udržuje spuštěný proces pluginu a pro každý řádek, který zapíše, spustí běh. Každý řádek přichází jako _watch_payload. Stejné řádky během deseti minut se zahodí.
| Pole | Výchozí | Význam |
|---|---|---|
plugin | povinné | Schopnost, například mail, nebo slug pluginu. Schopnost uveďte vždy, když se nějaká hodí. |
event | žádné | Událost ze seznamu events pluginu. Nebo použije příkaz této události a každý řádek navíc vysílá jako <plugin>.<event>. |
command | žádné | Argumenty, které sledovač spouštějí. Použijí se, pokud jsou nastaveny; jinak se převezmou z event. |
restart_delay_secs | 5 | Prodleva před restartem sledovače, který skončil. |
Schopnost se převede na nainstalovaný plugin, který ji poskytuje, přičemž přednost má plugin, na kterém má tento zaměstnanec účet. Pokud takový plugin neexistuje, pracovní postup se označí jako s omezenou funkčností a vlastník se dozví, co má připojit. Sledovač, který opakovaně padá, se restartuje s prodlevou, která se zdvojnásobuje až na 300 sekund a vynuluje se po 30 sekundách bezchybného běhu.
{ "type": "watch", "plugin": "notes-sync", "command": "watch --notebook {{notebook}} --format ndjson" } {{key}} v command se vyplní z odpovědí vlastníka na vstupy zaměstnance. Pokud zástupný symbol nemá odpověď, sledování se nespustí.
folder
{ "type": "folder", "path": "{{inbox_folder}}", "extensions": ["pdf"], "recursive": false } | Pole | Výchozí | Význam |
|---|---|---|
path | povinné | Absolutní cesta ke složce. {{key}} se doplní ze vstupů. |
extensions | všechny soubory | Přípony souborů, které se mají shodovat, bez tečky. |
recursive | true | Zahrnout podsložky. |
debounce_secs | 2 | Změny v tomto časovém okně se spojí do jednoho běhu. |
Běh dostane změněné cesty v _watch_payload.files.
manual
{ "type": "manual" } Ruční pracovní postup běží, jen když ho spustí vlastník nebo když zaměstnanec zavolá run_workflow. Tímto způsobem lze spustit i každý jiný pracovní postup, ať má jakýkoli spouštěč.
call
{"type": "call", "line": "..."} je platné pouze v pracovním postupu typu "type": "call_tree", který nastavuje, jak zaměstnanec odpovídá na telefonní lince. Prázdné line platí pro každou linku, kterou zaměstnanec obsluhuje a která nemá konkrétnější strom. Strom hovoru musí mít právě jeden pozdrav a alespoň jeden pojmenovaný záměr.
Webhooky
Vlastník může pro zaměstnance vytvořit také webhook. Webhook navázaný na pracovní postup tento postup spustí; webhook bez pracovního postupu doručí svou datovou část do chatu zaměstnance.