E-mailové notifikace & Pozvánky
LockMyCal obsahuje robustní e-mailový systém postavený na knihovně Swoosh a asynchronních frontách Oban, což zajišťuje spolehlivé doručení i při výpadcích externích poštovních serverů díky automatickým opakováním (retries).
1. Typy odesílaných e-mailů
| Typ zprávy | Příjemce | Obsah zprávy |
|---|---|---|
| Potvrzení rezervace | Klient | Detaily schůzky, odkaz na videohovor, tlačítka Přidat do kalendáře a odkazy na přeplánování či storno. |
| Nová rezervace | Organizátor | Informace o klientovi, odpovědi z formuláře a platební status. |
| Připomínka | Klient i Organizátor | Upozornění před začátkem schůzky podle nastavení typu schůzky. |
| Změna termínu (Reschedule) | Klient i Organizátor | Oznámení o přesunu termínu na nový čas. |
| Žádost o přesunutí | Klient | Organizátor žádá o výběr nového termínu. |
| Zrušení schůzky (Cancellation) | Klient i Organizátor | Informace o stornu a případné refundaci. |
| Žádost o schválení | Organizátor | Výzva ke schválení či zamítnutí rezervace. |
| Výsledek žádosti | Klient | Oznámení, že rezervace byla schválena, zamítnuta nebo vypršela. |
| Vrácení platby | Klient | Potvrzení refundace placené schůzky. |
| Pozvánka a změna události | Hosté | Pozvánka pro další účastníky (i ti, které přidáte k existující rezervaci), poznámka organizátora a oznámení o změnách události. Při smazání události v kalendáři dostanou účastníci zrušení. |
| Odkazy e-mailem | Vybraní adresáti | Rezervační stránka nebo typy schůzek, které jim organizátor poslal. |
| Upozornění na integrace | Organizátor | Kalendář nebo video služba potřebuje znovu připojit, synchronizace selhává nebo se nepodařilo vytvořit video místnost. |
| Uzávěrka ankety | Organizátor | Připomínka blížícího se termínu uzávěrky hlasování. |
E-maily organizátorovi chodí v jazyce jeho účtu, e-maily klientovi v jazyce, ve kterém rezervoval. U schůzky vytvořené rychlým přidáním volí jazyk všech e-mailů o ní organizátor (Jazyk pozvánky).
2. Přílohy a iCalendar (.ics)
Přílohy od klienta: soubory, které klient přiložil při rezervaci, dostane organizátor v e-mailu o nové rezervaci a v žádosti o schválení. Přiloží se, pokud mají dohromady do 15 MB, jinak je v e-mailu odkaz na nástěnku. Klient své soubory v e-mailu nedostává.
Ke každému potvrzovacímu a storno e-mailu je automaticky přiložen standardizovaný soubor invite.ics:
- Kompatibilita: Apple Calendar, Google Calendar, Microsoft Outlook, Thunderbird.
- Aktualizace: Při přeplánování odešle LockMyCal
.icssoubor s vyšším číslem sekvence (SEQUENCE:1), takže se termín v kalendáři příjemce automaticky aktualizuje bez nutnosti ručního přepisování.
3. Konfigurace poštovního odesílatele
V souboru .env můžete přizpůsobit jméno a e-mail, pod kterým zprávy odcházejí:
EMAIL_FROM_ADDRESS="rezervace@vasedomena.cz"
EMAIL_FROM_NAME="LockMyCal Rezervace"Poskytovatele odesílání zvolíte proměnnou EMAIL_ADAPTER – smtp, postmark, sendgrid, mailgun nebo ahasend. Podrobnosti najdete v návodu Postmark E-mail API a v kapitole Proměnné prostředí.