Как отправлять письма через API MailerCloud в WordPress: практическое руководство

Автор: Алина Тарасова | Опубликовано: 06.04.2026

MailerCloud – современный сервис для email-маркетинга и транзакционных рассылок с удобным API для интеграции с различными платформами, включая WordPress. В этой статье разберем, как организовать отправку писем через API MailerCloud в WordPress, используя примеры кода и лучшие практики.

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

MailerCloud предлагает удобный REST API, позволяющий управлять массовыми и транзакционными рассылками, создавать шаблоны писем, отслеживать статистику и автоматизировать email-рассылки. В сравнении с традиционными SMTP решениями, API обеспечивает более высокую скорость и надежность доставки, а также расширенные возможности управления контентом писем.

Для WordPress это означает возможность гибко интегрировать почтовую систему с сайтом, например, для отправки уведомлений, подтверждений регистрации, рассылок новостей и промоакций.

Кроме того, MailerCloud поддерживает различные форматы контента, персонализацию писем и вебхуки для обратной связи, что позволяет создавать сложные сценарии взаимодействия с пользователями.

Подготовка к интеграции: регистрация и получение API ключа MailerCloud

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

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

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

Создание простой функции отправки письма через API MailerCloud в WordPress

Для отправки писем через API MailerCloud в WordPress можно использовать функцию с запросом к API через wp_remote_post(). Ниже пример такой функции, которую можно добавить в файл functions.php вашей темы или в кастомный плагин.

function wpmail_send_mailercloud_email($to, $subject, $html_content) {
    $api_key = 'ВАШ_API_КЛЮЧ_ЗДЕСЬ';
    $endpoint = 'https://api.mailercloud.com/v1/email/send';

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

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

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

    if (is_wp_error($response)) {
        return false; // Ошибка запроса
    }

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

В этой функции мы формируем JSON с параметрами письма и отправляем POST-запрос к API MailerCloud с заголовком авторизации. Важно заменить ВАШ_API_КЛЮЧ_ЗДЕСЬ на реальный ключ, а также указать корректный email отправителя.

Пример вызова функции

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

if (wpmail_send_mailercloud_email('user@example.com', 'Тестовое письмо', '<h1>Привет из WordPress!</h1><p>Это тестовое письмо.</p>')) {
    echo 'Письмо успешно отправлено';
} else {
    echo 'Ошибка отправки письма';
}

Обработка ошибок и логирование для отладки отправки писем

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

Пример улучшенной обработки ошибок:

function wpmail_send_mailercloud_email_with_log($to, $subject, $html_content) {
    $api_key = 'ВАШ_API_КЛЮЧ_ЗДЕСЬ';
    $endpoint = 'https://api.mailercloud.com/v1/email/send';

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

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

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

    if (is_wp_error($response)) {
        error_log('MailerCloud API request error: ' . $response->get_error_message());
        return false;
    }

    $code = wp_remote_retrieve_response_code($response);
    $response_body = wp_remote_retrieve_body($response);

    if ($code !== 202) {
        error_log('MailerCloud API returned HTTP ' . $code . ': ' . $response_body);
        return false;
    }

    return true;
}

Вывод ошибок в лог поможет оперативно выявлять проблемы с отправкой и исправлять их.

Использование плагинов для интеграции с MailerCloud

Для тех, кто предпочитает минимизировать кодинг, существуют готовые плагины для интеграции MailerCloud с WordPress. Например, можно использовать универсальные SMTP и API плагины с поддержкой кастомных API, либо специализированные решения.

На wpshop.ru можно найти и приобрести плагины, которые значительно упрощают подключение и настройку рассылок через внешние API, с поддержкой визуальных редакторов и шаблонов.

Использование таких плагинов рекомендуется для сложных проектов с большим объемом рассылок и необходимостью гибкого управления шаблонами.

Настройка плагина на примере

После установки плагина обычно нужно ввести API ключ MailerCloud, указать адрес отправителя и настроить шаблоны писем. Далее плагин берет на себя отправку и обработку ошибок.

Заключение

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

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