Ще ви е необходим акаунт в SendGrid (Twilio SendGrid) и достъп до DNS настройките на вашия домейн.
Собствената документация на SendGrid: Удостоверяване на подател · API ключове · Регистрация
1. Удостоверете вашия домейн
Settings → Sender Authentication → Authenticate Your Domain.
Изберете вашия DNS хост от списъка и отговорете с Yes на въпроса „Would you like to also brand the links for this domain?“ — брандирането на връзки пренаписва проследяваните връзки към вашия собствен домейн вместо към sendgrid.net, а клиент, който посочи връзка във вашата фактура, трябва да вижда вашето име.
Въведете поддомейн като например mail.yourdomain.com, когато бъдете попитани за домейна, от който изпращате.
2. Публикувайте CNAME записите
SendGrid ви предоставя три или пет CNAME записа. Добавете всички тях.
| Тип | Хост | Предназначение |
|---|
CNAME | em1234.yourdomain.com | Домейн за обратен път (отпадане/bounce) |
CNAME | s1._domainkey.yourdomain.com | DKIM ключ 1 |
CNAME | s2._domainkey.yourdomain.com | DKIM ключ 2 |
⭐ SendGrid умишлено използва CNAME, а не TXT записи, и това наистина е по-доброто решение: действителните стойности на ключовете се намират в SendGrid, така че те могат да сменят своите ключове за подписване, без да се налага отново да променяте вашите DNS записи.
⚠️ Ако вашият DNS доставчик е Cloudflare, задайте тези записи на DNS only (сив облак), а не проксирани. Проксираният CNAME запис се преобразува към адресите на Cloudflare и проверката на SendGrid е неуспешна.
Натиснете Verify в SendGrid. Изчакайте до един час.
3. Създайте API ключ
Settings → API Keys → Create API Key.
Изберете Restricted Access и предоставете права само за Mail Send → Full Access. Нищо друго.
⛔ Не използвайте ключ с пълен достъп (Full Access). Ключ с Full Access може да чете вашите контакти, да променя настройките на вашия акаунт и да създава още ключове; единственото, от което ние имаме нужда, е да изпратим съобщение. Ако нашето копие на вашия ключ някога бъде компрометирано, разликата между тези два ключа е разликата между няколко нежелани имейла и компрометиран акаунт.
⚠️ Ключът се показва само веднъж. Копирайте го, преди да напуснете страницата — SendGrid не може да ви го покаже отново, а само да го замени.
4. Свържете го в Zinn®
Отворете Изпращане на имейли във вашето табло за управление:
- Доставчик — SendGrid
- Изпращане от този домейн —
mail.yourdomain.com (домейн, а не адрес)
- SendGrid API ключ — ключът от стъпка 3
SendGrid не изисква други настройки от вас.
5. Изпратете теста и въведете кода
Натиснете Изпрати тестово съобщение до входяща поща в различен домейн, прочетете кода в него и го въведете.
Когато не работи
403 Forbidden — вашият API ключ няма разрешение за Mail Send. Това е най-често срещаната грешка с голяма преднина: ключ с ограничен достъп (Restricted Access), създаден без отметнати обхвати, се удостоверява напълно успешно, но няма права за нищо.
„The from address does not match a verified Sender Identity“ — удостоверяването на вашия домейн все още не е светнало в зелено или домейнът в Изпращане от този домейн не е този, който сте удостоверили. SendGrid проверява точния домейн: удостоверяването на mail.yourdomain.com не оторизира изпращане от yourdomain.com.
Прието, но никога не е доставено — погледнете в Activity в SendGrid. Чисто нов акаунт понякога се задържа за преглед през първия ден или два и съобщенията остават там, вместо да бъдат върнати като недоставени.
Вашият акаунт беше спрян след няколко изпращания — SendGrid е строг към нови акаунти, които изпращат до адреси, водещи до отпадане (bounce). Уверете се, че списъкът ви с клиенти е изчистен, преди да превключите.