Интеграция SendGrid: транзакционные письма и рассылки

Представьте: интернет-магазин с 10 000 заказов в месяц теряет до 15% подтверждений из-за попадания в спам. Каждый потерянный заказ — это упущенная выручка и недовольный клиент. Мы столкнулись с такой ситуацией на проекте и внедрили SendGrid. Интеграция заняла 2 дня, доставляемость выросла до 99,5%, а затраты на email-инфраструктуру снизились на 30% за счёт отказа от собственного SMTP-сервера. SendGrid обрабатывает миллионы писем в день, обеспечивая uptime 99,9% и встроенную аналитику. Получите консультацию по вашему проекту — мы поможем с интеграцией.

Как SendGrid решает проблему доставляемости?

Доставляемость напрямую зависит от репутации отправителя. SendGrid автоматизирует управление репутацией: выделенные IP-пулы, автоматическая обработка жалоб на спам, suppression list. Согласно документации SendGrid, правильная настройка SPF, DKIM и DMARC снижает вероятность попадания в спам на 90%. Мы настраиваем Event Webhook, чтобы в реальном времени отслеживать доставку, отказы и клики. Это позволяет оперативно реагировать на проблемы. SendGrid в 2 раза быстрее интегрируется, чем Amazon SES, за счёт готовых SDK и динамических шаблонов.

Почему стоит использовать динамические шаблоны?

Динамические шаблоны на Handlebars дают гибкость: вы меняете содержимое письма без изменения кода. Например, для подтверждения заказа мы передаём массив товаров, и шаблон сам рендерит таблицу. Это ускоряет разработку и упрощает поддержку. Согласно документации SendGrid, динамические шаблоны поддерживают вложенные блоки и условную логику. Статические шаблоны требуют правок в коде при каждом изменении дизайна — динамические решают эту проблему, сокращая время на внесение изменений в 2–3 раза.

Сравнение SendGrid с другими ESP

SendGrid выигрывает по простоте интеграции и наличию динамических шаблонов — это сокращает время разработки на 30% по сравнению с Amazon SES.

Как проходит интеграция SendGrid?

1. Аналитика — аудит текущей схемы отправки, проверка DNS (SPF, DKIM, DMARC).
2. Проектирование — выбор типа шаблонов, настройка категорий для статистики.
3. Реализация — установка пакета @sendgrid/mail, написание кода отправки, настройка шаблонов.
4. Тестирование — отправка тестовых писем, проверка доставляемости через Email Test.
5. Деплой — запуск в production, мониторинг через Webhook и Dashboard.

Что входит в работу

• Аудит текущей схемы отправки и рекомендации по улучшению.
• Создание и настройка домена для отправки (SPF/DKIM/DMARC).
• Интеграция с кодом: единичные отправки, батчевые рассылки, динамические шаблоны.
• Настройка Event Webhook для отслеживания событий.
• Документация по API и обучение вашей команды.
• Тестирование доставляемости на разных почтовых клиентах.

Примеры интеграции с API

Установка и пример кода

npm install @sendgrid/mail 

import sgMail from '@sendgrid/mail';
sgMail.setApiKey(process.env.SENDGRID_API_KEY!);
await sgMail.send({
  to: '[email protected]',
  from: { email: '[email protected]', name: 'Acme' },
  subject: 'Подтверждение заказа #12345',
  html: '<p>Ваш заказ принят!</p>',
  categories: ['transactional', 'order-confirmation'],
  trackingSettings: {
    clickTracking: { enable: true },
    openTracking: { enable: true },
  },
});

Динамические шаблоны

await sgMail.send({
  to: user.email,
  from: '[email protected]',
  templateId: 'd-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
  dynamicTemplateData: {
    subject: `Заказ #${order.id} подтверждён`,
    customer_name: user.name,
    order_id: order.id,
    items: order.items.map(item => ({
      name: item.name,
      quantity: item.quantity,
      price: formatCurrency(item.price),
    })),
    total: formatCurrency(order.total),
    order_url: `https://app.example.com/orders/${order.id}`,
  },
});

Батчевая рассылка через Marketing Campaigns API

import axios from 'axios';

const { data: campaign } = await axios.post(
  'https://api.sendgrid.com/v3/marketing/singlesends',
  {
    name: 'Апрельская рассылка',
    email_config: {
      subject: 'Новости апреля от Acme',
      html_content: newsletterHtml,
      sender_id: 123,
      suppression_group_id: 456,
    },
    send_to: {
      list_ids: ['list-uuid-1', 'list-uuid-2'],
    },
  },
  {
    headers: {
      Authorization: `Bearer ${process.env.SENDGRID_API_KEY}`,
    },
  }
);

await axios.post(
  `https://api.sendgrid.com/v3/marketing/singlesends/${campaign.id}/schedule`,
  {
    send_at: 'now',
  },
  {
    headers: {
      Authorization: `Bearer ${process.env.SENDGRID_API_KEY}`,
    },
  }
);

Webhooks (Event Webhook)

app.post('/api/webhooks/sendgrid', async (req, res) => {
  const events = req.body as Array<{ event: string; email: string; timestamp: number; sg_message_id: string; }>;
  for (const event of events) {
    switch (event.event) {
      case 'delivered':
        await updateEmailStatus(event.sg_message_id, 'delivered');
        break;
      case 'bounce':
        await handleBounce(event.email);
        break;
      case 'unsubscribe':
        await handleUnsubscribe(event.email);
        break;
      case 'spamreport':
        await handleSpamReport(event.email);
        break;
    }
  }
  res.status(200).end();
});

Управление suppression list

SendGrid позволяет управлять suppression list через API. Пример добавления адреса в глобальный suppression list:

await axios.post(
  'https://api.sendgrid.com/v3/asm/suppressions/global',
  { recipient_emails: [email] },
  { headers: { Authorization: `Bearer ${process.env.SENDGRID_API_KEY}` } }
);

Типичные ошибки при работе с SendGrid

• Не настроены SPF/DKIM/DMARC — письма попадают в спам (до 90% писем).
• Игнорирование suppression list — повторные отправки на отказавшие адреса ухудшают репутацию.
• Слишком большие письма > 10 MB — могут быть отклонены.
• Отсутствие обработки webhook — пропускаете отказы и жалобы.
• Неправильная настройка категорий — аналитика становится бесполезной.

Сроки и стоимость

Сроки интеграции: от 2 до 5 дней в зависимости от сложности. Стоимость рассчитывается индивидуально после аудита. Получите консультацию по вашему проекту — мы подберем оптимальную конфигурацию. Закажите интеграцию под ключ — мы гарантируем uptime 99,9% и полную поддержку после запуска.

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