Интеграция email-рассылки (SendGrid) с сайтом
SendGrid — один из ведущих транзакционных email-провайдеров, принадлежит Twilio. Предоставляет мощный API, динамические шаблоны и детальную аналитику доставки. Оптимален для высоких объёмов транзакционных писем.
Отправка через API v3
// composer require sendgrid/sendgrid
$email = new \SendGrid\Mail\Mail();
$email->setFrom("[email protected]", "Мой магазин");
$email->setSubject("Заказ #{$orderId} подтверждён");
$email->addTo($to, $userName);
$email->addContent("text/html", $htmlBody);
$sendgrid = new \SendGrid(env('SENDGRID_API_KEY'));
$response = $sendgrid->send($email);
Динамические шаблоны
Шаблоны создаются в UI SendGrid с переменными {{variable_name}}:
$email->setTemplateId(env('SENDGRID_ORDER_TEMPLATE_ID'));
$email->addDynamicTemplateDatas([
'order_id' => $orderId,
'order_total' => $orderTotal,
'items' => $itemsArray,
'customer' => ['name' => $name, 'address' => $address]
]);
Управление подписчиками (Marketing API)
// Добавить контакт в список
Http::withToken(env('SENDGRID_API_KEY'))
->put('https://api.sendgrid.com/v3/marketing/contacts', [
'list_ids' => [env('SENDGRID_LIST_ID')],
'contacts' => [[
'email' => $email,
'first_name' => $firstName,
'custom_fields' => ['e1_T' => 'customer'] // кастомное поле
]]
]);
Event Webhook для трекинга
SendGrid может отправлять события (доставлено, открыто, клик, bounce) на webhook сайта:
Route::post('/webhooks/sendgrid', function (Request $request) {
foreach ($request->json()->all() as $event) {
EmailEvent::create([
'email' => $event['email'],
'event' => $event['event'], // 'delivered', 'open', 'click', 'bounce'
'sg_event_id' => $event['sg_event_id']
]);
}
return response('OK');
});
Laravel Mail Integration
В Laravel SendGrid подключается через официальный драйвер или как SMTP:
MAIL_MAILER=sendgrid
SENDGRID_API_KEY=SG.xxxx
Срок интеграции: 1 рабочий день.