FahdCloud.ThirdParty.SMS 10.0.6

FahdCloud.ThirdParty.SMS

FahdCloud.ThirdParty.SMS provides stateless SMS services for:

• SMS Masr
• Taqnyat SMS

Each call receives provider settings explicitly. Provider base URLs are fixed inside the library.

Installation

dotnet add package FahdCloud.ThirdParty.SMS

Registration

using FahdCloud.ThirdParty.SMS.DependencyInjection;

builder.Services.AddSmsProviders();

Or register a single provider:

builder.Services.AddSmsMasr();
builder.Services.AddTaqnyatSms();

SMS Masr Example

using FahdCloud.ThirdParty.SMS.Abstractions;
using FahdCloud.ThirdParty.SMS.Models;
using FahdCloud.ThirdParty.SMS.Providers.SmsMasr;

public sealed class SmsMasrSender(ISmsMasrService smsMasrService)
{
    public Task<SmsSendResponse> SendAsync(CancellationToken cancellationToken)
    {
        var settings = new SmsMasrSettings
        {
            Username = "your-user",
            Password = "your-password",
            SenderToken = "your-sender-token",
            Environment = 2
        };

        var request = new SmsSendRequest
        {
            To = ["201001234567"],
            Message = "Hello from FahdCloud SMS",
            Language = SmsMessageLanguage.English
        };

        return smsMasrService.SendMessageAsync(settings, request, cancellationToken);
    }
}

SMS Masr OTP Example

using FahdCloud.ThirdParty.SMS.Providers.SmsMasr;

public sealed class OtpSender(ISmsMasrService smsMasrService)
{
    public Task SendAsync(CancellationToken cancellationToken)
    {
        var settings = new SmsMasrSettings
        {
            Username = "your-user",
            Password = "your-password",
            SenderToken = "your-sender-token",
            Environment = 2
        };

        return smsMasrService.SendOtpAsync(settings, new SmsMasrOtpRequest
        {
            Mobile = "+201001234567",
            TemplateToken = "template-token",
            Otp = "123456"
        }, cancellationToken);
    }
}

Taqnyat Example

using FahdCloud.ThirdParty.SMS.Models;
using FahdCloud.ThirdParty.SMS.Providers.Taqnyat;

public sealed class TaqnyatSender(ITaqnyatSmsService taqnyatSmsService)
{
    public Task<SmsSendResponse> SendAsync(CancellationToken cancellationToken)
    {
        var settings = new TaqnyatSmsSettings
        {
            BearerToken = "your-bearer-token",
            DefaultSender = "YourSender"
        };

        var request = new SmsSendRequest
        {
            To = ["966500000000"],
            Message = "Hello from FahdCloud SMS"
        };

        return taqnyatSmsService.SendMessageAsync(settings, request, cancellationToken);
    }
}

Taqnyat Scheduled Message Example

using FahdCloud.ThirdParty.SMS.Providers.Taqnyat;

public sealed class ScheduledSmsSender(ITaqnyatSmsService taqnyatSmsService)
{
    public Task SendAsync(CancellationToken cancellationToken)
    {
        var settings = new TaqnyatSmsSettings
        {
            BearerToken = "your-bearer-token",
            DefaultSender = "YourSender"
        };

        return taqnyatSmsService.SendScheduledMessageAsync(settings, new TaqnyatScheduledMessageRequest
        {
            Recipients = ["966500000000"],
            Body = "Scheduled hello",
            ScheduledAt = DateTimeOffset.UtcNow.AddHours(1)
        }, cancellationToken);
    }
}

Provider Operations

SMS Masr

• SendMessageAsync(settings, request)
• SendOtpAsync(settings, request)
• GetBalanceAsync(settings)

Taqnyat

• SendMessageAsync(settings, request)
• SendScheduledMessageAsync(settings, request)
• DeleteScheduledMessageAsync(settings, deleteId)
• GetBalanceAsync(settings)
• GetSendersAsync(settings)

Notes

• Services are stateless.
• Provider base URLs are internal constants in the library.
• Phone numbers are normalized to international format without + or leading 00.
• SMS Masr sends multiple recipients as a comma-separated mobile value.
• Taqnyat sends recipients as a JSON array and authenticates with bearer token.
• Refit is used internally for provider API contracts.

Test Project

The test project is a console-based integration harness.

Files:

• Program.cs
• SmsTestRunner.cs
• SmsMasrServiceTest.cs
• TaqnyatSmsServiceTest.cs
• appsettings.json

To use it:

1. Fill in provider credentials and test recipients in tests/FahdCloud.ThirdParty.SMS.Tests/appsettings.json.
2. Run the test project.
3. Choose the provider from the console menu.