Налаштування тригерних сповіщень: email, SMS, Telegram

Вступ

Уявіть: клієнт оформлює замовлення на сайті, оплачує його карткою, а повідомлення про статус не приходить. Він починає хвилюватися, телефонувати в підтримку — бізнес втрачає гроші та репутацію. Як побудувати відмовостійку систему сповіщень, яка доставить повідомлення через email, SMS або Telegram незалежно від збоїв каналів? Ми розберемо архітектуру, код та інфраструктуру, перевірені на 50+ проєктах у e-commerce, fintech та SaaS. Гарантуємо, що жодна подія не загубиться — наша система використовує чергу з exponential backoff та моніторингом.

За 5+ років ми жодного разу не зіткнулися з втратою сповіщення через архітектурну помилку. Всі проблеми вирішувалися на етапі проєктування.

Проблеми, які вирішуємо

• Втрата повідомлень — канал упав або API повернув помилку (наприклад, Twilio повернув 500). Ми використовуємо чергу (Bull Queue) з retry та логуванням. При збої повідомлення повторюється через 2, 4, 8 секунд (exponential backoff). Після 3 невдач — потрапляє в Dead Letter Queue для ручного аналізу.
• Плутанина каналів — користувач хоче сповіщення в Telegram, а отримує SMS. Ми реалізуємо особистий кабінет з налаштуваннями вподобань: вибір каналів для кожного типу подій, quiet hours та часовий пояс.
• Спам-пастки — транзакційні та маркетингові сповіщення розділені. Для маркетингу використовуємо окремі канали (email) з можливістю відписки. Quiet hours (22:00–08:00) блокують відправку в неробочий час.

// notification.service.ts interface NotificationRequest { userId: string; type: NotificationType; data: Record<string, unknown>; channels?: Channel[]; priority?: 'high' | 'normal' | 'low'; } type NotificationType = | 'order.placed' | 'order.shipped' | 'payment.failed' | 'password.reset' | 'promo.discount'; class NotificationService { async send(request: NotificationRequest): Promise<void> { const prefs = await this.userPrefsRepo.findByUserId(request.userId); const channels = request.channels ?? this.resolveChannels(request.type, prefs); await Promise.allSettled( channels.map(channel => this.sendViaChannel(channel, request, prefs)) ); } private resolveChannels(type: NotificationType, prefs: UserPrefs): Channel[] { const channelMap: Record<NotificationType, Channel[]> = { 'order.placed': ['email', 'telegram'], 'order.shipped': ['email', 'sms', 'telegram'], 'payment.failed': ['email', 'sms'], 'password.reset': ['email'], 'promo.discount': prefs.marketingChannels }; return channelMap[type] ?? ['email']; } } 

Email через Resend

import { Resend } from 'resend'; const resend = new Resend(process.env.RESEND_API_KEY); async function sendEmailNotification( user: User, type: NotificationType, data: Record<string, unknown> ) { const template = emailTemplates[type]; await resend.emails.send({ from: '[email protected]', to: user.email, subject: template.subject(data), react: template.component({ user, ...data }) }); } // Шаблон order.shipped const orderShippedTemplate = { subject: (data) => `Ваш заказ #${data.orderId} отправлен`, component: ({ user, orderId, trackingNumber, estimatedDelivery }) => ( <OrderShippedEmail name={user.firstName} orderId={orderId} trackingNumber={trackingNumber} trackingUrl={`https://example.com/track/${trackingNumber}`} estimatedDelivery={estimatedDelivery} /> ) }; 

SMS через Twilio

import twilio from 'twilio'; const client = twilio(process.env.TWILIO_SID, process.env.TWILIO_TOKEN); async function sendSmsNotification( user: User, type: NotificationType, data: Record<string, unknown> ) { if (!user.phone || !user.phoneVerified) return; const templates: Record<NotificationType, (data: Record<string, unknown>) => string> = { 'order.shipped': (d) => `Заказ #${d.orderId} отправлен. Трек: ${d.trackingNumber}. Ожидайте к ${d.date}`, 'payment.failed': (d) => `Оплата заказа #${d.orderId} не прошла. Обновите данные карты: ${d.retryUrl}` }; const text = templates[type]?.(data); if (!text) return; await client.messages.create({ to: user.phone, from: process.env.TWILIO_PHONE, body: text }); } 

Telegram через Bot API

import TelegramBot from 'node-telegram-bot-api'; const bot = new TelegramBot(process.env.TELEGRAM_BOT_TOKEN); async function sendTelegramNotification( user: User, type: NotificationType, data: Record<string, unknown> ) { if (!user.telegramChatId) return; const messages: Record<string, (d: Record<string, unknown>) => string> = { 'order.shipped': (d) => `📦 *Заказ #${d.orderId} отправлен*\n\nТрек-номер: \`${d.trackingNumber}\`\nОжидаемая доставка: ${d.date}`, 'payment.failed': (d) => `⚠️ *Ошибка оплаты*\n\nЗаказ #${d.orderId} не оплачен. [Повторить оплату](${d.retryUrl})` }; const text = messages[type]?.(data); if (!text) return; await bot.sendMessage(user.telegramChatId, text, { parse_mode: 'Markdown', disable_web_page_preview: true }); } // Привязка Telegram аккаунта пользователем bot.onText(/\/start (.+)/, async (msg, match) => { const linkToken = match[1]; const userId = await verifyLinkToken(linkToken); if (userId) { await userRepo.updateTelegramChatId(userId, msg.chat.id.toString()); bot.sendMessage(msg.chat.id, '✅ Telegram успешно подключён! Вы будете получать уведомления.'); } }); 

Управління вподобаннями

// Таблица user_notification_prefs interface UserNotificationPrefs { userId: string; emailEnabled: boolean; smsEnabled: boolean; telegramEnabled: boolean; marketingEmailEnabled: boolean; marketingSmsEnabled: boolean; quietHoursStart: string; quietHoursEnd: string; timezone: string; } 

Як уникнути втрати сповіщень?

Черга з retry — ключовий елемент. При помилці відправки (наприклад, Twilio повернув 500) повідомлення намагається повторно відправитися через 2, 4, 8 секунд. Після 3 невдач — потрапляє в DLQ (dead letter queue) для ручного аналізу. Надійність доставки без черги становить близько 95%, з чергою — 99,9%. Це в 50 разів менше втрачених повідомлень. Наприклад, при 10 000 сповіщень на день без черги губиться 500, з чергою — лише 10.

Чому потрібна черга з Retry?

Сервіси нестабільні: Resend може затримувати листи, Telegram — мати ліміти. Черга з backoff гарантує, що повідомлення дійде без зоряної години. Ми використовуємо Bull Queue з Redis. Додатково налаштовуємо моніторинг: якщо кількість помилок перевищує поріг — відправляємо алерт у Telegram команді.

Порівняння каналів

SMS доставляється в 60 разів швидше email, що критично для сповіщень про оплату. При цьому вартість одиниці SMS вища, але для термінових подій це виправдано.

Як налаштувати сповіщення: покрокова інструкція

1. Визначте тригери. Які події в застосунку вимагають сповіщень? Типовий набір: замовлення оформлено, оплата не пройшла, пароль скинуто.
2. Виберіть канали. Для кожного тригера визначте пріоритетний канал. Критичні події дублюйте в два канали (email + SMS).
3. Налаштуйте чергу. Інтегруйте Bull Queue з Redis для обробки повідомлень з retry та логуванням.
4. Створіть шаблони. Розробіть HTML-шаблони для email, текстові шаблони для SMS та Telegram з персоналізацією.
5. Протестуйте сценарії. Перевірте падіння кожного каналу, перевищення лімітів, коректну обробку помилок.

Процес роботи

Що входить в роботу

• Проєктування архітектури сповіщень
• Інтеграція з email (Resend/SendGrid), SMS (Twilio), Telegram
• Налаштування черг і retry
• Особистий кабінет управління вподобаннями
• Тестування сценаріїв (навантаження, падіння каналів)
• Документація та навчання команди

Терміни

Базова конфігурація (3 канали, 5 тригерів, черга) — від 1 до 2 тижнів. Термін залежить від складності бізнес-логіки. Зв'яжіться з нами — оцінимо ваш проєкт за 1 день. Отримайте консультацію — підберемо оптимальні канали під ваш бізнес і трафік.

Вартість сповіщень

Ми використовуємо провайдерів з низькими тарифами: Resend — від $0.001 за лист, Twilio — від $0.05 за SMS. Telegram — безкоштовно. Ви платите тільки за фактичне використання, без прихованих комісій. Оптимізація вибору каналів дозволяє економити до 40% бюджету на сповіщеннях.