.Net Component

Send messages from .Net Apps and ASP.Net

You can use our dotnet component to send message from an ASP.NET web page or Windows Form Application. This component is free to download and use. You can distribute this component with your own SMS enabled applications.

Installation:

You can download the IntelliSoftware .Net SDK from NuGet

Click here for other download options.

Properties:

AccessKey This is your AccessKey used to authenticate to you IntelliSoftware account
Click here to create an AccessKey / SecretKey pair
SecretKey This is your SecretKey used to authenticate to you IntelliSoftware account
Click here to create an AccessKey / SecretKey pair
MaxConCatMsgs Maximum number of concatenated SMS messages that will be sent per recipient (Default is 1)
ProxyAddress (Optional) If a proxy server is required to access the internet then set this property to the address of your proxy server

SendMsg Method

Sends an SMS message via the Internet Gateway.

String SendMsg ( String To, String Text, String From )

Parameters:

To Input This is the destination phone number
Text Input The content of the text message
From Input This is the source/sender's phone number
MessageId Return Unique message ID

Exceptions:

IntelliSMSException Error returned by the IntelliSoftware SMS gateway

C# Example:

using IntelliSoftware;

IntelliSMS objIntelliSMS = new IntelliSMS();

objIntelliSMS.AccessKey = @"Yva$ER%Uhs+UU[MzwEYe";
objIntelliSMS.SecretKey = @"F{kQ^s`wVpm!EU~Bx8yB^A$N$[l{pxJA";

String MessageId = objIntelliSMS.SendMsg 
    ( "44771012345", "Hello", "SENDER_ID" );
    		

SendMsgToMultipleRecipients Method

Sends an SMS message to multiple recipients via the Internet Gateway.

SendStatusCollection SendMsgToMultipleRecipients ( StringCollection To, String Text, String From )

Parameters:

To Input List of destination phone numbers
Text Input The content of the text message
From Input This is the source/sender's phone number
SendStatusCollection Return This collection is populated with the send status for each recipient

Exceptions:

IntelliSMSException Error returned by the IntelliSoftware SMS gateway

C# Example:

using IntelliSoftware;

    IntelliSMS objIntelliSMS = new IntelliSMS();

    objIntelliSMS.AccessKey = @"Yva$ER%Uhs+UU[MzwEYe";
    objIntelliSMS.SecretKey = @"F{kQ^s`wVpm!EU~Bx8yB^A$N$[l{pxJA";

    StringCollection ToList = new StringCollection();
    ToList.Add ( "44771012345" );
    ToList.Add ( "44771054321" );

    SendStatusCollection SendStatusList;

    SendStatusList = objIntelliSMS.SendMsgToMultipleRecipients 
        ( ToList, "Hello", "SENDER_ID" );
	    

SendUnicodeMsg Method

Sends a Unicode SMS message to multiple recipients via the Internet Gateway. The Unicode format is used to send multilingual messages not support by the standard GSM character set.

See Unicode Character Codes for more details.

SendStatusCollection SendUnicodeMsg ( StringCollection To, String Message, String From )
SendStatusCollection SendUnicodeMsgHex ( StringCollection To, String MessageHex, String From )

Parameters:

To Input List of destination phone numbers
Message Input The content of the text message (70 Unicode characters max.)
MessageHex Input Unicode text encoded in hexadecimal (140 octets max, 70 unicode characters)
From Input This is the source/sender's phone number
SendStatusCollection Return This collection is populated with the send status for each recipient

Exceptions:

IntelliSMSException Error returned by the IntelliSoftware SMS gateway

C# Example:

using IntelliSoftware;

IntelliSMS objIntelliSMS = new IntelliSMS();

objIntelliSMS.AccessKey = @"Yva$ER%Uhs+UU[MzwEYe";
objIntelliSMS.SecretKey = @"F{kQ^s`wVpm!EU~Bx8yB^A$N$[l{pxJA";

StringCollection ToList = new StringCollection();
ToList.Add ( "44771012345" );
ToList.Add ( "44771054321" );

SendStatusCollection SendStatusList;

SendStatusList = objIntelliSMS.SendUnicodeMsg 
    ( ToList, "Hello", "SENDER_ID" );
				

SendBinaryMsg Method

Sends a Binary SMS message via the Internet Gateway. Binary Messages can be used to send SmartMessages, such as Ringtones and Logos.

SendStatusCollection 
SendBinaryMsg ( StringCollection To, String UserDataHeader, String UserData, 
String From )

Parameters:

To Input List of destination phone numbers
UserDataHeader Input (Optional) User Data Header
UserData Input User Data (140 octets max)
From Input This is the source/sender's phone number
SendStatusCollection Return This collection is populated with the send status for each recipient

Exceptions:

IntelliSMSException Error returned by the IntelliSoftware SMS gateway

C# Example:

using IntelliSoftware;

IntelliSMS objIntelliSMS = new IntelliSMS();

objIntelliSMS.AccessKey = @"Yva$ER%Uhs+UU[MzwEYe";
objIntelliSMS.SecretKey = @"F{kQ^s`wVpm!EU~Bx8yB^A$N$[l{pxJA";

StringCollection ToList = new StringCollection();
ToList.Add ( "44771012345" );

SendStatusCollection SendStatusList;

SendStatusList = objIntelliSMS.SendBinaryMsg ( 
    ToList, "06050415820000", 
    "32F40100480E0100000000000000000000000000000000000000" + 
    "0000000000000000000001247803000000E0080120CC06400000" + 
    "40080120CC06C00000479E7124F0EFFADCF64448892479B6DAC6" +
    "CD4448F9241DB6DACECF44488124CDB6CD96CC44488924CDB6CD" +
    "96CDE446712478E66D9EC6000000000000000000000000000000" +
    "000000", "SENDER_ID" );
 				

GetBalance Method

Obtains the available credits on an account.

Integer GetBalance ()

Parameters:

Balance Return Number of remaining credits

Exceptions:

IntelliSMSException Error returned by the IntelliSoftware SMS gateway

C# Example:

using IntelliSoftware;

IntelliSMS objIntelliSMS = new IntelliSMS();

objIntelliSMS.AccessKey = @"Yva$ER%Uhs+UU[MzwEYe";
objIntelliSMS.SecretKey = @"F{kQ^s`wVpm!EU~Bx8yB^A$N$[l{pxJA";

int Balance = objIntelliSMS.GetBalance();
				

IntelliSMSException Class

Represents error returned by the IntelliSoftware SMS Internet gateway.

Properties:

ResultCode

Result code:
1 - OK
2 - NoUsername
3 - NoPassword
4 - NoTo
5 - NoText
6 - LoginInvalid
7 - InsufficientCredit
8 - GatewayError
9 - InternalError
10 - HTTPConnectionError
11 - InvalidNumber
12 - InvalidRequest 
13 - ServerTooBusy
14 - MsgIdInvalid
15 - ParameterMissing
16 - ParameterInvalid
17 - AccountExists
18 - TooManyNumbers
19 - NoMsgId
20 - DailyAllowanceExceeded
21 - MonthlyAllowanceExceeded
22 - AuthParameterMissing
23 - AuthParameterInvalid
24 - ConnectionNotSecure

InnerException Provide additional information for a HTTPConnectionError

SendStatusCollection Class

Contains the send status for each recipients.

C# Example:

using IntelliSoftware;

IntelliSMS objIntelliSMS = new IntelliSMS();

objIntelliSMS.AccessKey = @"Yva$ER%Uhs+UU[MzwEYe";
objIntelliSMS.SecretKey = @"F{kQ^s`wVpm!EU~Bx8yB^A$N$[l{pxJA";

StringCollection ToList = new StringCollection();
ToList.Add ( "44771012345" );

SendStatusCollection SendStatusList;

SendStatusList = objIntelliSMS.SendMsgToMultipleRecipients 
    ( ToList, "Hello", "SENDER_ID" );
    
    
string Report = "";
foreach ( SendStatus sendStatus in SendStatusList )
{
    Report += "To:" + sendStatus.To + ", " +
              "MessageId:" + sendStatus.MessageId + ", " +
              "ResultCode:" + sendStatus.ResultCode + "\n";
}

MessageBox.Show ( Report );
			

Advanced Features

Send to Distribution Lists (or Group Send)

Our gateway allows you to send SMS messages to preconfigured Distribution Lists or Groups. To send to a Distribution List or Group simply insert the Group Name were you would normally place the recipient's phone number. Distribution Lists or Groups are setup in your online account login on the Contacts page.

Reply Tracking:

The IntelliSoftware platform provides tracking of SMS replies, allowing you to determine which particular message a mobile user is replying to. When you submit a message to the SMS Gateway you can supply a User Context parameter. When a reply is received, the IntelliSoftware platform will included the User Context parameter when forwarding the message to your server.

The User Context can be supplied to the IntelliSoftware platform in the following ways:

.Net Component use SendMsgWithUserContext method
COM Component use SendMessageWithUserContext method
HTTP Interface add 'usercontext' POST/GET parameter
SMTP Interface (Email to SMS) add 'UserContext:' parameter
PHP SDK use SendMessageWithUserContext method
Java SDK use SendMessageWithUserContext method

The IntelliSoftware platform will forward the User Context for received messages in the following ways:

HTTP Interface 'usercontext' POST/GET parameter
SMTP Interface (SMS to Email) User Context appears in Subject line