# Outage Notification System Sistem untuk mengirim notifikasi gangguan/maintenance ke pelanggan melalui WhatsApp dan Email secara massal. ## Overview Ketika terjadi gangguan jaringan atau ada jadwal maintenance, admin dapat mengirim notifikasi ke semua pelanggan yang terdampak dengan informasi: - Jenis gangguan - Deskripsi gangguan - Estimasi waktu penyelesaian - Area yang terdampak ## API Endpoint **Endpoint**: `POST /api/pppoe/users/send-notification` **Request Body**: ```json { "userIds": [1, 2, 3, 4, 5], "notificationType": "outage", "notificationMethod": "whatsapp|email|both", "issueType": "Gangguan Jaringan", "description": "Terjadi gangguan pada backbone jaringan yang menyebabkan koneksi internet terputus.", "estimatedTime": "2-3 jam", "affectedArea": "Seluruh wilayah Kecamatan A" } ``` ### Parameter | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `userIds` | number[] | Yes | Array ID user PPPoE yang akan menerima notifikasi | | `notificationType` | string | Yes | Harus "outage" untuk notifikasi gangguan | | `notificationMethod` | string | Yes | "whatsapp", "email", atau "both" | | `issueType` | string | Yes | Jenis gangguan (Gangguan Jaringan, Maintenance, Upgrade, Lainnya) | | `description` | string | Yes | Deskripsi detail gangguan | | `estimatedTime` | string | Yes | Estimasi waktu penyelesaian | | `affectedArea` | string | Yes | Area yang terdampak | ### Issue Types 1. **Gangguan Jaringan** - Untuk masalah teknis seperti fiber cut, device down 2. **Maintenance** - Untuk jadwal maintenance rutin 3. **Upgrade** - Untuk upgrade jaringan/perangkat 4. **Lainnya** - Untuk jenis gangguan lain ### Response **Success**: ```json { "message": "Notifikasi gangguan berhasil dikirim", "totalSent": 50, "emailSent": 50, "whatsappSent": 50, "failedCount": 0 } ``` **Error**: ```json { "error": "Gagal mengirim notifikasi", "failedCount": 2, "errors": [ "User John: Nomor WhatsApp tidak valid", "User Jane: Email tidak terdaftar" ] } ``` ## WhatsApp Template **Template Name**: `outage_notification` **Template Content**: ``` ⚠️ *PEMBERITAHUAN GANGGUAN JARINGAN* Yth. Pelanggan *{{customerName}}*, ID Pelanggan: {{customerId}} Dengan ini kami informasikan bahwa sedang terjadi *{{issueType}}* pada jaringan kami. 📋 *Detail Gangguan:* ━━━━━━━━━━━━━━━━━━━━━━━━ 📍 Area Terdampak: {{affectedArea}} 📝 Keterangan: {{description}} ⏱️ Estimasi Perbaikan: {{estimatedTime}} Kami mohon maaf atas ketidaknyamanan ini. Tim teknisi kami sedang bekerja untuk menyelesaikan masalah ini secepat mungkin. Untuk informasi lebih lanjut, silakan hubungi: 📞 {{companyPhone}} 📧 {{companyEmail}} Terima kasih atas pengertian Anda. Hormat kami, *{{companyName}}* ``` ### Template Variables | Variable | Description | |----------|-------------| | `{{customerName}}` | Nama pelanggan | | `{{customerId}}` | ID pelanggan (generated) | | `{{username}}` | Username PPPoE | | `{{issueType}}` | Jenis gangguan | | `{{description}}` | Deskripsi gangguan | | `{{estimatedTime}}` | Estimasi waktu penyelesaian | | `{{affectedArea}}` | Area yang terdampak | | `{{companyName}}` | Nama ISP (dari settings) | | `{{companyPhone}}` | Nomor telepon ISP | | `{{companyEmail}}` | Email ISP | ## Email Template **Template Name**: `outage_notification` **Subject**: `[Penting] Pemberitahuan {{issueType}} - {{companyName}}` **Body (HTML)**: ```html

⚠️ Pemberitahuan Gangguan Jaringan

Yth. Pelanggan {{customerName}},

ID Pelanggan: {{customerId}}

Dengan ini kami informasikan bahwa sedang terjadi {{issueType}} pada jaringan kami.

Detail Gangguan:

  • Area Terdampak: {{affectedArea}}
  • Keterangan: {{description}}
  • Estimasi Perbaikan: {{estimatedTime}}

Kami mohon maaf atas ketidaknyamanan ini. Tim teknisi kami sedang bekerja untuk menyelesaikan masalah ini secepat mungkin.

Untuk informasi lebih lanjut, silakan hubungi:

Terima kasih atas pengertian Anda.

Hormat kami,
{{companyName}}

``` ## Usage Example (Frontend) ### React Component ```typescript const sendOutageNotification = async () => { const response = await fetch('/api/pppoe/users/send-notification', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ userIds: selectedUsers.map(u => u.id), notificationType: 'outage', notificationMethod: notificationMethod, issueType: issueType, description: description, estimatedTime: estimatedTime, affectedArea: affectedArea }) }); const result = await response.json(); if (result.error) { toast.error(result.error); } else { toast.success(`Notifikasi berhasil dikirim ke ${result.totalSent} pelanggan`); } }; ``` ### Dialog Form ```typescript Kirim Notifikasi Gangguan