Pravidla
Co se děje s poštou při jejím příchodu.
Nástroje pro pravidla
| Nástroj | Co dělá |
|---|---|
| listRules | Každé pravidlo na aktivním připojení, v pořadí, v jakém se vyhodnocují, s tím, co každé dělá a jak často se spustilo. |
| getRule | Jedno pravidlo v plném rozsahu: jeho podmínky, jeho akce a zda je zapnuté. |
| createRule | Napíše pravidlo: podmínky nad přicházející zprávou a co se má stát s čímkoli, co jim odpovídá. Pravidlo se vytvoří VYPNUTÉ. |
| testRule | Které ze zpráv za posledních třicet dní by pravidlo zachytilo a co by s nimi udělalo. Nic nemění. |
| setRuleEnabled | Zapne nebo vypne jedno pravidlo, jakmile si jej člověk přečte. |
createRule zapisuje pravidlo VYPNUTÉ, což je jediné místo, kde se tento server záměrně liší od REST API. POST /rules má ve výchozím stavu zapnuto. Pravidlo, které archivuje, vyhazuje do koše nebo přeposílá poštu, by s tím nemělo začít jen na základě zprávy v chatu: napište jej, zavolejte testRule, abyste člověku, pro kterého pracujete, ukázali, které z jeho vlastních zpráv by zachytilo, a teprve pak si řekněte o setRuleEnabled.
Není tu žádné updateRule, žádné deleteRule ani změna pořadí, ze stejného důvodu, proč tu není mazání šablon: to jsou operace, které z okna chatu rozbijí cizí nastavení. Smazané pravidlo nelze obnovit a změna pořadí tiše změní, co se stane s každou budoucí zprávou. Všechny tři jsou v Nastavení → Pravidla a v REST API, kde kliká člověk.
Pravidla patří PŘIPOJENÍ, takže tyto nástroje působí na tu schránku, kterou naposledy pojmenoval setActiveConnection, a pravidlo, které napsal kolega, je jedním z nich. Schránka pojme 100 pravidel, každé s nejvýše 20 podmínkami a 10 akcemi.
Nic tady nepůsobí zpětně. Pravidlo rozhoduje o tom, co se stane s poštou, která dorazí po jeho zapnutí; neprochází už existující schránku a testRule pouze hlásí, nic netřídí.