CovenirBPO.Packages.SendgridNotificationSystem 1.1.0

Sendgrid Notification Library

For Covenir Integration

2024-01-23 Updated: 2024-05-01

Install the library

Install Nuget package CovenirBPO.Packages.SendgridNotificationSystem

Createing a native IEmailNotificationContent object

In your project solution, create an object that inherits the IEmailNotificationContent interface.

This object will contain the required properties that the notification system will utilize when sending notification emails.

using SendgridNotificationSystem.Lib;

namespace SendgridNotificationSystem.Testing;

internal class EmailNotificationContent : IEmailNotificationContent
{
    public List<string> RecipientAddresses { get; set; } = new List<string>();
    public string Subject { get; set; } = string.Empty; 
    public string BodyContent { get; set; } = string.Empty;

    public void AddRecipientAddress(string recipientAddress)
    {
        RecipientAddresses.Add(recipientAddress);
    }

    public void RemoveRecipientAddress(string recipientAddress)
    {
        for (int i = 0; i < RecipientAddresses.Count; i++)
        {
            if (RecipientAddresses[i]== recipientAddress)
            {
                RecipientAddresses.RemoveAt(i);
                break; 
            }   
        }
    }
}

Set an environment variable

Create a local environment variable on the machine that will be sending notifications:

Add Recipients

In the calling assembly, create a new EmailNotificationContent object.

var content = new EmailNotificationContent
{
	Subject = "Subject of Email",
	BodyContent = "Body of the email"
    TemplateID = "Your Sendgrid Template ID" // Optional for text only emails, required for template-based emails
};

content.AddRecipientAddress("receiver@email.com");

Call the service

using SendgridNotificationSystem; 

. . .
// This will produce a basic text-only email. 
public async Task SendEmail(IEmailNotificationContent content)
{
    await new Lib.SendgridNotificationSystem()
        .SendSendgridEmailAsync(content);
}

. . .
 or
. . .
// This will allow dynamically fill the custom template with the same Email notification content
public async Task SendEmailWithTemplate(IEmailNotificationContent content)
{
	await new Lib.SendgridNotificationSystem()
		.SendSendgridTemplateEmailAsync(content);
})