Nastavení e-mailů přes Postmark API

Postmark je prémiová služba specializovaná na transakční e-maily s bleskovým doručením a špičkovou reputací IP adres. LockMyCal podporuje přímé odesílání e-mailů přes nativní HTTP API Postmarku, což eliminuje zpoždění a komplikace spojené s klasickým SMTP.


Výhody přímé integrace s Postmarkem

  1. Rychlost doručení: E-maily odcházejí přes zabezpečené REST API během zlomku sekundy.
  2. Detailní logování: V rozhraní Postmarku vidíte přesný stav doručení, otevření (opens) i případné chyby (bounces).
  3. Vysoká doručitelnost do schránky (Inbox): Postmark striktně odděluje transakční poštu od marketingové.

1. Získání Server API Tokenu v Postmarku

  1. Přihlaste se do svého účtu na postmarkapp.com.
  2. Přejděte do svého Serveru (např. LockMyCal Production).
  3. Klikněte na záložku API Tokens.
  4. Zkopírujte hodnotu Server API Token.

2. Ověření odesílací domény (DKIM a SPF)

Pro maximální doručitelnost ověřte v sekci Sender Signatures / Domains svou odesílací doménu a přidejte do svého DNS záznamy:

  • DKIM: CNAME nebo TXT záznam podle pokynů Postmarku.
  • Return-Path (SPF): CNAME záznam pro vyhrazenou subdoménu (např. pm-bounces.vasedomena.cz).

3. Konfigurace v LockMyCal (Proměnné prostředí)

V souboru .env nebo v Docker konfiguraci nastavte:

# Nastavení e-mailového adaptéru na Postmark
EMAIL_ADAPTER=postmark
POSTMARK_API_KEY=vas_postmark_server_api_token_zde

# Odesílací adresa (musí odpovídat ověřené doméně)
EMAIL_FROM_ADDRESS=rezervace@vasedomena.cz
EMAIL_FROM_NAME="LockMyCal Rezervace"

Po restartu kontejneru budou veškerá e-mailová potvrzení, kalendářní pozvánky a upomínky odesílány přímo přes infrastrukturu Postmarku.

Note

Stejným způsobem lze použít i další API poskytovatele: EMAIL_ADAPTER=sendgrid (SENDGRID_API_KEY), mailgun (MAILGUN_API_KEY, MAILGUN_DOMAIN) nebo ahasend (AHASEND_API_KEY, AHASEND_ACCOUNT_ID).