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

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

2. Опубликуйте записи CNAME

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

⭐ 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 (домен, а не адрес)
• Ключ 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). Убедитесь, что ваш список клиентов проверен и очищен, прежде чем переключаться.