> ## Documentation Index > Fetch the complete documentation index at: https://mintlify.com/jevil25/whatsapp-waha-dashboard/llms.txt > Use this file to discover all available pages before exploring further. # Notifications > Multi-channel notification system with WhatsApp and email delivery ## Overview WAHA Dashboard implements a robust multi-channel notification system using WhatsApp (primary) and email (fallback) to ensure administrators are always informed of critical events. The system is powered by Mailgun for email delivery and the WAHA API for WhatsApp messaging. ## Notification Channels Primary notification channel for real-time alerts * Instant delivery * Rich formatting with emojis * Direct links to admin dashboard Fallback channel when WhatsApp fails * HTML-styled templates * Professional branding * Reliable delivery via Mailgun ## Email Configuration Email notifications use Mailgun as the delivery provider: ```typescript src/server/mailgun.ts:8 theme={null} const mailgun = new Mailgun(FormData); const mg = mailgun.client({ username: "api", key: env.MAILGUN_API_KEY, }); ``` ### Required Environment Variables Your Mailgun API key for authentication Your verified Mailgun sending domain Sender email address (must be on verified domain) Administrator email address for notifications Administrator phone number for WhatsApp notifications (format: 1234567890) Base URL for your application (used in notification links) ## Notification Types ### 1. User Registration Notifications When a new user signs up, admins receive dual-channel notifications. #### WhatsApp Notification ```typescript src/server/mailgun.ts:430 theme={null} export async function sendWhatsAppNotificationToAdmin(userName: string, userEmail: string) { const admin = await db.user.findFirst({ where: { role: "ADMIN" }, select: { id: true }, }); const adminSession = await db.whatsAppSession.findFirst({ where: { userId: admin.id } }); if (!adminSession) { throw new Error("No active WhatsApp session found for admin"); } const message = `🔔 *New User Registration* A new user has registered for WhatsApp Group Manager: 👤 *Name:* ${userName} 📧 *Email:* ${userEmail} 📅 *Date:* ${new Date().toLocaleDateString()} Please review and approve this registration in the admin dashboard. ${env.BETTER_AUTH_URL}/admin`; const response = await fetch(`${env.WAHA_API_URL}/api/sendText`, { method: 'POST', headers: { 'accept': 'application/json', 'X-Api-Key': env.WAHA_API_KEY, 'Content-Type': 'application/json' }, body: JSON.stringify({ chatId: env.ADMIN_PHONE_NUMBER + '@c.us', text: message, session: adminSession.sessionName, }) }); return { success: true }; } ``` WhatsApp notifications require: * An active admin WhatsApp session * Configured WAHA API endpoint * Valid API key * Admin phone number in E.164 format #### Email Notification ```typescript src/server/mailgun.ts:286 theme={null} export async function sendUserRegistrationNotificationToAdmin(userName: string, userEmail: string) { const emailData = { from: env.FROM_EMAIL, to: env.ADMIN_EMAIL, subject: "New User Registration - Approval Required", html: ` New User Registration
🔔

New User Registration

Hello Admin,

A new user has registered and is waiting for approval.

Name: ${userName}
Email: ${userEmail}
Registration Date: ${new Date().toLocaleDateString()}
Go to Admin Dashboard
`, text: `New User Registration Name: ${userName} Email: ${userEmail} Registration Date: ${new Date().toLocaleDateString()} Please review this registration in the admin dashboard.` }; const response = await mg.messages.create(env.MAILGUN_DOMAIN, emailData); return { success: true, messageId: response.id }; } ``` ### 2. Password Reset Emails Sent when users request to reset their password: ```typescript src/server/mailgun.ts:14 theme={null} export async function sendResetPasswordEmail(email: string, url: string) { const emailData = { from: env.FROM_EMAIL, to: email, subject: "Reset Your Password - WhatsApp Group Manager", html: `

Reset Your Password

We received a request to reset your password

Click the button below to reset your password:

Reset Your Password
⚠️ Security Notice: This password reset link will expire in 1 hour for your security.
`, }; const response = await mg.messages.create(env.MAILGUN_DOMAIN, emailData); return { success: true, messageId: response.id }; } ``` Password reset links expire after 1 hour for security. Users must request a new link if it expires. ### 3. Password Changed Confirmation Sent after successful password change: ```typescript src/server/mailgun.ts:162 theme={null} export async function sendPasswordChangedNotification(email: string) { const emailData = { from: env.FROM_EMAIL, to: email, subject: "Password Changed Successfully - WhatsApp Group Manager", html: `
✅

Password Changed Successfully

Your password has been successfully changed.

✓ Password Updated: Your account is now secured with your new password.

Didn't make this change? Contact support immediately.

`, }; const response = await mg.messages.create(env.MAILGUN_DOMAIN, emailData); return { success: true, messageId: response.id }; } ``` ## Dual-Channel Delivery System The notification system attempts WhatsApp first, then falls back to email: ```typescript src/server/mailgun.ts:496 theme={null} export async function notifyAdminOfNewRegistration(userName: string, userEmail: string) { const results = { whatsapp: false, email: false, errors: [] as string[] }; // Try WhatsApp first try { await sendWhatsAppNotificationToAdmin(userName, userEmail); results.whatsapp = true; console.log("WhatsApp notification sent successfully"); } catch (error) { console.log("WhatsApp notification failed, falling back to email:", error); results.errors.push(`WhatsApp failed: ${error.message}`); // Fallback to email try { await sendUserRegistrationNotificationToAdmin(userName, userEmail); results.email = true; console.log("Email notification sent successfully"); } catch (error) { console.error("Email notification also failed:", error); results.errors.push(`Email failed: ${error.message}`); } } if (!results.whatsapp && !results.email) { throw new Error(`Failed to send notifications: ${results.errors.join(', ')}`); } return results; } ``` System tries to send via WhatsApp using admin's active session If WhatsApp fails (session disconnected, API error, etc.), automatically send email If both channels fail, throw error with detailed failure reasons Return status of both channels and any error messages ## Notification API The notification router exposes the dual-channel system: ```typescript src/server/api/routers/notification.ts:5 theme={null} export const notificationRouter = createTRPCRouter({ notifyAdminOfUserRegistration: publicProcedure .input(z.object({ userName: z.string(), userEmail: z.string().email(), })) .mutation(async ({ input }) => { try { const result = await notifyAdminOfNewRegistration( input.userName, input.userEmail ); return { success: true, whatsappSent: result.whatsapp, emailSent: result.email, errors: result.errors, }; } catch (error) { return { success: false, whatsappSent: false, emailSent: false, errors: [error.message], }; } }), }); ``` ### Response Format Overall success status (true if at least one channel succeeded) Whether WhatsApp notification was delivered Whether email notification was delivered Array of error messages if any channel failed ## Email Template Features All email notifications include: * Mobile-friendly layouts * Maximum width of 600px * Proper viewport meta tags * Consistent font sizes * Branded colors (WhatsApp green: #25D366) * Clean typography using system fonts * Consistent spacing and padding * Subtle shadows and borders * Clear expiration warnings * "Do not reply" disclaimers * Security tips and best practices * Suspicious activity warnings * Plain text alternatives * Semantic HTML structure * High contrast text * Clear call-to-action buttons ## WhatsApp Message Format WhatsApp notifications use Markdown-style formatting: ```markdown theme={null} 🔔 *New User Registration* A new user has registered for WhatsApp Group Manager: 👤 *Name:* John Doe 📧 *Email:* john@example.com 📅 *Date:* 3/4/2026 Please review and approve this registration in the admin dashboard. https://your-app.com/admin ``` WhatsApp supports basic Markdown: * `*bold*` for **bold text** * `_italic_` for *italic text* * Emojis for visual enhancement ## Error Handling ### WhatsApp Errors Common WhatsApp notification failures: * No admin user found in database * No active WhatsApp session for admin * WAHA API unreachable * Invalid API key * Admin phone number misconfigured ### Email Errors Common email notification failures: * Invalid Mailgun API key * Unverified sending domain * Recipient email blocked * Rate limits exceeded * Invalid email format ## Monitoring Notifications Track notification delivery: ```typescript theme={null} console.log("WhatsApp notification sent successfully:", response); console.log("Email notification sent successfully:", response); console.error("Failed to send notification:", error); ``` * Log all notification attempts * Track success/failure rates * Monitor Mailgun dashboard for email metrics * Set up alerts for consistent failures * Review error messages regularly ## Configuration Checklist * Create Mailgun account * Verify sending domain * Get API key * Set FROM\_EMAIL on verified domain ```bash theme={null} MAILGUN_API_KEY=key-xxx MAILGUN_DOMAIN=mg.yourdomain.com FROM_EMAIL=noreply@mg.yourdomain.com ADMIN_EMAIL=admin@yourdomain.com ADMIN_PHONE_NUMBER=1234567890 BETTER_AUTH_URL=https://your-app.com WAHA_API_URL=http://localhost:3000 WAHA_API_KEY=your-waha-key ``` * Admin must have active WhatsApp session * Session must be CONNECTED status * Verify session in admin dashboard * Create test user registration * Verify WhatsApp delivery * Verify email fallback * Check error logging ## Security Considerations * Use environment variables for sensitive data * Never expose API keys in client code * Verify Mailgun domain with SPF/DKIM * Use TLS for email transmission * Secure WAHA API with strong API key * Use HTTPS for API endpoints * Validate admin session before sending * Rate limit notification sends * Only send necessary user information * Don't include passwords in notifications * Use secure links with proper authentication * Follow GDPR/privacy regulations ## Customization Customize notification templates: Edit HTML templates in `src/server/mailgun.ts`: * Update logo and colors * Modify email copy * Add company branding * Customize button styles Edit message templates in `sendWhatsAppNotificationToAdmin`: * Adjust message format * Change emoji usage * Modify link structure * Update greeting text ## Next Steps Learn about receiving and acting on notifications Understand user registration flow