Easy.Easy.Notifications 1.0.4

Easy.Notifications

Easy.Notifications is a modular and extensible .NET library for sending notifications through multiple channels. It provides a unified interface to dispatch messages via Email, SMS, WhatsApp, Telegram, Slack, Microsoft Teams, and more.

Features

• 🔌 Plug-and-play support for:
  • SMTP, SendGrid, Mailgun
  • Twilio, Vonage (SMS & WhatsApp)
  • Telegram Bots
  • Slack (Block Kit)
  • Microsoft Teams (MessageCard)
• 📦 Simple service registration via AddEasyNotifications()
• 🧩 Extensible provider model
• 🔒 Configuration-based setup
• ☁️ SignalR support (optional)

Installation

1. Install the NuGet package (TBD):

dotnet add package Easy.Notifications

2. Add configuration section in appsettings.json:

{
  "NotificationConfiguration": {
    "NotificationOptions": {
      "UseEmail": true,
      "UseSms": true,
      "UseWhatsApp": true,
      "UseTelegram": true,
      "UseSlack": true,
      "UseTeams": true
    },
    "NotificationProviders": {
      "EmailProvider": "Sendgrid", // Options: "Smtp", "Sendgrid", "Mailgun"
      "SmsProvider": "Twilio" // Options: "Twilio", "Vonage" (ex nexmo)
    },
    "EmailConfiguration": {
      // SMTP
      "Host": "smtp.yourdomain.com",
      "Port": 587,
      "Username": "your-smtp-username",
      "Password": "your-smtp-password",
      "Sender": "noreply@yourdomain.com",
      "SenderDisplayName": "Your App Name"
      "EnableSsl": true,
    }
    /*
    // SendGrid
    "EmailConfiguration": {
      "ApiKey": "<SENDGRID_API_KEY>",
      "Sender": "noreply@example.com",
      "SenderDisplayName": "Easy Notifications"
    },
    */
    // Mailgun
    "EmailConfiguration": {
      "ApiKey": "<MAILGUN_API_KEY>",
      "Domain": "<MAILGUN_DOMAIN>",
      "Sender": "noreply@example.com",
      "SenderDisplayName": "Easy Notifications"
    },
    */
    "SmsConfiguration": {
    // Twilio
      "Username": "<TWILIO_SID>",
      "Password": "<TWILIO_TOKEN>",
      "Sender": "+1234567890"
    },
    /*
    // Vonage (Nexmo)
    "SmsConfiguration": {
      "Username": "<ACCOUNT_SID>",
      "Password": "<AUTH_TOKEN>",
      "Sender": "+1234567890"
    */
    "WhatsAppConfiguration": {
      "AccountSid": "<ACCOUNT_SID>",
      "AuthToken": "<AUTH_TOKEN>",
      "Sender": "whatsapp:+1234567890"
    },
    "TelegramConfiguration": {
      "BotToken": "<BOT_TOKEN>",
      "ChatId":   "<CHAT_ID>" 
    },
    "SlackConfiguration": {
      "WebhookUrl": "<SLACK_WEBHOOK_URL>"
    },
    "TeamsConfiguration": {
      "WebhookUrl": "<TEAMS_WEBHOOK_URL>"
    }
  }
}

3. Register the service in Startup.cs or Program.cs:

services.AddEasyNotifications(Configuration);

4. Inject and use INotificationService:

public class NotificationController : ControllerBase
{
    private readonly INotificationService _notificationService;

    public NotificationController(INotificationService notificationService)
    {
        _notificationService = notificationService;
    }

    [HttpPost("notify")]
    public async Task<IActionResult> Send(NotificationMessage message)
    {
        await _notificationService.SendAsync(message);
        return Ok();
    }
}

SignalR Integration

If using SignalR:

app.UseEndpoints(endpoints =>
{
    endpoints.MapHub<NotificationHub>("/notificationHub");
});

License

MIT License.

© 2025 Elmin Alirzayev / Easy Code Tools