Utahitaji akaunti ya SendGrid (Twilio SendGrid) na ufikiaji wa DNS ya kikoa chako.
Nyaraka za SendGrid zenyewe: Sender authentication · API keys · Sign up
1. Thibitisha kikoa chako
Settings → Sender Authentication → Authenticate Your Domain.
Chagua mtoa huduma wako wa DNS kutoka kwenye orodha, na ujibu Yes kwa "Would you like to also brand the links for this domain?" — kuweka chapa kwenye viungo huandika upya viungo vinavyofuatiliwa ili vitumie kikoa chako mwenyewe badala ya sendgrid.net, na mteja anayeweka kiteuzi juu ya kiungo kwenye ankara yako anapaswa kuona jina lako.
Weka kikoa kidogo (subdomain) kama vile mail.yourdomain.com unapoombwa kikoa unachotuma kutoka kwake.
2. Chapisha rekodi za CNAME
SendGrid inakupa rekodi tatu au tano za CNAME. Ziongeze zote.
| Aina | Mwenyeji (Host) | Kusudi |
|---|
CNAME | em1234.yourdomain.com | Kikoa cha njia ya kurejesha (bounce) |
CNAME | s1._domainkey.yourdomain.com | Ufunguo wa DKIM 1 |
CNAME | s2._domainkey.yourdomain.com | Ufunguo wa DKIM 2 |
⭐ SendGrid hutumia CNAME badala ya rekodi za TXT kimakusudi, na kwa hakika ni bora zaidi: thamani halisi za ufunguo zinapatikana SendGrid, ili waweze kubadilisha funguo zao za kutia saini bila wewe kuhitaji kugusa DNS yako tena.
⚠️ Ikiwa mtoa huduma wako wa DNS ni Cloudflare, weka rekodi hizi ziwe DNS only (wingu la kijivu), si proxied. CNAME iliyo proxied huelekeza kwenye anwani za Cloudflare na ukaguzi wa SendGrid hushindwa.
Bonyeza Verify ndani ya SendGrid. Subiri hadi saa moja.
3. Unda ufunguo wa API
Settings → API Keys → Create API Key.
Chagua Restricted Access na utoe ruhusa ya Mail Send → Full Access pekee. Si kitu kingine chochote.
⛔ Usitumie ufunguo wa Full Access. Ufunguo wa Full Access unaweza kusoma unaowasiliana nao, kubadilisha mipangilio ya akaunti yako na kuunda funguo zaidi; kitu pekee tunachohitaji kufanya ni kutuma ujumbe. Ikiwa nakala yetu ya ufunguo wako ingewahi kufichuliwa, tofauti kati ya funguo hizo mbili ni tofauti kati ya barua pepe zisizohitajika na akaunti iliyoathiriwa.
⚠️ Ufunguo huonyeshwa mara moja tu. Unakili kabla ya kuondoka kwenye ukurasa — SendGrid haiwezi kukuonyesha tena, inaweza tu kuubadilisha.
4. Unganisha ndani ya Zinn®
Fungua Email sending kwenye dashibodi yako:
- Mtoa huduma (Provider) — SendGrid
- Tuma kutoka kikoa hiki (Send from this domain) —
mail.yourdomain.com (kikoa, si anwani)
- Ufunguo wa API wa SendGrid — ufunguo kutoka hatua ya 3
SendGrid haihitaji mipangilio mingine yoyote kutoka kwako.
5. Tuma jaribio na uweke msimbo
Bonyeza Send test message kwenda kwenye kisanduku pokezi cha kikoa tofauti, soma msimbo kutoka humo, na uuweke.
Wakati haifanyi kazi
403 Forbidden — ufunguo wako wa API hauna ruhusa ya Mail Send. Hili ndilo kosa la kawaida zaidi kwa mbali: ufunguo wa Restricted Access ulioundwa bila kuweka alama kwenye upeo wowote unathibitisha kikamilifu lakini hauruhusiwi kufanya chochote.
"The from address does not match a verified Sender Identity" — uthibitishaji wa kikoa chako haujawa wa kijani bado, au kikoa kilicho kwenye Send from this domain si kile ulichothibitisha. SendGrid hukagua kikoa kamili: kuthibitisha mail.yourdomain.com hakuidhinishi utumaji kutoka yourdomain.com.
Imekubaliwa lakini haijawahi kuwasilishwa (Accepted but never delivered) — angalia Activity ndani ya SendGrid. Akaunti mpya kabisa wakati mwingine hushikiliwa ili ikaguliwe kwa siku ya kwanza hivi, na ujumbe hubaki hapo badala ya kukataliwa (kubounce).
Akaunti yako ilisimamishwa baada ya kutuma mara chache — SendGrid ni kali kuhusu akaunti mpya zinazotuma kwenye anwani zinazokataa barua pepe (bounce). Hakikisha orodha ya wateja wako ni safi kabla ya kuhamia.