SMS Wiki - User contributions [en]

Java Sending SMS via SOAP

2007-06-05T18:01:45Z

Old-user20:

'''Source code for this project can be found [http://api.upsidewireless.com/samples/java/Java%20SOAP%20Demo.zip here]'''

The process of sending an SMS using Java is fairly straightforward.

The easiest setup is to use Eclipse with the XFire plugin. XFire is an opensource Java SOAP interface http://xfire.codehaus.org/

* Once you have the plugin installed, add the XFire nature to your project by right clicking on the project and selecting "Add XFire Nature"

* Then, again, right click on the project and specify "New > Other...". At the bottom of the list should be an option labeled "Code generation from WSDL Document". Select this option and enter the following into the dialog presented:

WSDL: http://api.upsidewireless.com/soap/Authentication.asmx?WSDL
Output Directory: <Your source directory>
Package: <Leave Blank> (By leaving this field blank, the default package of the service will be used)
Click Finish and it will build the necessary source files. Repeat the process for: http://api.upsidewireless.com/soap/SMS.asmx?WSDL

* Now that you have both sets of XFire client code generated (one for authentication and the other for sending SMS), now it is time to make a call. The essence of making the call is the following 3 lines of code (it can be reduce down to a single line of code, but that would make debugging difficult):

<source lang="java">
SMSClient client = new SMSClient();
SMSSoap soap = client.getSMSSoap();
soap.send_Plain(token, signature, "+15557779999", "Hello", SmsEncoding.SEVEN);
</source>

Here is the one liner:
<source lang="java">
new SMSClient().getSMSSoap().send_Plain(token, signature, "+15557779999", "Hello", SmsEncoding.SEVEN);
</source>

A complete "Main" style application would look like:

<source lang="java">
import org.codehaus.xfire.XFireRuntimeException;

import com.upsidewireless.webservice.authentication.AuthenticationClient;
import com.upsidewireless.webservice.authentication.AuthenticationParameters;
import com.upsidewireless.webservice.authentication.AuthenticationSoap;
import com.upsidewireless.webservice.sms.SMSClient;
import com.upsidewireless.webservice.sms.SMSSoap;
import com.upsidewireless.webservice.sms.SmsEncoding;

/**
* @author cjensen
*
*/
public class SendSms {

/**
* @param args
*/
public static void main(String[] args) {

/***********************************************************************
* Execute the retrieval of the token and signature only once.
* Preferably from the web interface and store them as Constants
**********************************************************************/

AuthenticationClient authclient = new AuthenticationClient();
AuthenticationSoap authsoap = authclient.getAuthenticationSoap();

AuthenticationParameters authparams = authsoap.getParameters("YourUserName", "YourPassword");
String token = authparams.getToken();
String signature = authparams.getSignature();

/***********************************************************************
* We now have the credentials, now build a SOAP client and make the
* call.
**********************************************************************/

SMSClient client = new SMSClient();
SMSSoap soap = client.getSMSSoap();
soap.send_Plain(token, signature, "+15557779999", "Hello", SmsEncoding.SEVEN);

}

}
</source>

Java Sending SMS via SOAP

2007-06-05T17:48:38Z

Old-user20:

The process of sending an SMS using Java is fairly straightforward.

The easiest setup is to use Eclipse with the XFire plugin. XFire is an opensource Java SOAP interface http://xfire.codehaus.org/

* Once you have the plugin installed, add the XFire nature to your project by right clicking on the project and selecting "Add XFire Nature"

* Then, again, right click on the project and specify "New > Other...". At the bottom of the list should be an option labeled "Code generation from WSDL Document". Select this option and enter the following into the dialog presented:

WSDL: http://api.upsidewireless.com/soap/Authentication.asmx?WSDL
Output Directory: <Your source directory>
Package: <Leave Blank> (By leaving this field blank, the default package of the service will be used)
Click Finish and it will build the necessary source files. Repeat the process for: http://api.upsidewireless.com/soap/SMS.asmx?WSDL

* Now that you have both sets of XFire client code generated (one for authentication and the other for sending SMS), now it is time to make a call. The essence of making the call is the following 3 lines of code (it can be reduce down to a single line of code, but that would make debugging difficult):

<source lang="java">
SMSClient client = new SMSClient();
SMSSoap soap = client.getSMSSoap();
soap.send_Plain(token, signature, "+15557779999", "Hello", SmsEncoding.SEVEN);
</source>

Here is the one liner:
<source lang="java">
new SMSClient().getSMSSoap().send_Plain(token, signature, "+15557779999", "Hello", SmsEncoding.SEVEN);
</source>

A complete "Main" style application would look like:

<source lang="java">
import org.codehaus.xfire.XFireRuntimeException;

import com.upsidewireless.webservice.authentication.AuthenticationClient;
import com.upsidewireless.webservice.authentication.AuthenticationParameters;
import com.upsidewireless.webservice.authentication.AuthenticationSoap;
import com.upsidewireless.webservice.sms.SMSClient;
import com.upsidewireless.webservice.sms.SMSSoap;
import com.upsidewireless.webservice.sms.SmsEncoding;

/**
* @author cjensen
*
*/
public class SendSms {

/**
* @param args
*/
public static void main(String[] args) {

/***********************************************************************
* Execute the retrieval of the token and signature only once.
* Preferably from the web interface and store them as Constants
**********************************************************************/

AuthenticationClient authclient = new AuthenticationClient();
AuthenticationSoap authsoap = authclient.getAuthenticationSoap();

AuthenticationParameters authparams = authsoap.getParameters("YourUserName", "YourPassword");
String token = authparams.getToken();
String signature = authparams.getSignature();

/***********************************************************************
* We now have the credentials, now build a SOAP client and make the
* call.
**********************************************************************/

SMSClient client = new SMSClient();
SMSSoap soap = client.getSMSSoap();
soap.send_Plain(token, signature, "+15557779999", "Hello", SmsEncoding.SEVEN);

}

}
</source>

Java Sending SMS via SOAP

2007-06-05T17:47:08Z

Old-user20:

The process of sending an SMS using Java is fairly straightforward.

The easiest setup is to use Eclipse with the XFire plugin. XFire is an opensource Java SOAP interface http://xfire.codehaus.org/

Once you have the plugin installed, add the XFire nature to your project by right clicking on the project and selecting "Add XFire Nature"

Then, again, right click on the project and specify "New > Other...". At the bottom of the list should be an option labeled "Code generation from WSDL Document". Select this option and enter the following into the dialog presented:

WSDL: http://api.upsidewireless.com/soap/Authentication.asmx?WSDL
Output Directory: <Your source directory>
Package: <Leave Blank> (By leaving this field blank, the default package of the service will be used)

Click Finish and it will build the necessary source files. Repeat the process for: http://api.upsidewireless.com/soap/SMS.asmx?WSDL

Now that you have both sets of XFire client code generated (one for authentication and the other for sending SMS), now it is time to make a call. The essence of making the call is the following 3 lines of code (it can be reduce down to a single line of code, but that would make debugging difficult):

<source lang="java">
SMSClient client = new SMSClient();
SMSSoap soap = client.getSMSSoap();
soap.send_Plain(token, signature, "+15557779999", "Hello", SmsEncoding.SEVEN);
</source>

Here is the one liner:
<source lang="java">
new SMSClient().getSMSSoap().send_Plain(token, signature, "+15557779999", "Hello", SmsEncoding.SEVEN);
</source>

A complete "Main" style application would look like:

<source lang="java">
import org.codehaus.xfire.XFireRuntimeException;

import com.upsidewireless.webservice.authentication.AuthenticationClient;
import com.upsidewireless.webservice.authentication.AuthenticationParameters;
import com.upsidewireless.webservice.authentication.AuthenticationSoap;
import com.upsidewireless.webservice.sms.SMSClient;
import com.upsidewireless.webservice.sms.SMSSoap;
import com.upsidewireless.webservice.sms.SmsEncoding;

/**
* @author cjensen
*
*/
public class SendSms {

/**
* @param args
*/
public static void main(String[] args) {

/***********************************************************************
* Execute the retrieval of the token and signature only once.
* Preferably from the web interface and store them as Constants
**********************************************************************/

AuthenticationClient authclient = new AuthenticationClient();
AuthenticationSoap authsoap = authclient.getAuthenticationSoap();

AuthenticationParameters authparams = authsoap.getParameters("YourUserName", "YourPassword");
String token = authparams.getToken();
String signature = authparams.getSignature();

/***********************************************************************
* We now have the credentials, now build a SOAP client and make the
* call.
**********************************************************************/

SMSClient client = new SMSClient();
SMSSoap soap = client.getSMSSoap();
soap.send_Plain(token, signature, "+15557779999", "Hello", SmsEncoding.SEVEN);

}

}
</source>

Java Sending SMS via SOAP

2007-06-05T17:42:39Z

Old-user20: New page: The process of sending an SMS using Java is fairly straightforward. The easiest setup is to use Eclipse with the XFire plugin. XFire is an opensource Java SOAP interface http://xfire.code...

APIs

2007-06-05T17:25:24Z

Old-user20: added the Java Soap Sending link

Upside Wireless HTTP APIs are located at [http://api.upsidewireless.com/ http://api.upsidewireless.com/]

* [[MOIntro | Intro to MO APIs (Mobile Originated - incoming from a mobile phone)]]
** [[MO POP3]]
** [[MO HTTP]]
** [[MO HTTPS]]
* [[MTIntro | Intro to MT APIs (Mobile Terminated - outgoing to a mobile phone)]]
** [[MT HTTP]]
** [[MT SMTP]]
*** [[MT SMTP Auth]]
*** [[MT Web Text]]
*** [[MT IP Address]]
* [[User Management]]
* [[Settings]]
* [[Examples And Concepts | Examples and General Concepts]]
** PHP
*** [[PHP Sending SMS | Sending SMS via HTTP POST]]
*** [[PHP Sending SMS via SMTP | Sending SMS via SMTP]]
*** [[PHP Receiving SMS | Receiving SMS]]
** Java
*** [[Java Sending SMS via SOAP | Sending SMS via SOAP]]
*** [[Java Sending SMS via SMTP | Sending SMS via SMTP]]
*** Receiving SMS
** [[CSharp_Overview | C# (Overview)]]
*** [[CSharp Sending SMS | Sending SMS]]
*** [[CSharp Sending SMS via SMTP | Sending SMS via SMTP]]
*** [[CSharp Receiving SMS | Receiving SMS]]

This is a patrolled change

Examples And Concepts

2007-05-11T18:32:49Z

Old-user20:

=== SOAP API Usage ===
Every function of the SOAP API that requires authentication must pass in Authentication Parameters, to acquire a set of Authentication Parameters, please use the API found at: http://api.upsidewireless.com/soap/Authentication.asmx

The two values that are returned from the function are then used for every subsequent calls to the API. The Token parameter will never change for the life of the account whereas the Signature will change if your password changes. In most applications, you will store these variables in a constant or configuration store.

=== Sending SMS ===

=== Receiving SMS ===
The method of receiving Inbound SMS messages is by way of HTTP POST. A few variables are passed in the body of the POST.
* name
* sender
* data
* carriercode << For shortcode accounts only
* inboundnumber << For Dedicated accounts only

In order to receive an SMS you must first register a URL in your account. Your account must be enabled to allow adding of URLs. Once your account has the registered URL set up, you will then need to forward all inbound SMS messages to that URL.

You can use the following HTML to emulate what our server will send your service.

<source lang="html4strict">
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<title>Received SMS Emulator (Via HTTP POST)</title>
</head>
<body>
<form id="emulator" name="emulator" method="post" action="http://sms.yourdomain.com/incoming.php">
<table>
<tr>
<td>Sender:</td>
<td>
<input name="sender" type="text" id="sender" value="17789964283"/>
</td>
<td>sender</td>
</tr>
<tr>
<td>Message:</td>
<td>
<input name="data" type="text" id="data" value="Hello"/>
</td>
<td>data</td>
</tr>
<tr>
<td>User Name:</td>
<td>
<input name="name" type="text" id="name" value="cjensen"/>
</td>
<td>name</td>
</tr>
<tr>
<td>Inbound Number:</td>
<td>
<input name="inboundnumber" type="text" id="inboundnumber" value="16047807002"/>
</td>
<td>inboundnumber</td>
</tr>
<tr>
<td>Carrier Code:</td>
<td>
<input name="carriercode" type="text" id="carriercode"/>
</td>
<td>carriercode</td>
</tr>
<tr>
<td colspan="2" align="right">
<input type="submit" name="Submit" value="Submit"/>
</td>
<td> </td>
</tr>
</table>
</form>
</body>
</html>

</source>

APIs

2007-05-11T18:21:34Z

Old-user20:

Upside Wireless HTTP APIs are located at [http://api.upsidewireless.com/ http://api.upsidewireless.com/]

* [[MOIntro | Intro to MO APIs (Mobile Originated - incoming from a mobile phone)]]
** [[MO POP3]]
** [[MO HTTP]]
** [[MO HTTPS]]
* [[MTIntro | Intro to MT APIs (Mobile Terminated - outgoing to a mobile phone)]]
** [[MT HTTP]]
** [[MT SMTP]]
*** [[MT SMTP Auth]]
*** [[MT Web Text]]
*** [[MT IP Address]]
* [[User Management]]
* [[Settings]]
* [[Examples And Concepts | Examples and General Concepts]]
** PHP
*** [[PHP Sending SMS | Sending SMS]]
*** [[PHP Receiving SMS | Receiving SMS]]
** Java
*** Sending SMS
*** Receiving SMS
** [[CSharp_Overview | C# (Overview)]]
*** [[CSharp Sending SMS | Sending SMS]]
*** [[CSharp Receiving SMS | Receiving SMS]]

This is a patrolled change

MO POP3

2007-05-11T18:20:43Z

Old-user20: New page: http://www.ipipi.com/help/connectusingmailclient.htm

http://www.ipipi.com/help/connectusingmailclient.htm

APIs

2007-05-11T18:20:15Z

Old-user20:

Upside Wireless HTTP APIs are located at [http://api.upsidewireless.com/ http://api.upsidewireless.com/]

* API Security
* Ease of Use
* Restrictions
* [[MOIntro | Intro to MO APIs (Mobile Originated - incoming from a mobile phone)]]
** [[MO POP3]]
** [[MO HTTP]]
** [[MO HTTPS]]
* [[MTIntro | Intro to MT APIs (Mobile Terminated - outgoing to a mobile phone)]]
** [[MT HTTP]]
** [[MT SMTP]]
*** [[MT SMTP Auth]]
*** [[MT Web Text]]
*** [[MT IP Address]]
* [[User Management]]
* [[Settings]]
* [[Examples And Concepts | Examples and General Concepts]]
** PHP
*** [[PHP Sending SMS | Sending SMS]]
*** [[PHP Receiving SMS | Receiving SMS]]
** Java
*** Sending SMS
*** Receiving SMS
** [[CSharp_Overview | C# (Overview)]]
*** [[CSharp Sending SMS | Sending SMS]]
*** [[CSharp Receiving SMS | Receiving SMS]]

This is a patrolled change

User Management

2007-05-11T18:19:43Z

Old-user20: New page: Coming Soon

Coming Soon

APIs

2007-05-11T18:19:34Z

Old-user20:

Upside Wireless HTTP APIs are located at [http://api.upsidewireless.com/ http://api.upsidewireless.com/]

* API Security
* Ease of Use
* Restrictions
* [[MOIntro | Intro to MO APIs (Mobile Originated - incoming from a mobile phone)]]
** MO POP3
** [[MO HTTP]]
** MO HTTPS
* [[MTIntro | Intro to MT APIs (Mobile Terminated - outgoing to a mobile phone)]]
** [[MT HTTP]]
** [[MT SMTP]]
*** [[MT SMTP Auth]]
*** [[MT Web Text]]
*** [[MT IP Address]]
* [[User Management]]
* [[Settings]]
* [[Examples And Concepts | Examples and General Concepts]]
** PHP
*** [[PHP Sending SMS | Sending SMS]]
*** [[PHP Receiving SMS | Receiving SMS]]
** Java
*** Sending SMS
*** Receiving SMS
** [[CSharp_Overview | C# (Overview)]]
*** [[CSharp Sending SMS | Sending SMS]]
*** [[CSharp Receiving SMS | Receiving SMS]]

This is a patrolled change

MTIntro

2007-05-11T18:18:46Z

Old-user20: New page: We offer a number of various ways of integrating your application with our SMS Gateway. Here are a few guidlines to help you choose the implementation strategy that suites your applicatio...

We offer a number of various ways of integrating your application with our SMS Gateway.

Here are a few guidlines to help you choose the implementation strategy that suites your application best:

HTTP

SMTP

MT IP Address

2007-05-11T18:18:35Z

Old-user20: New page: contact us not recommended “To” SMS_number_in_international_format@sms.ipipi.com “cc” Leave empty “bcc” Leave empty “Subject” Leave empty or use one or all of the comp...

contact us

not recommended

“To” SMS_number_in_international_format@sms.ipipi.com
“cc” Leave empty
“bcc” Leave empty
“Subject” Leave empty or use one or all of the compression options described below.

The following are examples of valid entries in the subject line:

***************
a
p,c
a,p,c
[blank] – you can leave the subject line empty – compression will be turned off
Read more on available SMS compression options here
***************

“Message” Write the text of your SMS message. Please note that there is a maximum number of characters that you can write (about 150) .

MT Web Text

2007-05-11T18:17:04Z

Old-user20: New page: http://www.ipipi.com/help/sms_from_webmail.htm

http://www.ipipi.com/help/sms_from_webmail.htm

APIs

2007-05-11T18:16:56Z

Old-user20:

Upside Wireless HTTP APIs are located at [http://api.upsidewireless.com/ http://api.upsidewireless.com/]

* API Security
* Ease of Use
* Restrictions
* [[MOIntro | Intro to MO APIs (Mobile Originated - incoming from a mobile phone)]]
** MO POP3
** [[MO HTTP]]
** MO HTTPS
* [[MTIntro | Intro to MT APIs (Mobile Terminated - outgoing to a mobile phone)]]
** MT HTTP
** MT SMTP
*** [[MT SMTP Auth]]
*** [[MT Web Text]]
*** [[MT IP Address]]
* User Management
* Settings
* [[Examples And Concepts | Examples and General Concepts]]
** PHP
*** [[PHP Sending SMS | Sending SMS]]
*** [[PHP Receiving SMS | Receiving SMS]]
** Java
*** Sending SMS
*** Receiving SMS
** [[CSharp_Overview | C# (Overview)]]
*** [[CSharp Sending SMS | Sending SMS]]
*** [[CSharp Receiving SMS | Receiving SMS]]

This is a patrolled change

Main Page

2007-05-11T18:10:06Z

Old-user20:

EnterpriseSMS API is used to incorporate SMS text messaging into your large scale enterprise application. Several integration methods are available to satisfy various integration needs of our customers. This document explains three integration methods for sending and two integration methods for receiving messages.

These accounts offer:
* High throughput (up to 100 messages per second)
* Complete global coverage
* Two-way capability (MT/MO)
* Simple and quick integration
* Full transaction auditing

For full documentation and example of the API please refer to [[APIs | Upside Wireless APIs]]

To see a complete list of supported networks, please see [http://reseller.upsidewireless.com/networkList.do Global Network Coverage List]

MOIntro

2007-05-11T17:59:55Z

Old-user20: New page: In some instances having a virtual, dedicated SMS number is required to receive incoming (MO) messages. These cases are mostly important for business/corporate users who want to collect in...

In some instances having a virtual, dedicated SMS number is required to receive incoming (MO) messages. These cases are mostly important for business/corporate users who want to collect information from their partners, employees or customers. The applications are limitless but some of them include:
* Non-premium SMS campaigns - The benefit is that you can be set up in about 3-5 business days at cost 5-10 times lower than having a dedicated premium SMS number
* Pooling (publish your dedicated number and collect opinion from your customers)
* Marketing (giveaways, contests. In return you get consent from your customers to send them SMS advertising)
* Medical trials (clinical trials) - ask members of the panel to SMS their results to your dedicated SMS number. Collected information goes straight into your database - for ultimate efficiency.
* Call-back long distance - Publish your virtual SMS number overseas. Your customers then send a number of the person in USA they want to talk to your virtual SMS number. The number of the sender and the number of the other party are then sent to your application and a voice call is established at a low international tariff between these two numbers.
Virtual SMS number can be associated with any Enterprise account. Once this is done, all messages received by your number will be forwarded into your Inbox. They can also be, simultaneously, forwarded to an application (HTTP), email account, another mobile phone or any combination of these devices.

APIs

2007-05-11T17:58:45Z

Old-user20:

Upside Wireless HTTP APIs are located at [http://api.upsidewireless.com/ http://api.upsidewireless.com/]

* API Security
* Ease of Use
* Restrictions
* [[MOIntro | Intro to MO APIs (Mobile Originated - incoming from a mobile phone)]]
** MO POP3
** [[MO HTTP]]
** MO HTTPS
* [[MTIntro | Intro to MT APIs (Mobile Terminated - outgoing to a mobile phone)]]
** MT HTTP
** MT SMTP
*** [[MT SMTP Auth]]
*** MT Web Text
*** MT IP Address
* User Management
* Settings
* [[Examples And Concepts | Examples and General Concepts]]
** PHP
*** [[PHP Sending SMS | Sending SMS]]
*** [[PHP Receiving SMS | Receiving SMS]]
** Java
*** Sending SMS
*** Receiving SMS
** [[CSharp_Overview | C# (Overview)]]
*** [[CSharp Sending SMS | Sending SMS]]
*** [[CSharp Receiving SMS | Receiving SMS]]

This is a patrolled change

CSharp Receiving SMS

2007-03-28T18:07:49Z

Old-user20:

This example is a .NET Generic Handler. It demonstrates the reception of an inbound (HTTP Forwarded) SMS.

To emulate an inbound SMS forwarded via HTTP POST, please see the code block following the HTTP Handler code.

Echo.ashx
<source lang="csharp">
<%@ WebHandler Language="C#" Class="Echo" %>

using System;
using System.Web;
using System.Web.Services.Protocols;
using com.upsidewireless.api.sms;

public class IncomingMessage
{
public string username;
public string sender;
public string contents;
public SmsEncoding encoding;
public string carrierCode;
public string recipient;
}

public class OutgoingMessage
{
public string dedicatedNumber;
public string recipient;
public string carrierCode;
public string contents;
public SmsEncoding encoding;

public override string ToString()
{
return "[" + recipient + "]";
}
}

public class Echo : IHttpHandler
{

System.Diagnostics.EventLog evenLogger = new System.Diagnostics.EventLog("SMS Echo");

public Echo()
{
evenLogger.Source = "SMS Echo Test";
}

public void ProcessRequest(HttpContext context)
{
// This sample will respond to incoming HTTP POSTs and send back to the sender the same text that was sent
string requestType = context.Request.RequestType;
switch (requestType)
{
case "POST":

IncomingMessage incomingMessage = buildIncomingMessage(context);
OutgoingMessage outgoingMessage = processIncomingMessage(incomingMessage);
sendMessage(outgoingMessage);

context.Response.Write("Successfully sent echo back to: " + outgoingMessage);
break;

default:
context.Response.Write("This handler only accepts HTTP operations of type POST");
break;
}
}

private OutgoingMessage processIncomingMessage(IncomingMessage incomingMessage)
{
// TODO Build an OutgoingMessage object based on data contained within the incomingMessage.
OutgoingMessage result = new OutgoingMessage();

string message = "Time:" + DateTime.Now + "\n";
message += "Username:" + incomingMessage.username + "\n";
message += "From:" + incomingMessage.sender + "\n";
message += "To:" + incomingMessage.recipient + "\n";
message += "Encoding:" + incomingMessage.encoding.ToString() + "\n";
message += "Carrier Code:" + incomingMessage.carrierCode + "\n";
message += "Message:" + incomingMessage.contents;

result.recipient = incomingMessage.sender;
result.contents = message;
result.encoding = incomingMessage.encoding;
result.carrierCode = incomingMessage.carrierCode;
result.dedicatedNumber = incomingMessage.recipient;

return result;
}

private IncomingMessage buildIncomingMessage(HttpContext context)
{
IncomingMessage result = new IncomingMessage();

result.username = context.Request.Form["name"];
result.sender = context.Request.Form["sender"];
result.contents = context.Request.Form["data"];
string encodingString = context.Request.Form["encoding"];
result.carrierCode = context.Request.Form["carriercode"];
result.recipient = context.Request.Form["inboundnumber"];

SmsEncoding smsEncoding = SmsEncoding.Seven;

// we need to convert the encoding over to a strongly typed variable
switch (encodingString)
{
case "Sixteen":
smsEncoding = SmsEncoding.Sixteen;
break;
}

result.encoding = smsEncoding;

evenLogger.WriteEntry("Incoming Message Received", System.Diagnostics.EventLogEntryType.Information, 500, 0);

return result;
}

private void sendMessage(OutgoingMessage outgoingMessage)
{
// TODO: be sure to change the data stored within the resource before using this function!

string token = Resources.UpsideWirelessCredentialsResource.token;
string signature = Resources.UpsideWirelessCredentialsResource.signature;

SMS sms = new SMS();

try
{
SMSSendResult result = null;

if (String.IsNullOrEmpty(outgoingMessage.carrierCode) || String.IsNullOrEmpty(outgoingMessage.dedicatedNumber))
{
// standard routing
result = sms.Send_Plain(token, signature, outgoingMessage.recipient, outgoingMessage.contents, outgoingMessage.encoding);
}
else
{
// dedicated routing
result = sms.Send_Plain_Dedicated(token, signature, outgoingMessage.recipient, outgoingMessage.contents, outgoingMessage.encoding, outgoingMessage.carrierCode, outgoingMessage.dedicatedNumber, 0.0);
}

if (result.isOk)
{
evenLogger.WriteEntry("Sent SMS: " + outgoingMessage, System.Diagnostics.EventLogEntryType.Information, 0, 0);
}
else
{
evenLogger.WriteEntry("Unable to send SMS: " + outgoingMessage, System.Diagnostics.EventLogEntryType.Error, 1000, 0);
}
}
catch (SoapException e)
{
evenLogger.WriteEntry("Fatal: Unable to send SMS: " + outgoingMessage + " Exception: " + e.Detail.InnerText, System.Diagnostics.EventLogEntryType.Error, 5000, 0);
}
}

public bool IsReusable
{
get
{
return false;
}
}

}
</source>

CSharp Sending SMS

2007-03-28T18:05:24Z

Old-user20: /* Sending a Plain SMS */

The following sample code is running at [http://api.upsidewireless.com/samples/csharp/ SOAP Sampler]

=== Sending a Plain SMS ===

The basis of sending a message is to pass in the authentication token and signature along with the message parameters. A SoapException will be thrown if a serious error occurs and an SMS result object will be returned in less serious conditions.

Default.aspx.cs
<source lang="csharp">

using System;
using System.Data;
using System.Configuration;
using System.Collections;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;
using com.upsidewireless.api.sms;
using System.Web.Services.Protocols;

public partial class SMS_Default : System.Web.UI.Page
{
protected void Page_Load(object sender, EventArgs e)
{

}
protected void sendButton_Click(object sender, EventArgs e)
{
SMS sms = new SMS();

string token = "";
if (Session["token"] != null)
{
token = (string)Session["token"];
}

string signature = "";
if (Session["signature"] != null)
{
signature = (string)Session["signature"];
}

string recipient = recipientTextBox.Text;

string message = messageTextBox.Text;

SmsEncoding encoding = SmsEncoding.Seven;
switch (encodingDropDownList.SelectedValue)
{
case "Seven":
encoding = SmsEncoding.Seven;
break;

case "Sixteen":
encoding = SmsEncoding.Sixteen;
break;
}
try
{
SMSSendResult result = sms.Send_Plain(token, signature, recipient, message, encoding);

if (result.isOk)
{
resultsMultiView.SetActiveView(resultSuccessView);
trackingIdLabel.Text = result.trackingId;
}
else
{
resultsMultiView.SetActiveView(resultsSMSErrorView);

blockedLabel.Text = result.BlockedReason;
invalidCountryCodeCheckBox.Checked = result.invalidCountryCode;
emptyMessageCheckBox.Checked = result.messageIsEmpty;
tooManySplitsCheckBox.Checked = result.tooManyMessages;
}
}
catch (SoapException error)
{
resultsMultiView.SetActiveView(resultsErrorView);
errorLabel.Text = error.Detail.InnerText;
}
}
}

</source>

Default.aspx
<source lang="asp">
<%@ Page Language="C#" MasterPageFile="~/MasterPage.master" AutoEventWireup="true"
CodeFile="Default.aspx.cs" Inherits="SMS_Default" Title="Send Plain SMS" %>

<asp:Content ID="Content1" ContentPlaceHolderID="ContentPlaceHolder1" runat="Server">
<table>
<tr>
<td align="right">
<asp:Label ID="recipientLabel" runat="server" Text="Recipient:"></asp:Label></td>
<td>
<asp:TextBox ID="recipientTextBox" runat="server"></asp:TextBox></td>
</tr>
<tr>
<td valign="top">
<asp:Label ID="Label1" runat="server" Text="Message:"></asp:Label></td>
<td>
<asp:TextBox ID="messageTextBox" runat="server" Rows="6" TextMode="MultiLine"></asp:TextBox></td>
</tr>
<tr>
<td valign="top">
<asp:Label ID="Label2" runat="server" Text="Encoding:"></asp:Label></td>
<td>
<asp:DropDownList ID="encodingDropDownList" runat="server">
<asp:ListItem Value="Seven">Seven (GSM7)</asp:ListItem>
<asp:ListItem Value="Sixteen">Unicode</asp:ListItem>
</asp:DropDownList></td>
</tr>
<tr>
<td colspan="2" align="right">
<asp:Button ID="sendButton" runat="server" Text="Send" OnClick="sendButton_Click" /></td>
</tr>
</table>
<asp:MultiView ID="resultsMultiView" runat="server">
<asp:View ID="resultSuccessView" runat="server">
Operation Successful<br />
Message Tracking ID:<asp:Label ID="trackingIdLabel" runat="server" Text="Label"></asp:Label></asp:View>
<asp:View ID="resultsSMSErrorView" runat="server">
<div style="border: solid 1px #c00; padding: 20px; margin: 10px;">
The operation was not successful for the following reasons:<br />
<asp:Label ID="blockedLabel" runat="server" Text="Label" Font-Bold="True"></asp:Label><br />
<asp:CheckBox ID="invalidCountryCodeCheckBox" runat="server" Text="Invalid Country Code" /><br />
<asp:CheckBox ID="tooManySplitsCheckBox" runat="server" Text="Message too long" /><br />
<asp:CheckBox ID="emptyMessageCheckBox" runat="server" Text="Message is Empty" /></div>
</asp:View>
<asp:View ID="resultsErrorView" runat="server">
<div style="border: solid 1px #c00; padding: 20px; margin: 10px;">
<asp:Label ID="Label3" runat="server" Text="An error has occurred when calling this function:"></asp:Label>
<asp:Label ID="errorLabel" runat="server" Text="Label" Font-Bold="True"></asp:Label></div>
</asp:View>
</asp:MultiView><br />
</asp:Content>
</source>

PHP Receiving SMS

2007-03-28T18:03:15Z

Old-user20:

<source lang="php">
<?php

$sender = $_POST['sender'];
$data = $_POST['data'];
$name = $_POST['name'];

$message = process_incoming_message($sender, $data, $name);

// plug in the values returned from
// http://api.upsidewireless.com/soap/Authentication.asmx?op=GetParameters

$token = '4289bd26-4a8c-468b-847e-1ea72fd2dfd1';
$signature = 'y5MZoN7mV0sCYZHrBFDJbPL';

$api_call_data = array(
'token' => $token,
'signature' => $signature,
'recipient' => $sender, // The recipient is the recipient because we are sending right back to them
'message' => $message,
'encoding' => 'Seven' // Use 'Sixteen' if you are sending in Unicode
);

$post_data = build_post_data($api_call_data );

// Please refer to
// http://api.upsidewireless.com/
// for other sending methods

$url = 'http://api.upsidewireless.com/soap/SMS.asmx/Send_Plain';

$xml = do_post_request($url, $post_data);

// be sure you look at the XML from above to see if there are any errors

/************* Main processing function **************/

function process_incoming_message($sender, $data, $name) {

return 'Message Received:' . date("Y-m-d H:i:s");

}

// Everything below is just function definitions

function do_post_request($url, $data, $optional_headers = null)
{
$params = array('http' => array('method' => 'POST', 'content' => $data));

if ($optional_headers !== null) {
$params['http']['header'] = $optional_headers;
}

$ctx = stream_context_create($params);

$fp = @fopen($url, 'rb', false, $ctx);
if (!$fp) {
throw new Exception("Problem with $url, $php_errormsg");
}

$response = @stream_get_contents($fp);

if ($response === false) {
throw new Exception("Problem reading data from $url, $php_errormsg");
}

return $response;
}

function build_post_data($data, $prefix=null, $sep='', $key='') {

$ret = array();

foreach((array)$data as $k => $v) {

$k = urlencode($k);

if(is_int($k) && $prefix != null) {
$k = $prefix.$k;
}

if(!empty($key)) {
$k = $key."[".$k."]";
}

if(is_array($v) || is_object($v)) {
array_push($ret, build_post_data($v,"",$sep,$k));
} else {
array_push($ret,$k."=".urlencode($v));
}
}

if(empty($sep)) {
$sep = ini_get("arg_separator.output");
}

return implode($sep, $ret);
}

?>
</source>

Examples And Concepts

2007-03-28T18:02:02Z

Old-user20: /* Receiving SMS */

=== SOAP API Usage ===
Every function of the SOAP API that requires authentication must pass in Authentication Parameters, to acquire a set of Authentication Parameters, please use the API found at: http://api.upsidewireless.com/soap/Authentication.asmx

=== Sending SMS ===

=== Receiving SMS ===
The method of receiving Inbound SMS messages is by way of HTTP POST. A few variables are passed in the body of the POST.
* name
* sender
* data
* carriercode << For shortcode accounts only
* inboundnumber << For Dedicated accounts only

In order to receive an SMS you must first register a URL in your account. Your account must be enabled to allow adding of URLs. Once your account has the registered URL set up, you will then need to forward all inbound SMS messages to that URL.

You can use the following HTML to emulate what our server will send your service.

<source lang="html4strict">
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<title>Received SMS Emulator (Via HTTP POST)</title>
</head>
<body>
<form id="emulator" name="emulator" method="post" action="http://sms.yourdomain.com/incoming.php">
<table>
<tr>
<td>Sender:</td>
<td>
<input name="sender" type="text" id="sender" value="17789964283"/>
</td>
<td>sender</td>
</tr>
<tr>
<td>Message:</td>
<td>
<input name="data" type="text" id="data" value="Hello"/>
</td>
<td>data</td>
</tr>
<tr>
<td>User Name:</td>
<td>
<input name="name" type="text" id="name" value="cjensen"/>
</td>
<td>name</td>
</tr>
<tr>
<td>Inbound Number:</td>
<td>
<input name="inboundnumber" type="text" id="inboundnumber" value="16047807002"/>
</td>
<td>inboundnumber</td>
</tr>
<tr>
<td>Carrier Code:</td>
<td>
<input name="carriercode" type="text" id="carriercode"/>
</td>
<td>carriercode</td>
</tr>
<tr>
<td colspan="2" align="right">
<input type="submit" name="Submit" value="Submit"/>
</td>
<td> </td>
</tr>
</table>
</form>
</body>
</html>

</source>

Examples And Concepts

2007-03-28T18:01:14Z

Old-user20: /* Receiving SMS */

=== SOAP API Usage ===
Every function of the SOAP API that requires authentication must pass in Authentication Parameters, to acquire a set of Authentication Parameters, please use the API found at: http://api.upsidewireless.com/soap/Authentication.asmx

=== Sending SMS ===

=== Receiving SMS ===
The method of receiving Inbound SMS messages is by way of HTTP POST. A few variables are passed in the body of the POST.
* name
* sender
* data
* carriercode << For shortcode accounts only
* inboundnumber << For Dedicated accounts only

In order to receive an SMS you must first register a URL in your account. Your account must be enabled to allow adding of URLs. Once your account has the registered URL set up, you will then need to forward all inbound SMS messages to that URL.

You can use the following HTML to emulate what our server will send your service.

<source lang="php">
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<title>Received SMS Emulator (Via HTTP POST)</title>
</head>
<body>
<form id="emulator" name="emulator" method="post" action="http://sms.yourdomain.com/incoming.php">
<table>
<tr>
<td>Sender:</td>
<td>
<input name="sender" type="text" id="sender" value="17789964283"/>
</td>
<td>sender</td>
</tr>
<tr>
<td>Message:</td>
<td>
<input name="data" type="text" id="data" value="Hello"/>
</td>
<td>data</td>
</tr>
<tr>
<td>User Name:</td>
<td>
<input name="name" type="text" id="name" value="cjensen"/>
</td>
<td>name</td>
</tr>
<tr>
<td>Inbound Number:</td>
<td>
<input name="inboundnumber" type="text" id="inboundnumber" value="16047807002"/>
</td>
<td>inboundnumber</td>
</tr>
<tr>
<td>Carrier Code:</td>
<td>
<input name="carriercode" type="text" id="carriercode"/>
</td>
<td>carriercode</td>
</tr>
<tr>
<td colspan="2" align="right">
<input type="submit" name="Submit" value="Submit"/>
</td>
<td> </td>
</tr>
</table>
</form>
</body>
</html>

</source>

Examples And Concepts

2007-03-28T17:44:39Z

Old-user20: /* Receiving SMS */

=== SOAP API Usage ===
Every function of the SOAP API that requires authentication must pass in Authentication Parameters, to acquire a set of Authentication Parameters, please use the API found at: http://api.upsidewireless.com/soap/Authentication.asmx

=== Sending SMS ===

=== Receiving SMS ===
The method of receiving Inbound SMS messages is by way of HTTP POST. A few variables are passed in the body of the POST.
* name
* sender
* data
* carriercode << For shortcode accounts only
* inboundnumber << For Dedicated accounts only

In order to receive an SMS you must first register a URL in your account. Your account must be enabled to allow adding of URLs. Once your account has the registered URL set up, you will then need to forward all inbound SMS messages to that URL.

You can use the following HTML to emulate what our server will send your service.

<pre>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<title>Received SMS Emulator (Via HTTP POST)</title>
</head>
<body>
<form id="emulator" name="emulator" method="post" action="http://sms.yourdomain.com/incoming.php">
<table>
<tr>
<td>Sender:</td>
<td>
<input name="sender" type="text" id="sender" value="17789964283"/>
</td>
<td>sender</td>
</tr>
<tr>
<td>Message:</td>
<td>
<input name="data" type="text" id="data" value="Hello"/>
</td>
<td>data</td>
</tr>
<tr>
<td>User Name:</td>
<td>
<input name="name" type="text" id="name" value="cjensen"/>
</td>
<td>name</td>
</tr>
<tr>
<td>Inbound Number:</td>
<td>
<input name="inboundnumber" type="text" id="inboundnumber" value="16047807002"/>
</td>
<td>inboundnumber</td>
</tr>
<tr>
<td>Carrier Code:</td>
<td>
<input name="carriercode" type="text" id="carriercode"/>
</td>
<td>carriercode</td>
</tr>
<tr>
<td colspan="2" align="right">
<input type="submit" name="Submit" value="Submit"/>
</td>
<td> </td>
</tr>
</table>
</form>
</body>
</html>

</pre>

PHP Receiving SMS

2007-03-12T22:00:38Z

Old-user20: New page: <pre> <?php $sender = $_POST['sender']; $data = $_POST['data']; $name = $_POST['name']; $message = process_incoming_message($sender, $data, $name); // plug in the values returned from /...

<pre>
<?php

$sender = $_POST['sender'];
$data = $_POST['data'];
$name = $_POST['name'];

$message = process_incoming_message($sender, $data, $name);

// plug in the values returned from
// http://api.upsidewireless.com/soap/Authentication.asmx?op=GetParameters

$token = '4289bd26-4a8c-468b-847e-1ea72fd2dfd1';
$signature = 'y5MZoN7mV0sCYZHrBFDJbPL';

$api_call_data = array(
'token' => $token,
'signature' => $signature,
'recipient' => $sender, // The recipient is the recipient because we are sending right back to them
'message' => $message,
'encoding' => 'Seven' // Use 'Sixteen' if you are sending in Unicode
);

$post_data = build_post_data($api_call_data );

// Please refer to
// http://api.upsidewireless.com/
// for other sending methods

$url = 'http://api.upsidewireless.com/soap/SMS.asmx/Send_Plain';

$xml = do_post_request($url, $post_data);

// be sure you look at the XML from above to see if there are any errors

/************* Main processing function **************/

function process_incoming_message($sender, $data, $name) {

return 'Message Received:' . date("Y-m-d H:i:s");

}

// Everything below is just function definitions

function do_post_request($url, $data, $optional_headers = null)
{
$params = array('http' => array('method' => 'POST', 'content' => $data));

if ($optional_headers !== null) {
$params['http']['header'] = $optional_headers;
}

$ctx = stream_context_create($params);

$fp = @fopen($url, 'rb', false, $ctx);
if (!$fp) {
throw new Exception("Problem with $url, $php_errormsg");
}

$response = @stream_get_contents($fp);

if ($response === false) {
throw new Exception("Problem reading data from $url, $php_errormsg");
}

return $response;
}

function build_post_data($data, $prefix=null, $sep='', $key='') {

$ret = array();

foreach((array)$data as $k => $v) {

$k = urlencode($k);

if(is_int($k) && $prefix != null) {
$k = $prefix.$k;
}

if(!empty($key)) {
$k = $key."[".$k."]";
}

if(is_array($v) || is_object($v)) {
array_push($ret, build_post_data($v,"",$sep,$k));
} else {
array_push($ret,$k."=".urlencode($v));
}
}

if(empty($sep)) {
$sep = ini_get("arg_separator.output");
}

return implode($sep, $ret);
}

?>
</pre>

APIs

2007-03-12T21:59:11Z

Old-user20:

Upside Wireless HTTP APIs are located at [http://api.upsidewireless.com/ http://api.upsidewireless.com/]

* API Security
* Ease of Use
* Restrictions
* Intro to MO APIs (Mobile Originated - incoming from a mobile phone)
** MO POP3
** [[MO HTTP]]
** MO HTTPS
* Intro to MT APIs (Mobile Terminated - outgoing to a mobile phone)
** MT HTTP
** MT SMTP
*** [[MT SMTP Auth]]
*** MT Web Text
*** MT IP Address
* User Management
* Settings
* [[Examples And Concepts | Examples and General Concepts]]
** PHP
*** [[PHP Sending SMS | Sending SMS]]
*** [[PHP Receiving SMS | Receiving SMS]]
** Java
*** Sending SMS
*** Receiving SMS
** [[CSharp_Overview | C# (Overview)]]
*** [[CSharp Sending SMS | Sending SMS]]
*** [[CSharp Receiving SMS | Receiving SMS]]

This is a patrolled change

APIs

2007-03-01T00:22:23Z

Old-user20: This should be patrolled

* API Security
* Ease of Use
* Restrictions
* MO APIs (Mobile Originated - incoming from a mobile phone)
** MO POP3
** MO HTTP
** MO HTTPS
* MT APIs (Mobile Terminated - outgoing to a mobile phone)
** MT HTTP
** MT SMTP
*** MT SMTP Auth
*** MT Web Text
*** MT IP Address
* User Management
* Settings
* Examples
** PHP
*** Sending SMS
*** Receiving SMS
** Java
*** Sending SMS
*** Receiving SMS
** C#
*** Sending SMS
*** Receiving SMS

This is a patrolled change

Category:Category Help

2006-12-15T04:04:50Z

Old-user20:

[[Send_SMS]]

Send SMS

2006-12-13T23:47:18Z

Old-user20: added graphic

Do you ever want to use the WEB to send SMS messages?

It's easy to send '''WEB SMS'''. In other words, you can send text messages to ANY PHONE ON THE PLANET using this simple, Hotmail-like WEB SMS interface. You can create your quick-pick lists using the Speed Dial function, or send messages to many people at once. Please make sure that you accurately format the recipient's mobile phone number by composing it with an '''international country code''', area code and local number.

To send a '''WEB SMS''', simply log on to your account from ANY computer and follow the instructions below:

[[Image:sms_compose.gif]]

;To: Valid telephone number of an SMS phone in international format. For example 16047778888 where 1 represents country, 604 are code, and 7778888 local telephone number. For more than one recipient use "," - commas.

NEVER include leading zeros in telephone numbers when you want to send SMS! Also, NEVER include exit codes - for example the exit code from North America is 011 - DO NOT INCLUDE IT.

You can also click on the "To" hyper link to open your contacts list. You can then pick recipients that have mobile numbers defined.

;Split text into: This value indicates how long messages will be treated. Since the maximum length of one SMS message is 160 characters, messages longer than this can be split into multiple messages and sent separately.

;Number of characters typed: Tells you how long your message is.

;Number of credits: Tells you how many credits you have remaining in your pre-paid account.

;CC to email: Specify your email account where a copy of your text message will be sent. This email address must be registered with your account.

;Allow SMS replies: If you set this value to 'true' you allow recipients of your messages to reply to them. They must do so within 24 hours of receipt. Your account will be debited for each message you receive.

;Number of credits: Tells you how many credits you have remaining in your pre-paid account.

;Send: Allows you to send SMS with delay. Great if you are sending SMS messages to someone overseas and do not want to wake him up :-).

Click "'''Send Message'''" on this WEB page and your SMS message (s) will be on its way. The system will first check if you have enough credits left in your accounts. For example, if you want to send SMS text message to three recipients and you have only one credit left, only the first recipient will receive it.

Send SMS

2006-12-13T23:46:32Z

Old-user20: SendSMS moved to Send SMS: Made the name more human

Do you ever want to use the WEB to send SMS messages?

It's easy to send '''WEB SMS'''. In other words, you can send text messages to ANY PHONE ON THE PLANET using this simple, Hotmail-like WEB SMS interface. You can create your quick-pick lists using the Speed Dial function, or send messages to many people at once. Please make sure that you accurately format the recipient's mobile phone number by composing it with an '''international country code''', area code and local number.

To send a '''WEB SMS''', simply log on to your account from ANY computer and follow the instructions below:

;To: Valid telephone number of an SMS phone in international format. For example 16047778888 where 1 represents country, 604 are code, and 7778888 local telephone number. For more than one recipient use "," - commas.

NEVER include leading zeros in telephone numbers when you want to send SMS! Also, NEVER include exit codes - for example the exit code from North America is 011 - DO NOT INCLUDE IT.

You can also click on the "To" hyper link to open your contacts list. You can then pick recipients that have mobile numbers defined.

;Split text into: This value indicates how long messages will be treated. Since the maximum length of one SMS message is 160 characters, messages longer than this can be split into multiple messages and sent separately.

;Number of characters typed: Tells you how long your message is.

;Number of credits: Tells you how many credits you have remaining in your pre-paid account.

;CC to email: Specify your email account where a copy of your text message will be sent. This email address must be registered with your account.

;Allow SMS replies: If you set this value to 'true' you allow recipients of your messages to reply to them. They must do so within 24 hours of receipt. Your account will be debited for each message you receive.

;Number of credits: Tells you how many credits you have remaining in your pre-paid account.

;Send: Allows you to send SMS with delay. Great if you are sending SMS messages to someone overseas and do not want to wake him up :-).

Click "'''Send Message'''" on this WEB page and your SMS message (s) will be on its way. The system will first check if you have enough credits left in your accounts. For example, if you want to send SMS text message to three recipients and you have only one credit left, only the first recipient will receive it.

SendSMS

2006-12-13T23:46:32Z

Old-user20: SendSMS moved to Send SMS: Made the name more human

#REDIRECT [[Send SMS]]

File:Sms compose.gif

2006-12-13T23:44:47Z

Old-user20: Compose SMS Screenshot

Compose SMS Screenshot