Skip to content
A lightweight Ruby Gem for using messaging services.
Branch: master
Clone or download
Latest commit 76c012d Dec 11, 2017
Type Name Latest commit message Commit time
Failed to load latest commit information.
pkg First commit. Publishing to github. Dec 6, 2017
.buildpath First commit. Publishing to github. Dec 6, 2017
.gitignore First commit. Publishing to github. Dec 6, 2017
LICENSE Adds MIT licence Dec 11, 2017 Removes duplicate lines Dec 6, 2017
README.rdoc First commit. Publishing to github. Dec 6, 2017 First commit. Publishing to github. Dec 6, 2017 First commit. Publishing to github. Dec 6, 2017
Rakefile First commit. Publishing to github. Dec 6, 2017

What is it?

A lightweight Ruby Gem for using SMS services.


  • ruby (v1.8 or higher) installed.
  • ruby-gems installed (tested with 1.3.7)


Move to the downloaded BusinessPlatformSDK-x-x-x.gem using the command-line and type:

$ gem install BusinessPlatformSDK

This will install the Ruby-Toolkit with the documentation which can be opened using the "gem-server":

$ gem server

Getting Started With The Toolkit

The project can be included by using:

require "BusinessPlatformSDK"

As a matter of fact there exist two ways for adding the modules(namespaces), that are needed to run the toolkit. Either you include the whole namespace or classes that will be used. For simplicity in the example the latter approach will be used.

The simplest example might be writing a TextSMS to one recipient. First a textMessage-Object has to be created:

text_message =[43123456], "Hey you wanna hang out?")

The first parameter should be a list of telephone-numbers. The second describe the content of the message. Both parameters are mandatory attributes and nil or other parameter-types are not allowed.

As the creation of the text_message is finished we have to send it. So we need our Sms-Client to get this done:

sms_client ="your websms-account username", "your password", "")

To initialize the SmsClient you need your websms-login credentials. If you don't own a websms-account the account-registration can be found at

For the following shipment there are also other parameters needed:

max_sms_per_message = 1

Max sms per message shows in this example that just one sms will be send. This is a security parameter, that will specifies an upper limit for to be send sms. The tutorial on the website ( will give further explanation about this topic.


It's just a test, no real sms will be sent if set to true.

Next step is to send the SmsRequest to the websms-api and save the return code.

 return_code = sms_client.sendTextSms(text_message, max_sms_per_message, test)

If the return_code returns 2000,2001,2002 the request was successful. If something went wrong an exception will be raised. To handle the exception that might be raised during the use of the toolkit, it is advised to write the code between a begin-rescue-clause. The whole code-example might look like the following:

# Include rubygems if your ruby version is below 1.9
require "rubygems"
require "BusinessPlatformSDK"

# included to increase the code-readability
include At::Sms::Business::Sdk
include At::Sms::Business::Sdk::Exception
include At::Sms::Business::Sdk::Domain

    text_message =[43123456],"Hey you wanna hang out?")
    sms_client ="your websms-account username", "your password", "")
    max_sms_per_message = 1
    return_code = sms_client.sendTextSms(text_message, max_sms_per_message, test)

    puts ("success")

 rescue ApiException,AuthorizationFailedException,HttpConnectionException,ParameterValidationException => e
  puts e
You can’t perform that action at this time.