sms.net.bd NuGet Package Release Note

New Update smsnetbd.Csharp.Client v2.0.0

We are excited to announce the release of version 2.0.0 of the smsnetbd.Csharp.Client NuGet package! This update introduces several significant enhancements and new features to streamline your SMS campaign management and broaden platform support.

New Features

1. Supports a wide range of .NET platform compatibility

To ensure compatibility across all .NET platforms, we've added support for .NET Standard 2.0. This enhancement allows developers to integrate the SMSNetBD.CSharp.Client package into a wide range of .NET applications, including those targeting .NET Framework, .NET Core, Xamarin, and more.

2. Get All Approved Campaign Content List

We have introduced a new method that allows you to retrieve a list of all approved campaign content available in your account. This feature enables you to easily manage and review the content before initiating any SMS campaigns.

3. Send SMS Campaign Content via sms.net.bd API

The latest update also includes a method to send SMS campaign content directly through the sms.net.bd API. This method leverages the campaign content ID to ensure accurate and targeted messaging to your audience.

How to Use the New Features

1. Initializing the SMS Service

To begin, initialize the SMS service with your API key:

	// Initialize SMS client with your API key
	SMS smsClient = new SMS("your-api-key");

2. Get All Approved Campaign Content List

You can now retrieve the list of all approved campaign content by calling the GetCampaigns method. This method sends a GET request to the API and returns a list of campaign content in JSON format.

string campaigns = await smsClient.GetCampaigns();
Console.WriteLine(campaigns);

3. Send SMS Campaign Content

To send an SMS campaign using one of the approved contents, use the CampaignSMS method. This method finds the campaign content by its ID and sends the corresponding SMS to the specified phone number.

string phoneNumber = "01XXXXXXXXX";
string contentId = "XXXXX"; // ID of the approved campaign content

string response = await smsClient.CampaignSMS(phoneNumber, contentId);
Console.WriteLine(response);

We appreciate your continued support and feedback. If you have any questions or encounter any issues, please do not hesitate to contact our support team.

smsnetbd.Csharp.Client v1.0.0

Summary:

The sms.net.bd NuGet package provides a simple interface to send SMS messages using the sms.net.bd API. This release introduces initial support for sending SMS messages, scheduling SMS messages, checking SMS delivery reports, and retrieving account balances.

Initialization:

To start using the sms.net.bd NuGet package, follow these steps:

1. Install the Package: Install the sms.net.bd NuGet package in your project using the following command in the NuGet Package Manager Console:

   NuGet\Install-Package smsnetbd.Csharp.Client

2. Initialize SMS Client: Create an instance of the SMS class by providing your API key. This API key can be obtained from the sms.net.bd API website.

   using sms.net.bd;
   
   // Initialize SMS client with your API key
   SMS smsClient = new SMS("Your-API-Key");

Usage:

After initializing the SMS client, you can use its methods to interact with the sms.net.bd API. Below are the available methods and their usage:

1. SendSMS: Send a text message to a specified phone number.

   // Send SMS message
   string phoneNumber = "01800000000";
   string message = "Hello, world!";
   string sender_id = "xxxxxxx";  //Optional. If you have an approved Sender ID. 
   string response = await smsClient.SendSMS(phoneNumber, message, sender_id);

   Response

   {
     "error": 0,
     "msg": "Request successfully submitted",
     "data": {
       "request_id": 0000
     }
   }

2. ScheduleSMS: Schedule a text message to be sent at a specified time.

   // Schedule SMS message
   string phoneNumber = "01800000000";
   string message = "Hello, world!";
   string scheduleTime = "2023-11-01 12:00:00"; // Specify the scheduled time in ISO 8601 format
   string response = await smsClient.ScheduleSMS(phoneNumber, message, scheduleTime);

   Response

   {
     "error": 0,
     "msg": "Request successfully submitted"
   }

3. GetReport: Retrieve the delivery report of an SMS message.

   // Get SMS delivery report
   int messageId = 12345; // Specify the ID of the SMS message
   string report = await smsClient.GetReport(messageId);

   Response

   {
     "error":0,
     "msg":"Success",
     "data":{"request_id":000000,
   	 "request_status":"Complete",
   	 "request_charge":"0.0000",
   	 "recipients":[
   	  {
   		"number":"01800000000",
   		"charge":"0.0000",
   		"status":"Sent"
   	  }
   	]
     }
   }

4. GetBalance: Retrieve the current account balance.

   // Get account balance
   string balance = await smsClient.GetBalance();

   Response

       {
         "error": 0,
         "msg": "Success",
         "data": {
           "balance": "00.0000"
         }
       }

Error Codes:

Common Errors
Error - 0	Success. Everything worked as expected.
Error - 400	The request was rejected, due to a missing or invalid parameter.
Error - 403	You don't have permissions to perform the request.
Error - 404	The requested resource not found.
Error - 405	Authorization required.
Error - 409	Unknown error occurred on Server end.

Send SMS Errors
Error - 410	Account expired.
Error - 411	Reseller Account expired or suspended.
Error - 412	Invalid Schedule.
Error - 413	Invalid Sender ID.
Error - 414	Message is empty.
Error - 415	Message is too long.
Error - 416	No valid number found.
Error - 417	Insufficient balance.
Error - 418	Content Blocked.

Feedback and Support

We welcome your feedback and suggestions for improving the sms.net.bd NuGet package. If you encounter any issues or have questions, please contact [Your Contact Information] or open an issue on the GitHub repository.

Thank you for using sms.net.bd!

For more details on the sms.net.bd API and its usage, refer to the official API documentation.