Kakailanganin ninyo ng isang Postmark account at access sa DNS ng inyong domain.
Sariling dokumentasyon ng Postmark: Mga Sender signature at domain · Mga Server API token · Magrehistro
⭐ Kung bakit pipiliin namin ang Postmark para rito. Tumatanggi itong maghatid ng marketing email sa kabuuan, na siyang eksaktong dahilan kung bakit ganoon ang delivery rates nito: ang inyong mga invoice ay hindi nakikibahagi ng reputasyon sa newsletter ng iba. Kung ang tanging kinakailangan ninyo ay dumating ang transactional mail, ito na ang pipiliin.
1. Idagdag at i-verify ang inyong domain
Sender Signatures → Domains → Add Domain, at ilagay ang isang subdomain tulad ng mail.yourdomain.com.
Bibigyan kayo ng Postmark ng dalawang record:
| Uri | Host | Layunin |
|---|
TXT | <selector>._domainkey.mail.yourdomain.com | Pampublikong susi ng DKIM |
CNAME | pm-bounces.mail.yourdomain.com | Domain ng return-path (bounce) |
Idagdag ang pareho, pagkatapos ay pindutin ang Verify.
⭐ Idagdag ang return-path record, kahit minarkahan itong optional ng Postmark. Kung wala ito, ang inyong mga mensahe ay ipinapadala gamit ang sariling bounce domain ng Postmark, kaya naka-align ang SPF sa postmarkapp.com sa halip na sa inyo. Ang DKIM lamang ay magbibigay pa rin sa inyo ng DMARC pass — ngunit naitapon ninyo ang isa sa dalawang pagsusuri nang walang dahilan, at kakailanganin ninyo ang pareho sa unang pagkakataong maging mahigpit ang isang malaking receiver.
⚠️ Hindi kailangan ng Postmark ng SPF record dahil hindi nito ginagamit ang inyong domain bilang envelope sender. Kung mayroon na kayong SPF, hayaan ninyo ito.
2. Kunin ang inyong Server API token
Buksan ang server kung saan ninyo nais magpadala — tinatawag ng Postmark na "server" ang isang sending environment — pagkatapos ay API Tokens, at kopyahin ang Server API token.
⛔ Ang Server token, hindi ang Account token. Pinamamahalaan ng Account token ang buong Postmark account ninyo: makakagawa ito ng mga server, makakapagbago ng mga domain at makababasa ng bawat mensaheng naipadala ninyo kailanman. Ang Server token ay makakapagpadala mula sa isang server. Magkamukha sila at ni-paste sa parehong uri ng box, at ito ang pinakamadaling pagkakamaling magawa sa pahinang ito.
⭐ Isaalang-alang ang paggawa ng hiwalay na server para rito — tawagin itong "Zinn® notifications". Ang mga istatistika, bounce list at activity feed ng Postmark ay lahat per-server, kaya ang hiwalay ay nangangahulugang ang inyong mga notification sa kliyente ay hindi nahahalo sa anumang iba pa ninyong ipinapadala.
3. Ikonekta ito sa Zinn®
Buksan ang Pagpapadala ng email sa inyong dashboard:
- Provider — Postmark
- Ipadala mula sa domain na ito —
mail.yourdomain.com
- Message stream — iwanang
outbound maliban kung gumawa kayo ng sarili ninyo
- Postmark server token — ang token mula sa hakbang 2
⚠️ Ang Message stream ay dapat na transactional na stream. Tinatanggihan ng Postmark ang mail na mukhang transactional na ipinadala sa isang broadcast stream, at ang mga password reset at invoice ay transactional.
4. Ipadala ang test at ilagay ang code
Pindutin ang Magpadala ng test message papunta sa isang inbox sa ibang domain, basahin ang code mula rito, at ilagay ito.
Kapag hindi ito gumagana
"You tried to send to a recipient that has been marked as inactive" — Sini-suppress ng Postmark ang isang address pagkatapos ng hard bounce o spam complaint, permanente, hanggang sa i-reactivate ninyo ito. Tingnan sa Suppressions. Ito ang Postmark na nagpoprotekta sa inyo, at kadalasan ay tama ito.
422 with "Invalid 'From' address" — ang domain sa Ipadala mula sa domain na ito ay hindi naka-verify sa Postmark, o ni-verify ninyo ang yourdomain.com at nagpapadala kayo mula sa mail.yourdomain.com. Tugma ang Postmark sa eksaktong domain.
401 Unauthorized — ni-paste ninyo ang Account token sa halip na ang Server token (tingnan sa itaas), o ang token ay sa ibang server.
Gumagana ang lahat ngunit nasa spam folder ito — suriin na ang DKIM ay nagpapakita ng Verified sa Postmark at na ang inyong DMARC record ay hindi naka-set sa p=reject habang may iba pang bagay tungkol sa inyong domain na hindi pa naka-align.