AsthaIT.SMSGateway 1.0.0

# AIT.Packages.SMSGateway

A .NET client library for sending SMS messages through the SMS Gateway. It offers a straightforward interface for sending both single and bulk messages via the API.

AITSSLWirelessSMSClient

This client is designed to work with the SSL Wireless SMS Gateway, allowing developers to easily integrate SMS functionality into their .NET applications. It supports both single and bulk SMS sending, with strong typing for request and response models.

Features

• Send single SMS messages asynchronously
• Send bulk SMS messages asynchronously
• Strongly-typed request and response models
• Designed for .NET 8 and .NET 9

Installation

dotnet add package AsthaIT.SMSGateway

Usage

Initialization

using AIT.Packages.SMSGateway.SSLWireless;
var client = new AITSSLWirelessSMSClient( apiToken: "your_api_token", sId: "your_sid", url: "your_gateway_urrl" );

Send a Single SMS

var singleRequest = new SingleSMSRequest
{
    RecipientNumber = "01XXXXXXXXX",
    SMSBody = "Hello from ASTHAIT!",
    CsmsId = DateTime.UtcNow.Ticks.ToString("D18") // Each SMS will have a unique 18-character alphanumeric reference ID. The CsmsId will be unique for the same day only.
};

var response = await client.SendSMSAsync(singleRequest);

if (response.IsSuccess)
{
    if (response.Status == SMSStatus.SUCCESS)
    {
        Console.WriteLine($"Message sent successfully: {response.Status}");
    }
    else
    {
        Console.WriteLine($"Message sending failed: {response.ErrorMessage}");
    }
}
else
{
    Console.WriteLine($"Failed to send message: {response.ErrorMessage}");
}

Send Bulk SMS

var bulkRequest = new BulkSMSRequest
{
    RecipientNumbers = new List<string>
    {
        "01XXXXXXXXX",
        "01YYYYYYYYY"
    },
    SMSBody = "Hello from ASTHAIT!",
    CsmsId = DateTime.UtcNow.Ticks.ToString("D18")
};

var bulkResponse = await client.SendBulkSMSAsync(bulkRequest);

if (bulkResponse.IsSuccess)
{
    if (bulkResponse.Data.Status == SMSStatus.SUCCESS)
    {
        foreach (var message in bulkResponse.Data.Messages)
        {
            Console.WriteLine($"Message sent successfully: {message.Status}");
        }
    }
    else
    {
        Console.WriteLine($"Message sending failed: {bulkResponse.Data.ErrorMessage}");
    }
}
else
{
    Console.WriteLine($"Failed to send bulk messages: {bulkResponse.ErrorMessage}");
}

Configuration

• ApiToken: Provided by SSL Wireless.
• SID: Sender ID, provided by SSL Wireless.
• HostUrl: API endpoint URL (differs for single and bulk SMS). Provided by SSL Wireless

License

MIT License

Author

Developed and maintained by AIT.