wip: Skeleton of webhook example

Author: filipetoscano

examples/README.md

@@ -12,6 +12,7 @@
 | [WebControllerApi](https://github.com/resend/resend-dotnet/tree/master/examples/WebControllerApi) | 5000 | Send email from a controller
 | [WebMinimalApi](https://github.com/resend/resend-dotnet/tree/master/examples/WebMinimalApi) | 5001 | Send email from a (minimal) API
 | [WebRazor](https://github.com/resend/resend-dotnet/tree/master/examples/WebRazor)           | 5002 | Send email from a Razor form
+| [WebWebhook](https://github.com/resend/resend-dotnet/tree/master/examples/WebWebhook)       | 5007 | Receive webhook events from Resend
 
 
 Async

examples/WebWebhook/Program.cs

@@ -0,0 +1,57 @@
+using Microsoft.AspNetCore.Mvc;
+using Resend;
+
+
+/*
+ * 
+ */
+var builder = WebApplication.CreateBuilder( args );
+
+builder.Services.AddResendWebhooks( o =>
+{
+    o.Secret = Environment.GetEnvironmentVariable( "RESEND_WEBHOOK_SECRET" )!;
+} );
+
+
+builder.Services.AddOptions();
+builder.Services.Configure<ResendClientOptions>( o =>
+{
+    o.ApiToken = Environment.GetEnvironmentVariable( "RESEND_APITOKEN" )!;
+} );
+builder.Services.AddHttpClient<ResendClient>();
+builder.Services.AddTransient<IResend, ResendClient>();
+
+
+/*
+ * 
+ */
+var app = builder.Build();
+
+app.MapResendWebhook( "/webhook" );
+
+app.MapPost( "/email/send", async ( [FromServices] IResend resend, [FromServices] ILogger<EmailSend> logger ) =>
+{
+    var message = new EmailMessage();
+    message.From = "[email protected]";
+    message.To.Add( "[email protected]" );
+    message.Subject = "Hello from Minimal API";
+    message.TextBody = "Email using Resend .NET SDK";
+
+    var resp = await resend.EmailSendAsync( message );
+
+    logger.LogInformation( "Sent email, with Id = {EmailId}", resp.Content );
+
+    return Results.Ok();
+} );
+
+
+/*
+ * 
+ */
+app.Run();
+
+
+/*
+ * 
+ */
+public class EmailSend { };

examples/WebWebhook/Properties/launchSettings.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "http://json.schemastore.org/launchsettings.json",
+  "iisSettings": {
+    "windowsAuthentication": false,
+    "anonymousAuthentication": true,
+    "iisExpress": {
+      "applicationUrl": "http://localhost:5007",
+      "sslPort": 0
+    }
+  },
+  "profiles": {
+    "http": {
+      "commandName": "Project",
+      "dotnetRunMessages": true,
+      "launchBrowser": false,
+      "launchUrl": "email/send",
+      "applicationUrl": "http://localhost:5007",
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development"
+      }
+    },
+    "IIS Express": {
+      "commandName": "IISExpress",
+      "launchBrowser": false,
+      "launchUrl": "email/send",
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development"
+      }
+    }
+  }
+}

examples/WebWebhook/README.md

@@ -0,0 +1,27 @@
+.NET SDK: ASP.NET - Webhook
+=====================================================================
+
+This example shows how to receive webhook events from Resend.
+
+
+How to run
+---------------------------------------------------------------------
+
+1. Create a Webhook on the Resend dashboard
+   - Go to the [Webhooks page](https://resend.com/webhooks)
+   - The endpoint URL needs to be HTTPS (You can use [Ngrok](https://ngrok.com/) to point to the dotnet app)
+   - Copy the Webhook signing secret after creating the Webhook
+
+2. Set the `RESEND_WEBHOOK_SECRET` environment variable to your Webhook
+
+
+1. Set the `RESEND_APITOKEN` environment variable to your Resend API.
+2. Edit the `From` and `To` in the `Program.cs` as necessary.
+3. Run the console app with `dotnet run`.
+4. Make a `POST` request to `http://localhost:5007/email/send`
+
+```bash
+set RESEND_WEBHOOK_SECRET=whsec_alJairX6NuQxWqjdF8PIQd48gh2IQOHl
+set RESEND_APITOKEN=re_8m9gwsVG_6n94KaJkJ42Yj6qSeVvLq9xF
+dotnet run
+```

examples/WebWebhook/WebWebhook.csproj

@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk.Web">
+
+  <PropertyGroup>
+    <TargetFramework>net8.0</TargetFramework>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\..\src\Resend.Webhooks\Resend.Webhooks.csproj" />
+    <ProjectReference Include="..\..\src\Resend\Resend.csproj" />
+  </ItemGroup>
+
+</Project>

examples/WebWebhook/WebhookHandler.cs

@@ -0,0 +1,34 @@
+using Resend.Webhooks;
+
+namespace WebWebhook;
+
+public class WebhookHandler : IWebhookHandler
+{
+    private readonly ILogger<WebhookHandler> _logger;
+
+
+    public WebhookHandler( ILogger<WebhookHandler> logger )
+    {
+        _logger = logger;
+    }
+
+
+    /// <summary />
+    public async Task<IResult> HandleInvalid( WebhookContext context )
+    {
+        await Task.Delay( 0 );
+
+        return Results.NoContent();
+    }
+
+
+    /// <summary />
+    public async Task<IResult> HandleValid( WebhookContext context )
+    {
+        await Task.Yield();
+
+        _logger.LogInformation( "", context.MessageId, context.Event );
+
+        return Results.NoContent();
+    }
+}

examples/WebWebhook/appsettings.json

@@ -0,0 +1,9 @@
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft.AspNetCore": "Warning"
+    }
+  },
+  "AllowedHosts": "*"
+}