SplatDev.Messaging.SocketLabs 1.0.2

SplatDev.Messaging.SocketLabs

SocketLabs email provider for SplatDev.Messaging — sends transactional and bulk emails via the SocketLabs Injection API using the SocketLabs.EmailDelivery SDK.

Compatibility

Installation

dotnet add package SplatDev.Messaging.SocketLabs

Configuration

Constructor

using SplatDev.Messaging.SocketLabs.Controllers;

var socketLabs = new SocketLabsController(
    serverId: 12345,
    injectionApiKey: "your-socketlabs-injection-api-key");

• serverId — Your SocketLabs server ID (integer)
• injectionApiKey — Your SocketLabs Injection API key

DI registration (recommended)

builder.Services.AddSingleton<SocketLabsController>(sp =>
{
    var serverId = int.Parse(builder.Configuration["SocketLabs:ServerId"]!);
    var apiKey = builder.Configuration["SocketLabs:InjectionApiKey"];
    return new SocketLabsController(serverId, apiKey!);
});

appsettings.json

{
  "SocketLabs": {
    "ServerId": "12345",
    "InjectionApiKey": "your-injection-api-key"
  }
}

Usage

Single message

using SplatDev.Messaging.Interfaces;

var result = socketLabs.SendMessage(
    subject: "Welcome!",
    from: "SplatDev",
    fromAddress: "no-reply@example.com",
    to: "Customer",
    toAddress: "customer@example.com",
    message: "<h1>Welcome aboard!</h1>",
    plainMessage: "Welcome aboard!");

// Async
var resultAsync = await socketLabs.SendMessageAsync(
    subject: "Invoice",
    from: "Billing",
    fromAddress: "billing@example.com",
    to: "Customer",
    toAddress: "customer@example.com",
    message: "<p>Your invoice is ready</p>",
    plainMessage: "Your invoice is ready");

Bulk message

using SplatDev.Messaging.SocketLabs.Controllers;
using SplatDev.Messaging.SocketLabs.Models;

var bulk = new SocketLabsBulkController(serverId, injectionApiKey);

var addresses = new List<BulkAddress>
{
    new BulkAddress { Email = "user1@example.com", FriendlyName = "User One" },
    new BulkAddress { Email = "user2@example.com", FriendlyName = "User Two" }
};

var message = new BulkMessageData
{
    Subject = "Newsletter #42",
    HtmlBody = "<h1>Latest updates</h1>",
    PlainTextBody = "Latest updates",
    From = new BulkAddress { Email = "newsletter@example.com" }
};

var response = bulk.SendBulkMessage(addresses, message);

Features

• SocketLabsController — single-message IMessagingController<BasicMessage, SendResponse> implementation
• SocketLabsBulkController — bulk email via IBulkMessagingController<BulkMessageData, SendResponse>
• BulkAddress and BulkMessageData models for merge-style bulk sending
• Sync and async delivery methods
• Uses official SocketLabs.EmailDelivery SDK

Supported operations

Dependencies

SplatDev.Messaging.SocketLabs — part of the SplatDev.Umbraco.Plugins suite. Licensed under MIT. © SplatDev Ltda.

Changelog

1.0.2 — 2026-08-24

Removes a dashboard screenshot that showed an error toast. It was captured against a site where this plugin's API was unreachable, so it advertised a broken dashboard. No screenshot is better than a misleading one; a replacement will be taken against a working install.

1.0.1 — 2026-08-24

Package metadata only: the listing now carries an icon and search tags, and the project and repository links point at the organisation that actually hosts this code. No code changes.

1.0.0 — 2026-08-24

This package now keeps a changelog. Earlier releases predate it and are not reconstructed here — consult the repository history for those. From this version on, every release records what changed for someone using it.