Интеграция email-рассылки (Mailchimp) с сайтом

Интеграция email-рассылки (Mailchimp) с сайтом

Mailchimp — международный лидер email-маркетинга с мощным редактором шаблонов, автоматизациями и развитым API. Подходит для проектов, ориентированных на западные рынки.

Добавление подписчика через Marketing API

// composer require mailchimp/marketing

$mailchimp = new \MailchimpMarketing\ApiClient();
$mailchimp->setConfig([
    'apiKey'  => env('MAILCHIMP_API_KEY'),
    'server'  => env('MAILCHIMP_SERVER_PREFIX')  // 'us1', 'eu2', etc.
]);

try {
    $mailchimp->lists->addListMember(env('MAILCHIMP_LIST_ID'), [
        'email_address' => $email,
        'status'        => 'subscribed',  // или 'pending' для double opt-in
        'merge_fields'  => [
            'FNAME' => $firstName,
            'LNAME' => $lastName
        ],
        'tags' => ['website', 'organic']
    ]);
} catch (\GuzzleHttp\Exception\ClientException $e) {
    // 400 — если email уже существует, проверить статус
}

Upsert подписчика

Если контакт уже существует — используется MD5-хеш email:

$subscriberHash = md5(strtolower($email));
$mailchimp->lists->setListMember(env('MAILCHIMP_LIST_ID'), $subscriberHash, [
    'email_address' => $email,
    'status_if_new' => 'subscribed',
    'merge_fields'  => ['FNAME' => $firstName]
]);

Транзакционные письма через Mandrill (Mailchimp Transactional)

Mandrill — транзакционный email-сервис Mailchimp. Шаблоны хранятся в Mandrill, письма отправляются через API:

$mandrill = new \Mandrill(env('MANDRILL_API_KEY'));
$mandrill->messages->sendTemplate('order-confirmation', [
    ['name' => 'ORDER_ID',   'content' => $orderId],
    ['name' => 'ORDER_TOTAL','content' => $orderTotal]
], [
    'to' => [['email' => $to]],
    'subject' => "Заказ #{$orderId} подтверждён"
]);

События и автоматизации

Mailchimp Customer Journeys запускаются через API-события:

$mailchimp->lists->createListMemberEvent(
    env('MAILCHIMP_LIST_ID'),
    md5(strtolower($email)),
    ['name' => 'purchase', 'properties' => ['amount' => 1500]]
);

Срок интеграции: 1 рабочий день для базовой подписки + транзакционных писем.