With
a 1609SMS IP-SMS account, you get the powerful middleware
available through the advanced 1609SMS Message Gateway, to connect
directly to the power stations of premium European Mobile operators. This allows you to
create sms messages from any existing application (with Internet connection) or website,
simply by posting a http
request to the 1609sms server or otherwise by using the
module
to send individual or group messages using our client platform.
The request is verified and you receive a
response from the 1609SMS server. Creating and
unlocking SMS messages from your existing
applications has never been so easy and fast.
Through our gateways you can very easily
integrate your existing management software with
our services and for example encode your
password, with
SHA-1
encoding for extra security.
Of course you can also link a
virtual
number to our systems,
receive
incoming text messages, and create automatic
respons actions.
Summary:
-
SMS messages that can be generated
over the http-protocol
-
Enrich and unlock (Web) applications
with SMS
-
Suitable for all programming languages and
scripts
PHP example
Some
applications for IP-SMS
-
Planning or inventory systems linked to SMS.
Inform your customers real-time with SMS on the
status of orders.
-
SMS service to make your site more interactive:
Think about driving directions, contact information and
the latest news by SMS.
-
Streamline internal business processes, Confirm
appointments for your sales team, make important
announcements, and receive notifications when servers
are down etc...
-
Clientele that use the 1609SMS Gateway API are
for example :
◘
Address the URL :

The 1609SMS message gateway is connected with many
European SMSC-Gateway stations, so a good Quality of
Service (availability, capacity and speed) is
available.
The most common method of passing messages through
our gateway, wether to send or receive, is through
the HTTP GET / POST protocol.
Through an HTTP request (GET or POST) , our gateway
can be connected to your private software application.
http://217.19.227.48/module/gateway.php?clientuser=USERNAME&clientpwd=PASSWORD&message=MESSAGE&to=TO&sender=SENDER
(simple test) - When you copy
the above string to a browser, enter your Username and Password, you can easily send bulk/group sms messages over URL. When
you ad 44762345678,4476612345677, only
seperated by a comma, you're sending to
multiple mobile numbers.
Open your
test account
to give this a try.
|
Answer |
Explanation |
Comment |
|
OK |
Your text
message was sent successfully |
Your text
message was sent successfully |
|
ERROR x.x.x |
There was a
problem + errorcode |
A list of
possible errorcodes can be found below |
For more information on
sending
or
receiving
text messages ?
You must always encode the above url before you send,
as it should not contain spaces
Example : message=this is a test , this should be :
message=this%20is%20a%20test
When using PHP, there is a simple function for this :
urlencode($url);
This must be done for the sendername as well, in
case
you want to use spaces or other special
characters
!
UTF-8
(8-
bit
Unicode Transformation Format) is one way to
Unicode/ISO
10646-save characters as a stream of
bytes,
a so called
character
encoding. UTF-8 is a character encoding
with a variable length: not every character uses the
same amount of bytes. Depending on the
character, between 1 and 4 bytes
are being used. Because many Western
characters only take 1 byte, UTF-8 is more compact
for western languages.
When you send via our gateway(s), make sure
that your message (message) and the sender name (sender)
is UTF-8 encoded.
You can also easily test UTF8 encoding on this page:
http://www.hypergurl.com/urlencode.html
;
Note: switch encoding to UTF8, not ASCII
The
1609SMS gateway supports the use of alphanumeric
senders (letters and / or numbers).
Instead of a phonenumber the recipient of the
text message sees - up to 11 characters - as the
sender id.
|
◘
Examples of scripts in various
programming languages : |
|
Programming
language |
Name |
Explanation |
|
PHP |
Fsockopen |
This is
where you can find information on, a PHP function
to address a url. |
|
PHP |
Urlencode |
Here you
can find information on urlencode, a PHP function
for encoding a url. |
|
VB.net |
easyHTTP |
This is
where you can find information on addressing
the gateway via VB.net |
|
Parameter |
Explanation |
Comment |
|
clientuser |
your username |
Identical as
the one you received for the sms module |
|
clientpwd |
your password |
Identical as
the one you received for the sms module (
you can encode this password by using
SHA-1
for additional
security. ( only the use of 1 - case
characters is allowed ) |
|
message |
the text
message |
Note : the
message should be urlencoded before you send
it. (this is a test = this%20is%20a%20test) |
|
to |
the mobile
number |
A valid mobile
number (always starts with the correct
country code : for example
(44701xxxxxxx) |
|
sender |
the sendername |
a maximum of 11
characters
(sendername) |
|
|
|
|
|
Optional parameters |
|
logging=ja |
Logging functon |
If you add logging=yes
, all sms shipments will automatically be
saved under the tab "history" within the sms
module. |
|
delivery=ja |
Delivery
reports |
If you add delivery=yes
, in case of a successful transmission, you
receive sending OK +
a smsID in return.
example : OK 1234567
Thereafter you can capture this SMS ID ,implement
a call back function, and ask for the report. |
|
type=long |
The sending of
long sms messages |
Incase you add type=long
, you can send messages over 160 characters.
The message will be split into serveral text
messages and subsequently being shown as a
single message. You can deliver a message up
to 459 characters, and we will split it up
to a maximum of 3 messages. ( Note : Only 153
Characters can be used (the other 7
characters are used to indicate this is a
"long sms"). |
|
test=yes |
Testing the
system |
The system will
conduct all the checks (correct username, password, message, sendername, ...) but effectively won't send an sms. No
credits will be deducted. |
If your message wasn't send
successfully, the gateway will provide you with an
error + nr. in return. Here you can find a list of
errors:
|
Errorcode |
Explanation |
|
100 |
Username -
value - is empty and cannot be empty |
|
101 |
Password -
value - is empty and cannot be empty |
|
102 |
SMS message has
no content |
|
103 |
Mobile number
has no content |
|
104 |
No valid
username and/or password combination |
|
105 |
Message
contains more characters (> 160 tekens)
than allowed |
|
106 |
No valid mobile
number. A valid number always starts with
the country code followed by the number :
example 44701xxxxxxx |
|
107 |
No valid
countrycode. You cannot send text messages
to this country. Please contact us so we can
make this possible. |
|
108 |
You do not have
sufficiënt credits left |
|
109 |
The sendername
is empty |
|
110 |
You are using a
sender number, but it should always start
with the + sign. |
|
111 |
You are using a
non valid sendername/username. This can be
up to 12 characters. |
|
112 |
You are using a
non valid countrycode |
|
113 |
Your sendername/number
contains special characters not allowed on
all networks. |
|
114 |
No valid
country code (country is not permitted). |
|
115 |
Your account
has been blocked because your payment has
not been received (yet). |
|
116 |
Your account
has been blocked for distinct reasons. You
can contact us for additional information.
|
|
117 |
This sendername
is not allowed. |
|
118 |
If you want to
send a long text message (> 160 tekens)
this may reach a maximum length of 3
messages, (max 153 characters per message)
so, up to 459 characters. |
|
119 |
For delivery of
text messages to this country, we do not
offer the option of sending long text
messages (> 160 tekens). |
|
120 |
There is a
problem with our gateway. Please contact us. |
|
150 |
Our module and
services are currently unavailable because
of sceduled maintenance |
|
◘
Request for delivery reports : |
In order to receive the delivery reports,
always use the parameter "delivery=yes".
You will receive the answer OK + nr in return .
Example OK
1234567
On this page you can retrieve the
status :
http://217.19.227.48/module/gatewayrapport.php?smsid=1234567
The system provides a code in return according to
the status of the message.
|
Deliverycode |
Explanation |
|
DELIVERED |
The message
was delivered successfully (endstatus) |
|
NOT DELIVERED |
The message
was not delivered successfully (endstatus) |
|
BUFFERED |
The message
was accepted by the operator, but not
yet delivered to the recipient. The
operator shall periodically attempt to
deliver the message. This is a temporary
status. |
|
SUBMITTED |
The message
was delivered successfully to the
operator, there is however no status
available (yet). |
|
REJECTED |
The operator has
rejected this message (endstatus) |
|
NONE |
This
message has no delivery report available
and therefore no known status. |
|
◘
Request for remaining amount of credits
: |
You can also retrieve the number of
remaining credits to the gateway:
http://217.19.227.48/module/gateway.php?clientuser=USERNAME&clientpwd=PASSWORD&action=credits
This will return a certain number : example 476
This is the number of credits still remaining in
your sms account.
Of course you can
contact us if you have problems with the
implementation of our gateway in your scripts. Send
your questions / scripts to
php-support@1609sms.com
To further test our gateway and unlock
messages from your existing applications, open a
test-account
,
and you will receive your username and
password via email to be used as identification data
to connect your scripts.
Or, contact us via chat, by clicking the
live support button below.

|