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
- Rychlost doručení: E-maily odcházejí přes zabezpečené REST API během zlomku sekundy.
- Detailní logování: V rozhraní Postmarku vidíte přesný stav doručení, otevření (opens) i případné chyby (bounces).
- 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
- Přihlaste se do svého účtu na postmarkapp.com.
- Přejděte do svého Serveru (např. LockMyCal Production).
- Klikněte na záložku API Tokens.
- 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).