Alerty a upozornění: e-mail a vlastní automatizace

Alerty, neboli upozornění ze zvonečku, vám pomohou zachytit důležité situace ve FAPI. Například když je potřeba prověřit platbu nebo se nepodařilo odeslat e-mail.

Nemusíte je již sledovat jen ve zvonečku: nové alerty si můžete posílat e-mailem nebo je předat do vlastního systému přes webhook.

Zde je celý videonávod:

E-mail se hodí pro lidské zpracování.

Webhook využijte, pokud chcete alerty zpracovávat ve vlastním workflow, například v Make, nebo ve své aplikaci.

Oba způsoby doručování můžete používat samostatně i současně.

Jak zapnout e-mailová upozornění

Přihlaste se do svého účtu FAPI.
Otevřete Nastavení → Notifikace a reporty.
Na této stránce přejděte do sekce Alerty a upozornění. Nejde o samostatnou podzáložku.
Do pole Cílová e-mailová adresa zadejte adresu, na kterou mají upozornění chodit.
Klikněte na Uložit nastavení.

Od uložení budou na zadanou adresu chodit nově vzniklé alerty daného účtu. Starší upozornění se zpětně neposílají.

Co obsahuje e-mail

Upozornění přichází z adresy alert@fapi.cz . Obsahuje českou a anglickou verzi textu, identifikaci účtu FAPI a odkaz zpět do nastavení. Podle těchto údajů snadno poznáte, kterého účtu se zpráva týká, i když jich spravujete více.

Jak předávat alerty do vlastní automatizace

Ve svém automatizačním nástroji nebo vlastním systému připravte webhook, který umí přijmout požadavek POST s daty JSON. Pro komunikaci doporučujeme HTTPS.
Ve FAPI otevřete Nastavení → Notifikace a reporty → Alerty a upozornění.
Do pole Webhooková URL vložte adresu svého webhooku.
Klikněte na Uložit nastavení.

FAPI od této chvíle předává nově vzniklé alerty na zadanou adresu. Nastavení webhooku samo o sobě nezapne AI ani automatickou opravu: pravidla, filtrování, schvalování a navazující akce nastavujete ve svém systému.

Pozor: v tomto nastavení ve FAPI nevybíráte jednotlivé typy událostí ani priority. Pokud chcete zpracovávat jen některé alerty, nastavte filtr ve svém workflow. Při použití e-mailu můžete využít pravidla své schránky.

Příklad vlastního workflow

Například alert o nespárované platbě může vaše workflow předat do úkolovacího systému:

Rozpozná typ alertu a ověří, zda stejný alert už nezpracovalo.
Načte dostupný detail platby a případně související faktury.
Nechá AI připravit stručné shrnutí a návrh dalšího postupu.
Vytvoří úkol pro odpovědného člověka, který rozhodne o dalším kroku.

Člověk tak dostane potřebný kontext i návrh postupu, ale samotný alert nemění stav platby ani faktury.

Bezpečný postup při novém odeslání e-mailu k faktuře

Pokud se e-mail k faktuře nepodaří odeslat, může vaše vlastní workflow po odstranění příčiny a kontrole historie komunikace připravit jedno nové odeslání přes veřejné API. Použijte k němu předem schválenou šablonu a konkrétní oprávnění k odeslání.

Nové odeslání není univerzálním zopakováním původní zprávy a úspěšná odpověď API sama nepotvrzuje doručení do schránky zákazníka. U nejasného výsledku, vrácené zprávy nebo spamové stížnosti případ předejte člověku místo dalšího automatického opakování.

Jak upozornění vypnout

Na stránce Notifikace a reporty vymažte obsah pole Cílová e-mailová adresa nebo Webhooková URL a klikněte na Uložit nastavení. Chcete-li vypnout oba kanály, vyprázdněte obě pole.

Odkaz v e-mailovém alertu pouze otevře nastavení. Upozornění nevypne bez přihlášení do správného účtu a uložení změny.

Časté otázky

Zůstanou upozornění ve zvonečku?

Ano. E-mailové a webhookové doručování je doplněk. Jeho vypnutí nemění upozornění ve zvonečku v administraci.

Může stejné upozornění přijít vícekrát?

Ano. Ve vlastním workflow proto ukládejte zpracovaná ID alertů, aby opakované doručení nezaložilo stejný úkol ani nespustilo stejnou akci podruhé.

Proč mi upozornění nepřišlo?

Ověřte, že jste nastavení uložili ve správném účtu, zadali správnou adresu a očekávaný alert vznikl až po uložení. U e-mailu zkontrolujte také spam. U webhooku musí váš systém data převzít a potvrdit úspěšnou odpovědí HTTP 2xx. Případné selhání doručování hledejte i mezi upozorněními v administraci.

Jak se alerty liší od globálních webhooků?

Alerty a upozornění slouží k předávání nově vzniklých alertů. Globální webhooky jsou samostatné nastavení pro jiné události související s fakturami. Pro jejich nastavení použijte článek Globální webhooky.

Bezpečnost a práce s daty

Alerty mohou obsahovat údaje o účtu a souvisejících obchodních událostech. Předávejte je jen důvěryhodným příjemcům a systémům. AI posílejte pouze údaje nezbytné k řešení a přístupové údaje nikdy nevkládejte do alertu, webhookové adresy ani promptu. U změn plateb, faktur nebo komunikace se zákazníky nastavte odpovídající oprávnění a podle svých pravidel i lidské schválení.