SplatDev.Messaging.Twilio 2.0.0

SplatDev.Messaging.Twilio

Twilio SMS provider for SplatDev.Messaging — sends SMS messages via the Twilio Programmable SMS API using the official Twilio SDK.

Compatibility

Installation

dotnet add package SplatDev.Messaging.Twilio

Configuration

Constructor

using SplatDev.Messaging.Twilio.Controllers;

var twilio = new TwilioSmsController(
    accountSid: "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    authToken: "your-auth-token");

• accountSid — Your Twilio Account SID (starts with AC)
• authToken — Your Twilio Auth Token

DI registration (recommended)

builder.Services.AddSingleton<TwilioSmsController>(sp =>
{
    var accountSid = builder.Configuration["Twilio:AccountSid"];
    var authToken = builder.Configuration["Twilio:AuthToken"];
    return new TwilioSmsController(accountSid!, authToken!);
});

appsettings.json

{
  "Twilio": {
    "AccountSid": "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "AuthToken": "your-auth-token"
  }
}

Usage

using SplatDev.Messaging.Twilio.Controllers;
using SplatDev.Messaging.Twilio.Models;

// Send via Sms model
var sms = new Sms
{
    From = new Twilio.Types.PhoneNumber("+1234567890"),
    To = new Twilio.Types.PhoneNumber("+5511999999999"),
    Body = "Your verification code is 123456"
};

var result = twilio.SendMessage(sms);
Console.WriteLine($"SID: {result.Sid}, Status: {result.Status}");

// Send via string parameters (simpler API)
var resultAsync = await twilio.SendMessageAsync(
    subject: "",                          // Not used for SMS
    from: "",
    fromAddress: "+1234567890",
    to: "",
    toAddress: "+5511999999999",
    message: "",                          // Not used for SMS
    plainMessage: "Your order #1234 has shipped!");

Features

• Implements IMessagingController<Sms, MessageResource> from SplatDev.Messaging
• True async via MessageResource.CreateAsync
• Sync wrapper via MessageResource.Create
• Uses official Twilio SDK v7.x (not REST directly)
• E.164 phone number format required for fromAddress and toAddress
• The string-parameter API overload maps plainMessage to the SMS body (subject, from, to, message are ignored for SMS context)

Dependencies

No additional HTTP client library required — the Twilio SDK handles transport.

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

Changelog

2.0.0 — 2026-08-25

Breaking. SplatDev.Messaging.Twilio.Models.Sms is removed. Use SplatDev.Messaging.Models.Sms instead — the same three properties, with From and To as plain strings rather than Twilio's PhoneNumber, so the calling code no longer needs a Twilio type to describe a message. TwilioSmsController now implements the shared ISmsMessagingController<Sms, MessageResource> contract and gains (from, to, body) overloads. Also adds TwilioOptions and AddSplatDevTwilio(configuration) for configuration-based registration.

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.