Funkcia Requesto

Automatické e-mailové pripomienky — cron endpoint, nie plug-and-play

Automatické e-mailové pripomienky v Requesto fungujú cez pripravený cron endpoint, ktorý kontroluje požiadavky s nastaveným due_date. Deň pred termínom odošle pripomienku, po termíne upozorní na oneskorenie a môže požiadavku označiť ako expired. Dôležité: v produkcii musíte sami nakonfigurovať Vercel Cron — po registrácii pripomienky nebežia samy.

Manuálne pripomienky zaberajú čas a klient ich ľahko ignoruje

Keď termín na podklady prejde, väčšina firiem píše individuálne e-maily. Pri desiatkach klientov je to opakujúca sa práca a ľahko prehliadnete, komu ste už pripomienku poslali. Bez systému sa pripomienky miešajú s bežnou komunikáciou.

Requesto má logiku pripomienok implementovanú v /api/cron/reminders — endpoint hľadá požiadavky so stavom sent alebo in_progress a porovnáva due_date. Pred termínom odošle reminderBeforeDueEmail, po termíne reminderOverdueEmail a regeneruje verejný token v e-maile.

Buďme presní: táto funkcia nie je zapnutá automaticky po vytvorení účtu. Potrebujete nastaviť Vercel Cron (alebo iný plánovač), ktorý endpoint volá s hlavičkou Authorization: Bearer CRON_SECRET. Bez tohto kroku pripomienky neodídu.

Pre koho je to určené

  • Účtovníci s mesačnými termínmi na doklady
  • Poradcovia sledujúci deadliny hypoték a úverov
  • Tímy, ktoré chcú znížiť manuálne urgovanie klientov
  • Firmy s technickou kapacitou nastaviť cron na Vercel

Príklady z praxe

Pripomienka deň pred termínom mesačných dokladov

Účtovník nastaví due_date na 15. deň. Cron 14. dňa odošle klientovi e-mail s odkazom a dátumom termínu.

Urgovanie po prekročení deadlinu

Po termíne endpoint odošle overdue e-mail a požiadavku môže označiť ako expired. Klient dostane nový token na doplnenie.

Kombinácia s prehľadom chýbajúcich položiek

E-mail smeruje na verejný odkaz, kde klient vidí, ktoré položky majú stav missing. Pripomienka nie je vágne „pošlite doklady“.

Odporúčaný postup

  1. Nastavte termín splnenia pri požiadavke

    Pole due_date je podmienka pre zaradenie do cron logiky. Bez termínu systém požiadavku do pripomienok nezaradí.

  2. Nakonfigurujte CRON_SECRET v prostredí

    Premenná CRON_SECRET chráni endpoint pred neoprávneným volaním. Bez nej cron vráti 401 Unauthorized.

  3. Nastavte Vercel Cron v projekte

    V vercel.json alebo dashboarde Vercel naplánujte GET volanie na /api/cron/reminders podľa potreby — typicky raz denne.

  4. Klient dostane e-mail s aktuálnym odkazom

    Pred odoslaním pripomienky sa regeneruje token. E-mail obsahuje funkčný odkaz na /request/{token}, nie starý neplatný link.

Najčastejšie chyby

  • Očakávanie automatických pripomienok bez cronu

    Endpoint existuje, ale sám sa nespúšťa. Bez plánovača na hostingu pripomienky neodídu — to nie je bug, ale zámer MVP.

  • Zabudnutie e-mailu klienta

    Cron preskočí požiadavky, kde klient nemá vyplnený e-mail. Bez kontaktu v zázname klienta notifikáciu neodošle.

  • Nastavenie termínu bez kontroly stavu položiek

    Pripomienka ide aj keď chýba jedna položka. Skontrolujte prehľad missing v dashboarde pred uzavretím požiadavky.

Ako to rieši Requesto

Pripravená logika pred a po termíne

Dva e-mailové šablóny — reminderBeforeDueEmail a reminderOverdueEmail — pokrývajú bežné scenáre urgencie.

Regenerácia tokenu v pripomienke

Klient v e-maile vždy dostane aktuálny odkaz. Nemusíte manuálne kopírovať nový link z dashboardu.

Automatické označenie expired

Po overdue pripomienke môže systém nastaviť stav požiadavky na expired — jasný signál, že termín prešiel.

Často kladené otázky

Fungujú pripomienky hneď po registrácii?

Nie úplne automaticky. Endpoint je pripravený, ale musíte ho spúšťať cez Vercel Cron alebo ekvivalent s CRON_SECRET. Bez tohto kroku sa pripomienky neodosielajú.

Kedy sa odošle pripomienka pred termínom?

Cron hľadá požiadavky s due_date rovným zajtrajšku. Pri dennom spúšťaní cronu teda klient dostane e-mail jeden deň vopred.

Čo sa stane po prekročení termínu?

Odošle sa overdue e-mail s novým tokenom. Požiadavka v stave sent alebo in_progress môže prejsť na expired.

Potrebujem mať klienta s e-mailom?

Áno. Cron iteruje požiadavky a preskočí tie, kde clients.email chýba. Bez e-mailu nie je komu pripomienku doručiť.

Môžem pripomienky spúšťať ručne?

Áno. Môžete zavolať GET /api/cron/reminders s platnou Authorization hlavičkou — napríklad pri testovaní pred nasadením cronu.

Čím sa líši od /automaticke-pripomienky-klientom?

Produktová stránka predstavuje celú schopnosť pripomínať klientom. Táto feature stránka detailne vysvetľuje cron endpoint a nutnosť Vercel konfigurácie.

Posiela Requesto SMS pripomienky?

Nie. V MVP sú pripomienky len e-mailové. Telefónne číslo klienta môžete evidovať, ale na pripomienky sa nepoužíva.

Súvisiace stránky

Pripravte sa na automatické pripomienky

Vytvorte zoznam požadovaných dokumentov, odošlite klientovi bezpečný odkaz a sledujte, čo ešte chýba — bez nekonečných e-mailov.