.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.

Properties:

Username This is the username of your account
Password This is the password for your account
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.Username = "MyUsername";
objIntelliSMS.Password = "MyPassword";

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.Username = "MyUsername";
        objIntelliSMS.Password = "MyPassword";

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

        SendStatusCollection SendStatusList;

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

SendMMSMessage Method

SendStatusCollection SendMMSMessage ( StringCollection To, MMSMessage Message )

Sends an MMS message to one or more recipients via the Internet Gateway.

Parameters:

To Input List of destination phone numbers
MMSMessage Input MMS Message to be sent (includes subject and message parts).
SendStatusCollection Return This collection is populated with the send status for each recipient.

Exceptions:

IntelliSMSException Error returned by the IntelliSoftware SMS gateway
IntelliSMSClientSideException Error raised by the IntelliSMS Component (Client-Side) prior to making the submission to the IntelliSoftware SMS gateway

C# Example:

using IntelliSoftware;

MMSMessage NewMMSMessage = new MMSMessage();
NewMMSMessage.Subject = "MMS Message Subject";

MessagePart MessagePart1 = new MessagePart();
MessagePart1.Filename = "Image1.gif";
MessagePart1.SourceFilename = "C:\Image1.gif";
NewMMSMessage.MessageParts.Add ( MessagePart1 );

MessagePart MessagePart2 = new MessagePart();
MessagePart2.Filename = "Text1.txt";
MessagePart2.Text = "This is a text part";
NewMMSMessage.MessageParts.Add ( MessagePart2 );


IntelliSMS objIntelliSMS = new IntelliSMS();

objIntelliSMS.Username = "MyUsername";
objIntelliSMS.Password = "MyPassword";

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

SendStatusCollection SendStatusList;

SendStatusList = objIntelliSMS.SendMMSMessage 
    ( ToList, NewMMSMessage );
			

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.Username = "MyUsername";
objIntelliSMS.Password = "MyPassword";

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.Username = "MyUsername";
objIntelliSMS.Password = "MyPassword";

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

SendStatusCollection SendStatusList;

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

SendWapPushMsg Method

Sends a WAP PUSH message via the Internet Gateway. WAP PUSH messages can send multimedia content, such as an Image, Wallpaper, Ringtone or a link to WAP website.

SendStatusCollection SendWapPushMsg ( StringCollection 
To, String Title, String HRef, String From )

Parameters:

To Input List of destination phone numbers
Title Input Display Text for WAP PUSH message
HRef Input URL link to resource ( should start with 'http://' or 'https://' )
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.Username = "MyUsername";
objIntelliSMS.Password = "MyPassword";

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

SendStatusCollection SendStatusList;

SendStatusList = objIntelliSMS.SendWapPushMsg ( 
    ToList, "The message text", 
    "http://www.intellisoftware.co.uk/images/IntelliSMS.gif", 
    "SENDER_ID" );

Considerations:

Our gateway will only send one SMS message per submission. Therefore a WAP PUSH message is charged at 1 credit.

An InvalidRequest will result if the submitted text and href parameters would require 2 SMS messages to be sent. As a guide, the href and text parameters combined should not exceed 114 characters (assuming href starts with 'http://www.' )

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.Username = "MyUsername";
objIntelliSMS.Password = "MyPassword";

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

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.Username = "MyUsername";
objIntelliSMS.Password = "MyPassword";

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 );
			

MMSMessage Class

Represents an MMS Message. Includes message subject and message parts

Properties:

Subject String MMS Message Subject
MessageParts Collection Collection containing message parts. Contains MessagePart objects.
From String This is the source/sender's phone number. Leave blank to receive replies. Can be numerical (e.g. long number or shortcode), alphanumeric sender's Id's not supported.

MessagePart Class

Represents a Message Part in an MMS Message

Properties:

Filename String Filename of the message part (e.g. "Image.gif"). This is the Filename of the message part as it will appear in the MMS Message received on the phone. Do not include a file path.
ContentType String (Optional) Content type of the MMS Message Part (e.g. "image/gif"). If not supplied the Content Type will be determined based on the file extension given in Filename property.
Text String (Optional) Text content of a Text Message Part
SourceFilename String (Optional) Full path and filename of the file that contains the content of the MMS Message Part (e.g. "C:\Image.gif")
SourceStream Stream (Optional) An open stream that contains the content for the Message Part. NOTE: Caller is responsible for closing the stream after the call to SendMMSMessage.
NOTE: You must supply message content through the Text, SourceFilename or SourceStream property, if you do not set one of these properties an error will be returned.

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

Download:

  Download DOTNET Component (IntelliSMSDotNet.zip)

Install:

1. Copy IntelliSMSDotNet.dll to the \bin directory
2. Add IntelliSMSDotNet.dll to the project references