Sendgrid .NET (Comment ça marche pour les développeurs)

SendGridqui fait partie de Twilio SendGrid, offre un service basé sur le cloud pour aider les clients à envoyer des courriels simplement, en rationalisant les processus de communication. Lorsque vous créez un compte SendGrid, vous avez accès à des fonctionnalités telles que le relais SMTP et les clés API. Il permet d'envoyer des messages électroniques de manière efficace. Le relais SMTP est au cœur de ce processus car il permet d'envoyer vos courriels depuis votre serveur via le système de SendGrid. La fonction de domaine authentifié vérifie votre domaine. SendGrid étant un logiciel libre, vous pouvez accéder à son répertoire GitHub et contribuer à le modifier.

Dans ce guide, nous avons pour objectif de décortiquer les caractéristiques et les fonctionnalités de SendGrid .NET, en vous guidant à travers l'installation initiale, les opérations de base et les caractéristiques plus avancées. Que vous souhaitiez envoyer votre premier courriel par le biais d'un code ou optimiser vos campagnes de courriel, cet article est votre point de départ pour maîtriser SendGrid .NET et son intégration à IronPDF.

Premiers pas avec SendGrid .NET

Tout d'abord, vous devez installer SendGrid .NET dans votre projet. Commencez par installer le paquetage SendGrid .NET. Utilisez pour cela le gestionnaire de paquets NuGet. Ouvrez Visual Studio, puis la console du gestionnaire de paquets. Tapez la commande suivante :

Install-Package SendGrid

Cette commande ajoute SendGrid à votre projet. Après l'installation, configurez votre compte SendGrid. Vous avez besoin d'une clé API. Aller à la page Site web de SendGrid. Créez un compte si vous n'en avez pas. Une fois connecté, accédez à la rubrique Paramètres. Trouver les clés API. Cliquez sur Créer une clé API. Donnez-lui un nom et sélectionnez le niveau d'accès. Copiez la clé API. Vous l'utiliserez dans votre application.

Exemple de code de base

Envoyons maintenant un courriel. Créer une nouvelle instance du SendGridClient. Transmettez votre clé API au constructeur. Ensuite, créez un SendGridMessage. Définissez les adresses électroniques de l'expéditeur et du destinataire. Ajoutez un objet et le contenu de l'e-mail. Enfin, utilisez SendGridClient pour envoyer le message. Voici un exemple de base :

var client = new SendGridClient("your_api_key");
var message = new SendGridMessage()
{
    From = new EmailAddress("your_email@example.com", "Your Name"),
    Subject = "Hello World from SendGrid",
    PlainTextContent = "This is a test email.",
    HtmlContent = "<strong>This is a test email.</strong>"
};
message.AddTo(new EmailAddress("recipient_email@example.com", "Recipient Name"));
var response = await client.SendEmailAsync(message);

var client = new SendGridClient("your_api_key");
var message = new SendGridMessage()
{
    From = new EmailAddress("your_email@example.com", "Your Name"),
    Subject = "Hello World from SendGrid",
    PlainTextContent = "This is a test email.",
    HtmlContent = "<strong>This is a test email.</strong>"
};
message.AddTo(new EmailAddress("recipient_email@example.com", "Recipient Name"));
var response = await client.SendEmailAsync(message);

Dim client = New SendGridClient("your_api_key")
Dim message = New SendGridMessage() With {
	.From = New EmailAddress("your_email@example.com", "Your Name"),
	.Subject = "Hello World from SendGrid",
	.PlainTextContent = "This is a test email.",
	.HtmlContent = "<strong>This is a test email.</strong>"
}
message.AddTo(New EmailAddress("recipient_email@example.com", "Recipient Name"))
Dim response = Await client.SendEmailAsync(message)

Ce code envoie un simple courrier électronique. Il présente les bases de l'utilisation de SendGrid .NET. Vous pouvez étendre votre champ d'action à d'autres fonctions.

Caractéristiques de la mise en œuvre de SendGrid .NET

Envoi d'e-mails avec un contenu HTML personnalisé

Pour envoyer un courrier électronique avec un contenu HTML, vous devez d'abord créer votre HTML. Ensuite, utilisez SendGridMessage pour définir HtmlContent. Cela vous permet de concevoir des courriels riches. Voici comment :

var client = new SendGridClient("your_api_key");
var message = new SendGridMessage()
{
    From = new EmailAddress("your_email@example.com", "Your Name"),
    Subject = "Custom HTML Content",
    HtmlContent = "<html><body><h1>This is a Heading</h1><p>This is a paragraph.</p></body></html>"
};
message.AddTo(new EmailAddress("recipient_email@example.com", "Recipient Name"));
var response = await client.SendEmailAsync(message);

var client = new SendGridClient("your_api_key");
var message = new SendGridMessage()
{
    From = new EmailAddress("your_email@example.com", "Your Name"),
    Subject = "Custom HTML Content",
    HtmlContent = "<html><body><h1>This is a Heading</h1><p>This is a paragraph.</p></body></html>"
};
message.AddTo(new EmailAddress("recipient_email@example.com", "Recipient Name"));
var response = await client.SendEmailAsync(message);

Dim client = New SendGridClient("your_api_key")
Dim message = New SendGridMessage() With {
	.From = New EmailAddress("your_email@example.com", "Your Name"),
	.Subject = "Custom HTML Content",
	.HtmlContent = "<html><body><h1>This is a Heading</h1><p>This is a paragraph.</p></body></html>"
}
message.AddTo(New EmailAddress("recipient_email@example.com", "Recipient Name"))
Dim response = Await client.SendEmailAsync(message)

Utilisation du service SMTP de SendGrid

Parfois, vous pouvez préférer le protocole SMTP pour envoyer des courriels. SendGrid prend également en charge cette fonction. Configurez vos paramètres SMTP dans SendGrid. Utilisez ensuite ces paramètres dans votre application. Cette méthode nécessite la configuration d'un client SMTP avec les détails du serveur de SendGrid. Voici une configuration de base :

var client = new SmtpClient("smtp.sendgrid.net")
{
    Port = 587,
    Credentials = new NetworkCredential("apikey", "your_sendgrid_apikey"),
    EnableSsl = true,
};
var mailMessage = new MailMessage
{
    From = new MailAddress("your_email@example.com"),
    Subject = "Test SMTP Email",
    Body = "This is a test email sent via SMTP.",
    IsBodyHtml = true,
};
mailMessage.To.Add("recipient_email@example.com");
client.Send(mailMessage);

var client = new SmtpClient("smtp.sendgrid.net")
{
    Port = 587,
    Credentials = new NetworkCredential("apikey", "your_sendgrid_apikey"),
    EnableSsl = true,
};
var mailMessage = new MailMessage
{
    From = new MailAddress("your_email@example.com"),
    Subject = "Test SMTP Email",
    Body = "This is a test email sent via SMTP.",
    IsBodyHtml = true,
};
mailMessage.To.Add("recipient_email@example.com");
client.Send(mailMessage);

Dim client = New SmtpClient("smtp.sendgrid.net") With {
	.Port = 587,
	.Credentials = New NetworkCredential("apikey", "your_sendgrid_apikey"),
	.EnableSsl = True
}
Dim mailMessage As New MailMessage With {
	.From = New MailAddress("your_email@example.com"),
	.Subject = "Test SMTP Email",
	.Body = "This is a test email sent via SMTP.",
	.IsBodyHtml = True
}
mailMessage.To.Add("recipient_email@example.com")
client.Send(mailMessage)

Gestion des campagnes de courrier électronique

SendGrid .NET permet de gérer des campagnes de courrier électronique. Créez, envoyez et suivez des campagnes par le biais de l'API. Pour une gestion détaillée des campagnes, reportez-vous à la documentation API de SendGrid. Cette fonction va au-delà de l'envoi de courriels de base, mais elle est très utile pour les efforts de marketing.

Traitement des courriels rebondis et des rapports de spam

Il est essentiel de gérer les rebonds et les rapports de spam. SendGrid .NET fournit des webhooks pour ces événements. Configurez les webhooks dans votre tableau de bord SendGrid. Traitez ensuite ces événements dans votre application. Cela permet de maintenir votre liste d'adresses électroniques propre et d'améliorer le taux de distribution.

Authentification des domaines

L'authentification du domaine est importante pour la délivrabilité du courrier électronique. Il vérifie la propriété de votre domaine. Dans SendGrid, configurez l'authentification du domaine via le tableau de bord. Il s'agit d'ajouter des enregistrements DNS. Une fois vérifiés, les messages électroniques paraissent plus fiables aux destinataires et aux fournisseurs d'accès.

Intégrer IronPDF à SendGrid

Présentation d'IronPDF

IronPDF est une bibliothèque qui permet aux développeurs de créer, de modifier et d'extraire du contenu PDF dans des applications .NET. Il fournit une approche simple pour traiter les fichiers PDF par programme. Il facilite le travail avec les fichiers PDF sans nécessiter de connaissances approfondies des spécifications PDF. Avec IronPDF, les développeurs peuvent convertir HTML en PDF, de modifier des PDF existants et d'en extraire le contenu.

Cas d'utilisation de la fusion d'IronPDF avec SendGrid C&num ;

Dans une application commerciale, les rapports financiers, les factures ou les documents personnalisés doivent être générés de manière dynamique et envoyés aux clients ou aux parties prenantes par courrier électronique. IronPDF peut être utilisé pour créer ces documents à partir de modèles ou de sources de données, en les convertissant au format PDF. Ensuite, à l'aide du client C# de SendGrid, ces documents PDF peuvent être joints à des courriels et envoyés automatiquement aux destinataires prévus.

Installer la bibliothèque IronPDF

Pour utiliser IronPDF, vous devez d'abord installer le paquet NuGet. Tout d'abord, ouvrez la console NuGet Package Manager, puis exécutez la commande suivante :

Install-Package IronPdf

Exemple de code de cas d'utilisation avec détails et étapes

Étape 1 : Générer un fichier PDF avec IronPDF

Tout d'abord, nous générons un document PDF. Nous allons créer un PDF simple à partir d'une chaîne HTML.

using IronPdf;
var Renderer = new HtmlToPdf();
var PDF = Renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");
var outputPath = "example.pdf";
PDF.SaveAs(outputPath);

using IronPdf;
var Renderer = new HtmlToPdf();
var PDF = Renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");
var outputPath = "example.pdf";
PDF.SaveAs(outputPath);

Imports IronPdf
Private Renderer = New HtmlToPdf()
Private PDF = Renderer.RenderHtmlAsPdf("<h1>Hello World</h1>")
Private outputPath = "example.pdf"
PDF.SaveAs(outputPath)

Étape 2 : Configurer SendGrid

Assurez-vous que le paquetage NuGet SendGrid est installé :

Install-Package SendGrid

Configurez ensuite SendGrid dans votre application. Vous aurez besoin d'une clé API de votre compte SendGrid.

using SendGrid;
using SendGrid.Helpers.Mail;
var apiKey = "your_sendgrid_api_key";
var client = new SendGridClient(apiKey);

using SendGrid;
using SendGrid.Helpers.Mail;
var apiKey = "your_sendgrid_api_key";
var client = new SendGridClient(apiKey);

Imports SendGrid
Imports SendGrid.Helpers.Mail
Private apiKey = "your_sendgrid_api_key"
Private client = New SendGridClient(apiKey)

Étape 3 : Créer et envoyer un courriel avec une pièce jointe au format PDF

Créez maintenant un message électronique et joignez-y le PDF généré précédemment. Enfin, envoyez le courrier électronique par l'intermédiaire de SendGrid.

var from = new EmailAddress("your_email@example.com", "Your Name");
var subject = "Sending with SendGrid is Fun";
var to = new EmailAddress("recipient_email@example.com", "Recipient Name");
var plainTextContent = "Hello, Email!";
var htmlContent = "<strong>Hello, Email!</strong>";
var msg = MailHelper.CreateSingleEmail(from, to, subject, plainTextContent, htmlContent);
// Attach the PDF
var bytes = File.ReadAllBytes(outputPath);
var file = Convert.ToBase64String(bytes);
msg.AddAttachment("example.pdf", file);
var response = await client.SendEmailAsync(msg);

var from = new EmailAddress("your_email@example.com", "Your Name");
var subject = "Sending with SendGrid is Fun";
var to = new EmailAddress("recipient_email@example.com", "Recipient Name");
var plainTextContent = "Hello, Email!";
var htmlContent = "<strong>Hello, Email!</strong>";
var msg = MailHelper.CreateSingleEmail(from, to, subject, plainTextContent, htmlContent);
// Attach the PDF
var bytes = File.ReadAllBytes(outputPath);
var file = Convert.ToBase64String(bytes);
msg.AddAttachment("example.pdf", file);
var response = await client.SendEmailAsync(msg);

Dim from = New EmailAddress("your_email@example.com", "Your Name")
Dim subject = "Sending with SendGrid is Fun"
Dim [to] = New EmailAddress("recipient_email@example.com", "Recipient Name")
Dim plainTextContent = "Hello, Email!"
Dim htmlContent = "<strong>Hello, Email!</strong>"
Dim msg = MailHelper.CreateSingleEmail(from, [to], subject, plainTextContent, htmlContent)
' Attach the PDF
Dim bytes = File.ReadAllBytes(outputPath)
Dim file = Convert.ToBase64String(bytes)
msg.AddAttachment("example.pdf", file)
Dim response = Await client.SendEmailAsync(msg)

Cet exemple de code illustre la génération d'un simple document PDF, sa mise en pièce jointe dans un courrier électronique et son envoi via SendGrid. Il s'agit d'un processus simple qui intègre les capacités de génération de documents et de courrier électronique d'IronPDF et de SendGrid, respectivement, dans une application .NET.

Conclusion

En conclusion, ce guide fournit un aperçu complet de l'intégration de SendGrid .NET pour les services de courrier électronique et d'IronPDF pour la gestion des documents PDF au sein des applications .NET. En suivant les étapes décrites, les développeurs peuvent mettre en œuvre efficacement des fonctionnalités d'envoi de courrier électronique avec un contenu HTML personnalisable et des options de service SMTP, et gérer des campagnes de courrier électronique.

En outre, l'intégration d'IronPDF permet la génération dynamique et l'envoi par courrier électronique de documents PDF, tels que des rapports financiers ou des factures, ce qui illustre un cas d'utilisation pratique de la fusion de ces puissantes bibliothèques. Les développeurs intéressés par l'exploration de ces fonctionnalités peuvent s'appuyer sur l'outil essai gratuit d'IronPDF avant de s'engager dans une licence. Licence à partir de 749 $.