Інтеграція 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 робочий день.