Вам знадобиться обліковий запис 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. Додайте їх усі.
| Type | Host | Purpose |
|---|
CNAME | em1234.yourdomain.com | Домен return-path (bounce) |
CNAME | s1._domainkey.yourdomain.com | Ключ DKIM 1 |
CNAME | s2._domainkey.yourdomain.com | Ключ DKIM 2 |
⭐ SendGrid навмисно використовує CNAME замість записів TXT, і це справді краще: фактичні значення ключів зберігаються в SendGrid, тож вони можуть оновлювати свої ключі підпису без необхідності повторного редагування вашого DNS.
⚠️ Якщо вашим DNS-провайдером є Cloudflare, установіть для цих записів значення DNS only (сіра хмара), а не проксі (proxied). Проксійований 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 (домен, а не адреса)
- Ключ API SendGrid — ключ із кроку 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). Переконайтеся, що ваш список клієнтів очищений, перш ніж переходити.