VmadeNotificationPlugin 1.7.0

VmadeNotificationPlugin

Description

VmadeNotificationPlugin is a .NET Core library developed by VMade Software Solutions Private Limited for sending application notifications to Microsoft Teams channels and WhatsApp.

Features

• Send notifications to Microsoft Teams channels.
• Send messages to WhatsApp.
• Simple and easy integration with .NET Core applications.
• Supports custom message formatting.
• Secure and reliable message delivery.

Installation

To install VmadeNotificationPlugin, run the following command:

dotnet add package VmadeNotificationPlugin --version 1.1.0

Usage

App Setting

  "VmadeNotificationHub": {
    "Server": "https://masked-url.com",
    "Key": "XXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXX",
    "TemasMessageSize": "0",
    "DefaultTeamsChannelId": "Teams Channel WebKook Id"
  },

HomeController.cs

if is MVC Application
  [AllowAnonymous]
  [ResponseCache(Duration = 0, Location = ResponseCacheLocation.None, NoStore = true)]
  public IActionResult ErrorPage(string ErrorInfo)
  {
    ViewBag.Error = ErrorInfo;
    return View();
  }

ErrorPage.cshtml

@{
    ViewData["Title"] = "Error Page";
}

<div>
    <h4 class="text-danger">@ViewBag.Error</h4>
</div>

Sending a Notification to Microsoft Teams

Program.cs

builder.Services.AddSingleton<VmadeNotificationPlugin.INotification, VmadeNotificationPlugin.Notification>();


If is MVC Application
app.UseMiddleware<VmadeNotificationPlugin.AspnetCoreExceptionMiddleware.ExceptionMiddleware>("/Home/ErrorPage?ErrorInfo", "Sample Title");

Api Application
app.UseMiddleware<VmadeNotificationPlugin.AspnetCoreExceptionMiddleware.ExceptionMiddleware>("", "Api Global Error");

using VmadeNotificationPlugin;
using VmadeNotificationPlugin.Models;
using VmadeNotificationPlugin.Models.Enum_Severity;
using System.Collections.Generic;
using System.Linq;

var Obj = new VmadeNotificationPlugin.Notification(
    "https://masked-url.com",
    "XXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXX"
);

var _Message = new NotificationTemplate
{
    Title = "Masked App Name",
    Severity = Enum_Severity.Error.ToString(),
    MessageData = new Dictionary<string, string>()
};

_Message.MessageData = DataCollectionPoints.GetExptionKeys(
    _Message.MessageData,
    ex.Message.ToString(),
    ex.Source.ToString(),
    ex.StackTrace.ToString()
);

_Message.MessageData = DataCollectionPoints.RequestModelData(
    _Message.MessageData, 
    _Message
);
Or If AspNet Core
_Message.MessageData = await DataCollectionPoints.AspNetLogExceptionAsync(HttpContext, _env, ex, DateTime.Now, Data);

var teamsResponse = await Obj.SendTeamsMessage(_Message);

Sending a Message to WhatsApp

var whatsappResponse = await Obj.SendWhatsAppMessage(new SendWhatsAppMessage
{
    Content = "HI",
    MobileNo = "XXXXXXXXXX"
});

Fetching WhatsApp Templates

var _templateList = await Obj.GetWhatsAppTemplate(new WhatsAppTemplatesList { });

foreach (var key in _templateList.result.First().Keywords.Keys.ToList())
{
    _templateList.result.First().Keywords[key] = "XXX";
}

foreach (var key in _templateList.result.First().QuickButton.Keys.ToList())
{
    _templateList.result.First().QuickButton[key] = "XXX";
}

Sending a WhatsApp Template Message

var _Template = new SendWhatsAppTemplate
{
    templateName = _templateList.result.First().TemplateName,
    Keywords = _templateList.result.First().Keywords,
    QuickButton = _templateList.result.First().QuickButton,
    MobileNo = "XXXXXXXXXX",
};

var templateResponse = await Obj.SendWhatsAppTemplate(_Template);

License

This project is licensed under the MIT License.

Contact

For support or inquiries, contact VMade Software Solutions Private Limited.