SMSService

DeltaCore.SMSService

Overview 📚

DeltaCore.SMSService is a lightweight .NET 8 library that simplifies sending and verifying OTPs via SMS or call using Twilio Verify API, and sending custom messages using Twilio Messaging API.
It also includes a simple throttling mechanism to prevent sending OTPs within 60 seconds to the same number.

✅ Send OTPs via SMS or call
✅ Verify OTPs easily
✅ Send custom text messages
✅ Prevent spamming (resending OTP within 60 seconds)
✅ Built-in error handling and logging

---

Install from NuGet 📦

You can install the package from NuGet:

dotnet add package DeltaCore.SMSService

or via the Package Manager Console:

Install-Package DeltaCore.SMSService

---

Using in Your App 🚀

• Configure TwilioSettings In your appsettings.json, add:

{
  "TwilioSettings": {
    "AccountSID": "your_account_sid",
    "AuthToken": "your_auth_token",
    "TwilioPhoneNumber": "your_twilio_phone_number",
    "VerifyServiceSID": "your_verify_service_sid"
  }
}

• Register the Service in Startup.cs or Program.cs

builder.Services.Configure<TwilioSettings>(builder.Configuration.GetSection("TwilioSettings"));
builder.Services.AddSingleton<ISMSService, TwilioService>();

• Using ISMSService in Your Application Inject ISMSService where needed, for example in a controller or service:

public class AccountController : ControllerBase
{
    private readonly ISMSService _smsService;

    public AccountController(ISMSService smsService)
    {
        _smsService = smsService;
    }

    [HttpPost("send-otp")]
    public async Task<IActionResult> SendOtp(string phoneNumber)
    {
        var verificationSid = await _smsService.SendOTPAsync(phoneNumber);
        if (verificationSid == null)
            return BadRequest("OTP was sent recently. Please wait.");
        
        return Ok(new { verificationSid });
    }

    [HttpPost("verify-otp")]
    public async Task<IActionResult> VerifyOtp(string phoneNumber, string code)
    {
        var isValid = await _smsService.VerifyOTPAsync(phoneNumber, code);
        if (!isValid)
            return BadRequest("Invalid or expired OTP.");

        return Ok("OTP verified successfully.");
    }

    [HttpPost("send-message")]
    public async Task<IActionResult> SendMessage(string phoneNumber, string message)
    {
        var isSent = await _smsService.SendMessageAsync(phoneNumber, message);
        if (!isSent)
            return BadRequest("Failed to send message.");

        return Ok("Message sent successfully.");
    }
}

---

Important Notes 📝

• OTP requests are rate-limited: the same number cannot request a new OTP within 60 seconds.

• Errors during sending/verification are logged using ILogger.

• Supports both SMS and voice calls when sending OTPs by specifying the channel parameter.

---

License 🛡️

This project is licensed under the MIT License.

---

Support

If you encounter any issues or have questions about using DeltaCore.SMSService, feel free to create an issue on GitHub or reach out to us.

---

Author

👤 Ahmed Nady