Отправляйте электронные письма через собственный аккаунт SendGrid

Вам понадобятся учётная запись 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, и клиент, наводящий курсор на ссылку в вашем счете, должен видеть ваше имя.

Введите поддомен (subdomain), например mail.yourdomain.com, когда вас попросят указать домен, с которого вы отправляете.

2. Публикация записей CNAME

SendGrid предоставит вам три или пять записей CNAME. Добавьте их все.

| Тип | Хост | Назначение | | --- | --- | --- | | CNAME | em1234.yourdomain.com | Домен обратного пути (для возврата писем) | | 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). Ключ с полным доступом может читать ваши контакты, изменять настройки вашей учетной записи и создавать новые ключи; единственное, что нам нужно сделать, — это отправить сообщение. Если бы наша копия вашего ключа когда-либо была скомпрометирована, разница между этими двумя ключами заключалась бы в разнице между нежелательным письмом и взломанной учетной записью.

⚠️ Ключ отображается один раз. Скопируйте его, прежде чем покинуть страницу — SendGrid не сможет показать его вам снова, его можно будет только заменить.

4. Подключение в Zinn®

Откройте раздел Email sending в вашей панели управления:

• Provider — SendGrid
• Send from this domain — mail.yourdomain.com (домен, а не адрес)
• SendGrid API key — ключ из шага 3

SendGrid не требует от вас никаких других настроек.

5. Отправка теста и ввод кода

Нажмите Send test message на ящик в другом домене, найдите в нем код и введите его.

Если это не работает

403 Forbidden — у вашего ключа API нет разрешения Mail Send. Это самая распространенная ошибка: ключ с ограниченным доступом (Restricted Access), созданный без выбранных областей видимости, аутентифицируется идеально, но ему разрешено делать ровным счётом ничего.

"The from address does not match a verified Sender Identity" — аутентификация вашего домена еще не стала активной (зеленой) или домен в поле Send from this domain не совпадает с тем, который вы аутентифицировали. SendGrid проверяет точный домен: аутентификация mail.yourdomain.com не дает разрешения на отправку с домена yourdomain.com.

Принято, но так и не доставлено — загляните в раздел Activity в SendGrid. Совершенно новая учетная запись иногда удерживается на проверке в течение первого дня или около того, и сообщения остаются там, а не возвращаются.

Ваша учетная запись была заблокирована после нескольких отправок — SendGrid строго относится к новым учетным записям, отправляющим сообщения на адреса, которые возвращают ошибки (bounce). Убедитесь, что ваш список клиентов чист, прежде чем переходить на этот сервис.