Как отправлять письма через API SendGrid в WordPress

Отправка писем через стандартную функцию wp_mail в WordPress часто сталкивается с проблемами доставки, особенно если хостинг не настроен должным образом. Решением может стать использование внешних сервисов для отправки почты через API. Один из популярных сервисов — SendGrid. В этой статье разберем, как интегрировать API SendGrid для отправки писем в WordPress, рассмотрим примеры кода и полезные рекомендации.

Почему стоит использовать SendGrid для отправки писем из WordPress

SendGrid — это облачный сервис с мощной инфраструктурой для доставки email. Он позволяет:

• Обеспечить высокую доставляемость писем благодаря репутации IP;
• Отправлять письма через API с поддержкой JSON;
• Использовать шаблоны писем с динамическими данными;
• Отслеживать статус доставки, открытия и клики;
• Масштабировать отправку без нагрузки на сервер WordPress.

Поэтому для сайтов с высокой нагрузкой или важными письмами (сброс пароля, уведомления) SendGrid — оптимальный выбор.

Создание SendGrid API ключа и базовая настройка

Для начала необходимо зарегистрироваться на SendGrid и создать API ключ:

1. Войдите в панель SendGrid;
2. Перейдите в раздел Settings > API Keys;
3. Нажмите Create API Key;
4. Выберите права «Full Access» или «Restricted Access» с разрешением на отправку писем;
5. Сохраните ключ — он понадобится для подключения.

Обязательно храните ключ в безопасном месте и не публикуйте его в открытом доступе.

Интеграция SendGrid API в WordPress с помощью кода

Рассмотрим простой пример отправки письма через SendGrid API с помощью PHP в WordPress. Для удобства создадим функцию wpmail_sendgrid_send_mail, которая принимает параметры письма.

function wpmail_sendgrid_send_mail($to, $subject, $content) {
    $apiKey = 'ВАШ_SENDGRID_API_КЛЮЧ';
    $url = 'https://api.sendgrid.com/v3/mail/send';

    $email = [
        'personalizations' => [
            [
                'to' => [ ['email' => $to] ],
                'subject' => $subject
            ]
        ],
        'from' => [ 'email' => 'no-reply@yourdomain.com', 'name' => 'Ваш сайт' ],
        'content' => [ ['type' => 'text/plain', 'value' => $content] ]
    ];

    $args = [
        'body'        => json_encode($email),
        'headers'     => [
            'Authorization' => 'Bearer ' . $apiKey,
            'Content-Type'  => 'application/json',
        ],
        'method'      => 'POST',
        'data_format' => 'body',
        'timeout'     => 15,
    ];

    $response = wp_remote_post($url, $args);

    if (is_wp_error($response)) {
        return false;
    }
    $code = wp_remote_retrieve_response_code($response);
    return $code === 202; // SendGrid возвращает 202 при успешной отправке
}

Теперь можно вызывать эту функцию для отправки писем:

if (wpmail_sendgrid_send_mail('user@example.com', 'Тест SendGrid', 'Привет! Это тестовое письмо через SendGrid API.')) {
    echo 'Письмо отправлено успешно';
} else {
    echo 'Ошибка отправки письма';
}

Практические советы по использованию SendGrid в WordPress

1. Безопасное хранение API ключа

Не стоит прописывать ключ напрямую в коде. Лучше хранить его в wp-config.php или через системные переменные окружения:

define('WPMail_SENDGRID_API_KEY', 'ВАШ_КЛЮЧ');

И использовать так:

$apiKey = defined('WPMail_SENDGRID_API_KEY') ? WPMail_SENDGRID_API_KEY : '';

2. Интеграция с wp_mail через фильтр

Можно заменить стандартный обработчик wp_mail на отправку через SendGrid, используя фильтр wp_mail и переопределяя функцию. Это позволит использовать существующий код и плагины без изменений.

3. Отправка HTML писем и использование шаблонов

SendGrid поддерживает отправку HTML, достаточно в параметре content указать type как text/html. Также можно создавать шаблоны в панели SendGrid и вызывать их через API с динамическими данными.

Использование плагина WP Mail SMTP с SendGrid

Если не хочется писать код, можно использовать плагин WP Mail SMTP. Он поддерживает SendGrid и позволяет быстро настроить отправку почты через API, минуя SMTP.

Настройка сводится к вводу API ключа в интерфейсе плагина и выбору SendGrid как почтового сервиса. Плагин также предоставляет логи отправки и тестирование почты.

Отладка и типичные ошибки при отправке через SendGrid

Основные моменты для проверки:

• Корректность API ключа и права доступа;
• Правильный формат JSON в запросе;
• Статус ответа 202 — успешная очередь на отправку;
• Проверка спама и доменных настроек (SPF, DKIM, DMARC) для вашего домена;
• Логи ошибок в панели SendGrid и в WordPress.

Если письма не доставляются, используйте инструменты SendGrid для анализа и тестирования.

Заключение

Интеграция SendGrid с WordPress через API — мощное решение для надежной и масштабируемой отправки почты. Вы можете использовать как готовые плагины, так и собственные функции для гибкости и контроля. Главное — правильно настроить ключи, доменные записи и обрабатывать ответы API для контроля качества доставки.