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

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

Разработка и обслуживание любых видов сайтов:

Информационные сайты или веб-приложения
Сайты визитки, landing page, корпоративные сайты, онлайн каталоги, квиз, промо-сайты, блоги, новостные ресурсы, информационные порталы, форумы, агрегаторы
Сайты или веб-приложения электронной коммерции
Интернет-магазины, B2B-порталы, маркетплейсы, онлайн-обменники, кэшбэк-сайты, биржи, дропшиппинг-платформы, парсеры товаров
Веб-приложения для управления бизнес-процессами
CRM-системы, ERP-системы, корпоративные порталы, системы управления производством, парсеры информации
Сайты или веб-приложения электронных услуг
Доски объявлений, онлайн-школы, онлайн-кинотеатры, конструкторы сайтов, порталы предоставления электронных услуг, видеохостинги, тематические порталы

Это лишь некоторые из технических типов сайтов, с которыми мы работаем, и каждый из них может иметь свои специфические особенности и функциональность, а также быть адаптированным под конкретные потребности и цели клиента

Услуги, которые мы предлагаем
Показано 1 из 1Все 2062 услуг
Интеграция SendGrid: транзакционные письма и рассылки
Простой
~1 день
Часто задаваемые вопросы

Наши компетенции:

Этапы разработки

Последние работы

  • image_website-b2b-advance_0.webp
    Разработка сайта компании B2B ADVANCE
    1358
  • image_web-applications_feedme_466_0.webp
    Разработка веб-приложения для компании FEEDME
    1250
  • image_websites_belfingroup_462_0.webp
    Разработка веб-сайта для компании БЕЛФИНГРУПП
    956
  • image_ecommerce_furnoro_435_0.webp
    Разработка интернет магазина для компании FURNORO
    1188
  • image_crm_enviok_479_0.webp
    Разработка веб-приложения для компании Enviok
    929
  • image_bitrix-bitrix-24-1c_fixper_448_0.webp
    Разработка веб-сайта для компании ФИКСПЕР
    947

Представьте: интернет-магазин с 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 Amazon SES Mailgun
API простота 5/5 4/5 4/5
Динамические шаблоны Да (Handlebars) Нет Нет
Event Webhook Детальные события Базовые Детальные
Начальный лимит 100 писем/день (free) 62 000/мес (free) 5 000/мес (free)
Встроенная аналитика Да Частично Да

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

Типы отправок и рекомендации
Сценарий Рекомендуемый тип отправки Частота
Подтверждение заказа Транзакционное (single send) Единично
Маркетинговая рассылка Маркетинговая кампания Раз в неделю
Сброс пароля Транзакционное При запросе
Уведомления о статусе Транзакционное (batch) По событию

Как проходит интеграция 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 лет интеграции почтовых сервисов, мы гарантируем стабильную работу и полную документацию после завершения проекта.

Интеграция email рассылок: почему она часто ломается?

Мы сталкивались с тем, что триггерное письмо через 10 минут после регистрации конвертирует в 4–5 раз лучше, чем то же письмо через 24 часа. Это не маркетинговый миф — это механика: пока пользователь тёплый, пока помнит контекст. Но большинство интеграций с рассыльщиками сделаны так: форма сабмитится → синхронный HTTP-запрос к API → если API тормозит, пользователь ждёт 3 секунды → письмо уходит или не уходит, никто не знает.

Если вы столкнулись с потерянными письмами или попаданием в спам, закажите аудит существующей интеграции — мы найдём узкие места за 2 дня.

Провайдеры и их API

Unisender — российский провайдер, популярен в сегменте SMB. REST API, простой. Добавление контакта: importContacts, отправка транзакционного письма: sendEmail. Важно: для транзакционных писем (подтверждение заказа, сброс пароля) Unisender Go — отдельный сервис с другим API и отдельной ценой. Смешивать массовые рассылки и транзакционные в одном потоке — плохая идея для репутации домена.

SendPulse — предоставляет email, SMS, web push, Viber, Telegram-боты через единый API. Для проектов, где нужен омниканал, это удобно. Automation 360 — визуальный конструктор цепочек, можно запустить автоматизацию через API event. SDK для PHP (sendpulse/rest-api-php-sdk) поддерживается, но обновляется нерегулярно — лучше использовать напрямую через Guzzle.

Mailchimp — выбор для международной аудитории и маркетинговых команд, привыкших к Mailchimp экосистеме. Transactional email — через Mandrill (дочерний сервис). Marketing API v3 для управления списками, тегами, кампаниями. Webhook для событий: открытие, клик, отписка, bounce.

SMS. Для России: СМСЦ, МТС Exolve, Devino Telecom, SMS Aero. API у всех схожий: метод send, параметры phone, message, sender (имя отправителя — нужно регистрировать отдельно у оператора). Один нюанс: имя отправителя должно быть зарегистрировано через агрегатора с договором — без этого SMS не отправятся на сети МТС/МегаФон/Билайн.

Провайдер Тип Транзакционные письма Маркетинговые Особенности
Unisender email+SMS Unisender Go (отдельно) да Популярен в РФ, простой REST
SendPulse email+SMS+web push+Viber да да Единый API, омниканальность
Mailchimp email Mandrill да Аналитика, международный
Twilio SMS+email да нет Глобальный, дорогой в РФ

Как построить интеграцию, чтобы не терять письма?

Разделяем транзакционные и маркетинговые потоки

Транзакционные письма (подтверждение заказа, сброс пароля, статус доставки) — через отдельный домен-отправитель или субдомен tx.example.com. Маркетинговые рассылки — через mail.example.com или news.example.com. Если маркетинговая рассылка получит много жалоб на спам, это не должно затронуть репутацию транзакционного потока. Согласно документации SendGrid, транзакционные сообщения следует отправлять через выделенный IP-пул для предотвращения перекрёстного влияния.

Очередь и retry

Любой вызов к email API — через очередь (Laravel Queue, Bull, Celery). Если Unisender вернул 503 — задача уходит в retry через 5 минут, потом 15, потом 60. После 5 неудачных попыток — в dead letter queue с алертом. Пользователь при этом уже получил свой 200 OK и не знает о проблеме. Благодаря этому подходу bounce rate на проектах снижается до 0.5%.

Пример job для Laravel:

public function handle(): void
{
    try {
        $response = Http::post(config('services.unisender.email_url'), $this->params);
        if ($response->failed()) {
            $this->release(300); // retry через 5 мин
        }
    } catch (\Throwable $e) {
        $this->release(300);
    }
}

Шаблоны

Храним шаблоны в коде (Blade, Twig, React Email), не в интерфейсе провайдера. Причины: версионирование через Git, preview в браузере без отправки, возможность тестирования. Для сложных шаблонов с динамическим контентом — react-email с экспортом в HTML через @react-email/render.

Валидация и согласия

Перед добавлением контакта в список — double opt-in (письмо с подтверждением). Хранить факт подтверждения с timestamp в своей БД. При отписке — синхронно отписываем и у провайдера, и в своей базе. Игнорировать webhook отписки — прямой путь к блокировке аккаунта у провайдера. Все процессы соответствуют ФЗ-152 о персональных данных.

Как настроить DKIM для домена-отправителя?

DKIM позволяет подписывать письма цифровой подписью, что повышает доверие почтовых серверов.

  1. Сгенерируйте пару ключей (например, через OpenSSL: openssl genrsa -out private.key 2048).
  2. Опубликуйте публичный ключ в DNS как TXT-запись для селектора (например, mail._domainkey.tx.example.com).
  3. Укажите селектор у провайдера (SendGrid, Mailgun, Unisender).
  4. Проверьте командой dig TXT mail._domainkey.tx.example.com.

Мониторинг доставляемости

Подключаем webhook от провайдера на события bounce (жёсткий и мягкий), spam_complaint, unsubscribe. Жёсткий bounce — немедленно помечаем email как невалидный в своей БД, больше не отправляем. Мягкий bounce 3 раза подряд — то же самое. Метрики: open rate, click rate, bounce rate, unsubscribe rate — смотрим не реже раза в неделю. Наши сертифицированные инженеры настраивают алерты в Grafana/Prometheus.

Почему важно разделять потоки?

Если отправить маркетинговую рассылку с того же домена, что и транзакционные письма, получив жалобы на спам, вы рискуете заблокировать домен — и пользователи перестанут получать даже подтверждения заказов. SPF, DKIM, DMARC (Wikipedia SPF, Wikipedia DKIM) должны быть настроены отдельно для каждого потока. Мы используем субдомены с разными DNS-записями.

Объём работ по интеграции

  • Аудит текущих потоков коммуникации и репутации домена (SPF, DKIM, DMARC)
  • Выбор провайдера и схемы: транзакционный vs маркетинговый трафик
  • Настройка DNS-записей SPF, DKIM, DMARC (Wikipedia DMARC)
  • Разработка шаблонов писем (HTML + динамический контент)
  • Интеграция с бэкендом через очереди и API
  • Настройка webhook для доставляемости и жалоб
  • Документация по эксплуатации и обучение команды
  • Гарантия доставляемости и поддержка после запуска

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

Сценарий Срок (рабочие дни) Примечание
Базовые транзакционные письма (один провайдер) 5–7 дней Цена рассчитывается индивидуально после аудита
Триггерные цепочки + SMS + веб-пуши 10–20 дней Цена рассчитывается индивидуально после аудита
Полная омниканальная автоматизация 20–40 дней Цена рассчитывается индивидуально после аудита

Стоимость рассчитывается индивидуально после аудита. Мы работаем под ключ: от анализа до мониторинга в продакшене. Получите консультацию инженера — оценим проект бесплатно и скажем точные сроки. Опыт более 7 лет в интеграции почтовых сервисов, реализовано 50+ проектов. Закажите бесплатный аудит текущей интеграции — получите отчёт с рекомендациями.