smshelper 0.1.3

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.rspec

@@ -0,0 +1 @@
+--color

data/Gemfile

@@ -0,0 +1,21 @@
+source "http://rubygems.org"
+# Add dependencies required to use your gem here.
+# Example:
+#   gem "activesupport", ">= 2.3.5"
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+gem 'api_smith'
+gem 'savon'
+gem 'log4r'
+gem 'textmagic'
+gem 'mediaburst'
+
+group :development do
+  gem "pry"
+  gem "rspec"
+  gem "rdoc"
+  gem "bundler"
+  gem "jeweler"
+  gem "simplecov"
+end

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2012 Voip Scout
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,70 @@
+= smshelper
+A small utility library to do SMS-MT
+
+== Currently supported providers:
+
+* www.bulksms.com
+* www.webtext.com
+* www.clickatell.com
+* www.textmagic.com
+* www.smstrade.eu
+* www.esendex.com
+* www.mediaburst.co.uk
+* www.nexmo.com
+== Features
+
+* unicode support
+* send message
+* check balance
+* check sent message status
+== Installation
+
+gem install smshelper
+== Usage
+
+config = Smshelper::Config.new(
+                               :smswarehouse => {:uname => '', :passwd => ''},
+                               :routomessaging => {:uname => '', :passwd => ''},
+                               :webtext => {:uname => '', :passwd => ''},
+                               :bulksms => {:uname => '', :passwd => ''},
+                               :clickatell => {:api_key => '',:uname => '', :passwd => ''},
+                               :textmagic => {:uname => '', :passwd => ''},
+                               :smstrade => {:api_key => ''},
+                               :esendex => {:uname => '', :passwd => '', :acc => ''},
+                               :mediaburst => {:uname => '', :passwd => ''},
+                               :nexmo => {:uname => '', :passwd => ''},
+                               :detectlanguage_dot_com => '',
+                               :alchemy_language => '')
+
+service0 = Smshelper::Api::Bulksms.new config
+service1 = Smshelper::Api::Webtext.new config
+service2 = Smshelper::Api::Clickatell.new config
+service3 = Smshelper::Api::Textmagic.new config
+service4 = Smshelper::Api::Smstrade.new config, :route => 'gold' # or 'direct'
+service5 = Smshelper::Api::Esendex.new config, 'com:validityperiod' => '1'
+service6 = Smshelper::Api::MediaBurst.new config
+service7 = Smshelper::Api::Nexmo.new config, :ttl => '60000'
+
+message = Smshelper::Message.new(:recipient => '',
+                                 :text => "The balance on #{service.class.to_s} is #{service.get_balance}",
+                                 :sender => '',
+                                 :api => config)
+serviceX.send_message message
+== TODO:
+
+* create rspec tests
+* refactor spaghetti code
+* add support for www.totext.net, www.my-cool-sms.com, sms.vianett.com, www.world-text.com, www.mpulse.eu, www.clicksms.co.uk, www.tellustalk.com, www.aql.com, www.tm4b.com, www.txtnation.com, www.smsextrapro.com, www.truesenses.com, www.traitel.com.au
+== Contributing to smshelper
+
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
+* Fork the project.
+* Start a feature/bugfix branch.
+* Commit and push until you are happy with your contribution.
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2012 Voip Scout.

data/Rakefile

@@ -0,0 +1,49 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "smshelper"
+  gem.homepage = "http://github.com/voipscout/smshelper"
+  gem.license = "MIT"
+  gem.summary = %Q{sms helper gem}
+  gem.description = %Q{works with esendex, textmagic, smstrade, bulksms, routomessaging, smswarehouse, mediaburst, clickatell, webtext}
+  gem.email = "voipscout@gmail.com"
+  gem.authors = ["Voip Scout"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+require 'rdoc/task'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "smshelper #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.3

data/lib/smshelper/api/base.rb

@@ -0,0 +1,21 @@
+# -*- coding: utf-8 -*-
+module Smshelper
+  module Api
+    class Base
+      include APISmith::Client
+      include Log4r
+
+      attr_reader :sent_message_ids, :sent_message_statuses
+      attr_accessor :extra_options
+      def initialize(*args)
+        @log = Logger.new "#{self.class.name}"
+        @log.outputters = Outputter.stdout
+        @log.level = DEBUG #ERROR
+
+        @sent_message_ids, @sent_message_statuses = Array.new, Hash.new
+        @response_code = ResponseCodes.instance
+        @extra_options = args.shift
+      end
+    end
+  end
+end

data/lib/smshelper/api/bulksms.rb

@@ -0,0 +1,50 @@
+module Smshelper
+  module Api
+    class Bulksms < Base
+      base_uri 'http://bulksms.vsms.net:5567'
+
+      def initialize(*args)
+        config = args.shift
+        add_query_options! :username => config.bulksms[:uname], :password => config.bulksms[:passwd]
+        super
+      end
+
+      def send_message(message)
+        if message.utf_8
+          message.to_hex_be
+          q = {:dca => '16bit'}
+        else
+          q = {:allow_concat_text_sms => '1', :concat_text_sms_max_parts => '5'}
+        end
+
+        options = {
+          :msisdn => message.recipient,
+          :message => message.text,
+          :sender => message.sender}
+        options = options.merge(@extra_options) unless @extra_options.nil?
+        resp = (post 'eapi/submission/send_sms/2/2.0', :extra_query => options.merge(q)).split('|')
+        process_response_code(resp.first) ? (@sent_message_ids << resp.last.strip; resp.last.strip) : (raise ErrorDuringSend, @response_code.bulksms(resp.first))
+      end
+
+      def get_balance
+        {'Credits' => (post 'eapi/user/get_credits/1/1.1').split('|').last.chomp}
+      end
+
+      def get_status(message_id)
+        options = {:batch_id => message_id}
+        resp = (post 'eapi/status_reports/get_report/2/2.0', :extra_query => options)
+        @sent_message_statuses[message_id] = []
+        resp.split(/\n\n/).last.split(/\n/).each_with_index do |status, index|
+          status = status.split('|').last
+          @sent_message_statuses[message_id] << {"part #{index}" => @response_code.bulksms(status)}
+        end
+        {message_id => @sent_message_statuses[message_id]}
+      end
+
+      private
+      def process_response_code(code)
+        (code == '0') ? true : false
+      end
+    end
+  end
+end

data/lib/smshelper/api/clickatell.rb

@@ -0,0 +1,54 @@
+module Smshelper
+  module Api
+    class Clickatell < Base
+      base_uri 'http://api.clickatell.com/http'
+
+      def initialize(*args)
+        config = args.shift
+        add_query_options! :api_id => config.clickatell[:api_key], :user => config.clickatell[:uname], :password => config.clickatell[:passwd]
+        super
+      end
+
+      def send_message(message)
+        if message.utf_8
+          message.to_hex_be
+          q = {:unicode => '1', :req_feat => '40'}
+        else
+          q = {:req_feat => '32'}
+        end
+
+        options = {
+          :to => message.recipient,
+          :text => message.text,
+          :from => message.sender,
+          :queue => '1',
+          :escalate => '1',
+          :validity => '1',
+          :concat => '3'}
+        options = options.merge(@extra_options) unless @extra_options.nil?
+        resp = (post 'sendmsg', :extra_query => options.merge(q)).split(':')
+        process_response_code(resp.first.strip) ? (@sent_message_ids << resp.last.strip; resp.last.strip) : (raise ErrorDuringSend, resp.last.strip)
+      end
+
+      def get_balance
+        {'Credits' => (post 'getbalance').split(':').last.strip}
+      end
+
+      def get_status(message_id)
+        resp = (post 'querymsg', :extra_query => {:apimsgid => message_id}).split(':')
+        @sent_message_statuses[message_id] = []
+        if process_response_code(resp.first.strip)
+          @sent_message_statuses[message_id] << {"Part 01" => @response_code.clickatell(resp.last.strip)}
+          {message_id => @sent_message_statuses[message_id]}
+        else
+          raise ErrorDuringSend, resp.last.strip
+        end
+      end
+
+      private
+      def process_response_code(code)
+        (code == 'ID') ? true : false
+      end
+    end
+  end
+end

data/lib/smshelper/api/esendex.rb

@@ -0,0 +1,83 @@
+module Smshelper
+  module Api
+    class Esendex < Base
+      INBOX_SERVICE_WSDL = 'https://www.esendex.com/secure/messenger/soap/InboxService.asmx?wsdl'
+      SEND_SERVICE_WSDL = 'https://www.esendex.com/secure/messenger/soap/SendService.asmx?wsdl'
+      ACCOUNT_SERVICE_WSDL = 'https://www.esendex.com/secure/messenger/soap/AccountService.asmx?wsdl'
+
+      attr_reader :inbox
+      def initialize(*args)
+        config = args.shift
+        @header = {
+          "com:Username" => config.esendex[:uname],
+          "com:Password" => config.esendex[:passwd],
+          "com:Account" =>  config.esendex[:acc]}
+
+        Savon.configure do |config|
+          config.raise_errors = true
+          config.log = false
+          config.log_level = :error
+          HTTPI.log = false
+        end
+        @inbox = Array.new
+        super
+      end
+
+      def send_message(message)
+        client = connect 'message'
+        message.utf_8 ? (message_kind = 'Unicode') : (message_kind = 'Text')
+        body = {
+          "com:recipient" => message.recipient,
+          "com:body" => message.text,
+          "com:type" => message_kind,
+          "com:originator" => message.sender}
+        body = body.merge(@extra_options) unless @extra_options.nil?
+
+        resp = client.request(:com, :send_message_full) {|soap| soap.header["com:MessengerHeader"] = @header; soap.body = body}
+        @sent_message_ids << resp.to_hash[:send_message_full_response][:send_message_full_result]
+      end
+
+      def get_inbox
+        client = connect 'inbox'
+        resp = client.request(:com, :get_messages) {|soap| soap.header["com:MessengerHeader"] = @header}
+        @inbox = resp[:get_messages_response][:get_messages_result][:message]
+      end
+
+      def get_balance
+        client = connect 'account'
+        resp = client.request(:com, :get_message_limit) {|soap| soap.header["com:MessengerHeader"] = @header}
+        {'Messages' => resp.to_hash[:get_message_limit_response][:get_message_limit_result].to_s}
+      end
+
+      def get_status(*message_id)
+        message_id.flatten!
+
+        client = connect 'message'
+        message_id.each do |id|
+          resp = client.request(:com, :get_message_status) {|soap| soap.header["com:MessengerHeader"] = @header; soap.body = {"com:id" => id.to_s}}
+          @sent_message_statuses[id] = resp.to_hash[:get_message_status_response][:get_message_status_result]
+        end
+      end
+
+      private
+      def connect(service)
+        case service
+        when 'message'
+          api SEND_SERVICE_WSDL
+        when 'account'
+          api ACCOUNT_SERVICE_WSDL
+        when 'inbox'
+          api INBOX_SERVICE_WSDL
+        end
+      end
+
+      def api(service)
+        client = Savon::Client.new(service)
+        #http://jira.codehaus.org/browse/JRUBY-5529 - jruby-openssl in --1.9 jruby mode
+        client.http.auth.ssl.verify_mode=(:none)
+        client
+      end
+
+    end #class Esendex
+  end #module Api
+end #module Smshelper

data/lib/smshelper/api/mediaburst.rb

@@ -0,0 +1,33 @@
+module Smshelper
+  module Api
+    class MediaBurst < Base
+      def initialize(*args)
+        config = args.shift
+        @client = Mediaburst::API.new config.mediaburst[:uname], config.mediaburst[:passwd]
+        super
+      end
+      def send_message(message)
+        #TODO: rewrite Mediaburst::API.process_response to provide
+        #full response data, so that msg_id could be had in @sent_message_ids
+        message.utf_8 ? (q = {:msgtype => 'ucs2'}) : (q = {:msgtype => 'text'})
+        options = {:concat => '3', :from => message.sender}.merge(q)
+        options = options.merge(@extra_options) unless @extra_options.nil?
+        resp = @client.send_message message.recipient, message.text, options
+        process_response_code(resp.values.last.to_s) ? resp.to_s : (raise ErrorDuringSend, @response_code.mediaburst(resp.values.last.to_s))
+      end
+
+      def get_balance
+        {'Messages' => @client.get_credit}
+      end
+
+      def get_status(message_id)
+        raise NotImplementedError, "Sms status checks unsupported by #{self.class.name}"
+      end
+
+      private
+      def process_response_code(code)
+        (code == 'true') ? true : false
+      end
+    end
+  end
+end

data/lib/smshelper/api/nexmo.rb

@@ -0,0 +1,43 @@
+module Smshelper
+  module Api
+    class Nexmo < Base
+      base_uri 'http://rest.nexmo.com'
+      headers 'Accept' => 'application/json'
+
+      def initialize(*args)
+        config = args.shift
+        @uname, @passwd = config.nexmo[:uname], config.nexmo[:passwd]
+        super
+      end
+
+      def send_message(message)
+        message.utf_8 ? (q = {:type => 'unicode'}) : (q = {:type => 'text'})
+
+        options = {
+          :username => @uname,
+          :password => @passwd,
+          :to => message.recipient,
+          :text => message.text,
+          :from => message.sender}
+        options = options.merge(@extra_options) unless @extra_options.nil?
+        options = options.merge(q)
+        resp = (post 'sms/json', :extra_query => options)
+        resp
+        # process_response_code(resp.first) ? (@sent_message_ids << resp.last.strip; resp.last.strip) : (raise ErrorDuringSend, @response_code.nexmo(resp.first))
+      end
+
+      def get_balance
+        {'EUR' => (get "account/get-balance/#{@uname}/#{@passwd}").values.last.to_s}
+      end
+
+      def get_status(message_id)
+      end
+
+      private
+      def process_response_code(code)
+        (code == '0') ? true : false
+      end
+
+    end
+  end
+end

data/lib/smshelper/api/response_codes.rb

@@ -0,0 +1,203 @@
+# -*- coding: utf-8 -*-
+module Smshelper
+  module Api
+    class ResponseCodes
+      include Singleton
+
+      BULKSMS = {
+        '0' => 'In progress',
+        '1' => 'Scheduled',
+        '10' => 'Delivered upstream',
+        '11' => 'Delivered to mobile',
+        '12' => 'Delivered upstream unacknowledged',
+        '22' => 'Internal fatal error',
+        '23' => 'Authentication failure',
+        '24' => 'Data validation failed',
+        '25' => 'You do not have sufficient credits',
+        '26' => 'Upstream credits not available',
+        '27' => 'You have exceeded your daily quota',
+        '28' => 'Upstream quota exceeded',
+        '29' => 'Message sending cancelled',
+        '31' => 'Unroutable',
+        '32' => 'Blocked',
+        '33' => 'Failed: censored',
+        '40' => 'Temporarily unavailable',
+        '50' => 'Delivery failed - generic failure',
+        '51' => 'Delivery to phone failed',
+        '52' => 'Delivery to network failed',
+        '53' => 'Message expired',
+        '54' => 'Failed on remote network',
+        '56' => 'Failed: remotely censored',
+        '57' => 'Failed due to fault on handset',
+        '60' => 'Transient upstream failure',
+        '61' => 'Upstream status update',
+        '62' => 'Upstream cancel failed',
+        '63' => 'Queued for retry after temporary failure delivering',
+        '64' => 'Queued for retry after temporary failure delivering, due to fault on handset',
+        '70' => 'Unknown upstream status',
+        '201' => 'Maximum batch size exceeded'}
+
+      WEBTEXT = {
+        '000' => 'Success. Message accepted for delivery',
+        '101' => 'Missing parameter: api_id',
+        '102' => 'Missing parameter: api_pwd',
+        '103' => 'Missing parameter: txt',
+        '104' => 'Missing parameter: dest',
+        '105' => 'Missing parameter: msgid',
+        '106' => 'Missing parameter: receipt_url',
+        '107' => 'Missing parameter: receipt_email',
+        '108' => 'Invalid value for parameter: hex',
+        '109' => 'Missing parameter: hex (unicode parameter has been presented, but no hex value)',
+        '110' => 'Missing parameter: si_txt',
+        '111' => 'Missing parameter: si_url',
+        '112' => 'Missing parameter: group_name',
+        '113' => 'Missing parameter: group_alias',
+        '114' => 'Missing parameter: contact_num',
+        '115' => 'Missing parameter: remove_num',
+        '199' => 'Insufficient Credit',
+        '201' => 'Authentication Failure',
+        '202' => 'IP Restriction – an attempt has been made to send from an unauthorised IP address',
+        '203' => 'Invalid value for parameter: dest',
+        '204' => 'Invalid value for parameter: api_pwd',
+        '205' => 'Invalid value for parameter: api_id',
+        '206' => 'Invalid value for parameter: delivery_time',
+        '207' => 'Invalid date specified for delivery_time',
+        '208' => 'Invalid value for parameter: delivery_delta',
+        '209' => 'Invalid value for parameter: receipt',
+        '210' => 'Invalid value for parameter: msgid',
+        '211' => 'Invalid value for parameter: tag',
+        '212' => 'Invalid value for parameter: si_txt',
+        '213' => 'Invalid value for parameter: si_url',
+        '214' => 'Invalid value for parameter: group_name',
+        '215' => 'Invalid value for parameter: group_alias',
+        '216' => 'Invalid value for parameter: contact_num',
+        '217' => 'Invalid value for parameter: remove_num',
+        '401' => 'Not a contact',
+        '402' => 'Invalid value for parameter: group_alias'}
+
+      CLICKATELL = {
+        '001' => 'Message unknown',
+        '002' => 'Message queued',
+        '003' => 'Delivered to gateway',
+        '004' => 'Received by recipient',
+        '005' => 'Error with message',
+        '006' => 'User cancelled message delivery',
+        '007' => 'Error delivering message',
+        '008' => 'OK',
+        '009' => 'Routing error',
+        '010' => 'Message expired',
+        '011' => 'Message queued for later delivery',
+        '012' => 'Out of credit',
+        '014' => 'Maximum MT limit exceeded'}
+
+      SMSTRADE = {
+        '10' => 'Receiver number not valid',
+        '20' => 'Sender number not valid',
+        '30' => 'Message text not valid',
+        '31' => 'Message type not valid',
+        '40' => 'SMS route not valid',
+        '50' => 'Identification failed',
+        '60' => 'Not enough balance in account',
+        '70' => 'Network does not support the route',
+        '71' => 'Feature is not possible by the route',
+        '80' => 'Handover to SMSC failed',
+        '100' => 'SMS has been sent successfully'}
+
+      MEDIABURST = {
+        '1' => 'Internal Error',
+        '2' => 'Invalid Username Or Password',
+        '3' => 'Insufficient Credits Available',
+        '4' => 'Authentication Failure',
+        '5' => 'Invalid MsgType',
+        '6' => "‘To’ Parameter Not Specified",
+        '7' => "‘Content’ Parameter Not Specified",
+        '8' => "‘MessageID’ Parameter Not specified",
+        '9' => "Unknown ‘MessageID’",
+        '10' => "Invalid ‘To’ Parameter",
+        '11' => "Invalid ‘From’ Parameter",
+        '12' => 'Max Message Parts Exceeded',
+        '13' => 'Cannot Route Message',
+        '14' => 'Message Expired',
+        '15' => 'No route defined for this number',
+        '16' => "‘URL’ parameter not set",
+        '17' => 'Invalid Source IP',
+        '18' => "‘UDH’ Parameter Not Specified",
+        '19' => "Invalid ‘ServType’ Parameter",
+        '20' => "Invalid ‘ExpiryTime’ Parameter",
+        '25' => 'Duplicate ClientId received',
+        '26' => 'Internal Error',
+        '27' => "Invalid ‘TimeStamp’ Parameter",
+        '28' => "Invalid ‘AbsExpiry’ Parameter",
+        '29' => "Invalid ‘DlrType’ Parameter",
+        '31' => "Invalid ‘Concat’ Parameter",
+        '32' => "Invalid ‘UniqueId’ Parameter",
+        '33' => "Invalid ‘ClientId’ Parameter",
+        '39' => "Invalid character in ‘Content’ parameter",
+        '40' => 'Invalid TextPayload',
+        '41' => 'Invalid HexPayload',
+        '42' => 'Invalid Base64Payload',
+        '43' => 'Missing content type',
+        '44' => 'Missing ID',
+        '45' => 'MMS Message too large',
+        '46' => 'Invalid Payload ID',
+        '47' => 'Duplicate Payload ID',
+        '48' => 'No payload on MMS',
+        '49' => "Duplicate ‘filename’ Attribute on Payload",
+        '50' => "‘ItemId’ Parameter Not Specified",
+        '51' => "Invalid ‘ItemId’ Parameter",
+        '52' => 'Unable to generate filename for Content-Type',
+        '53' => "Invalid ‘InvalidCharAction’ Parameter",
+        '54' => "Invalid ‘DlrEnroute’ Parameter",
+        '55' => "Invalid ‘Truncate’ Parameter",
+        '56' => "Invalid ‘Long’ Parameter",
+        '100' => 'Internal Error',
+        '101' => 'Internal Error',
+        '102' => 'Invalid XML',
+        '103' => 'XML Document does not validate',
+        '300' => 'Client ID too long',
+        '305' => 'Query throttling rate exceeded'}
+
+      NEXMO = {
+        '0' => 'Success',
+        '1' => 'Throttled',
+        '2' => 'Missing params',
+        '3' => 'Invalid params',
+        '4' => 'Invalid credentials',
+        '5' => 'Internal error',
+        '6' => 'Invalid message',
+        '7' => 'Number barred',
+        '8' => 'Partner account barred',
+        '9' => 'Partner quota exceeded',
+        '10' => 'Too many existing binds',
+        '11' => 'Account not enabled for REST',
+        '12' => 'Message too long',
+        '15' => 'Invalid sender address',
+        '16' => 'Invalid TTL'}
+
+      def webtext(code)
+        WEBTEXT[code]
+      end
+
+      def bulksms(code)
+        BULKSMS[code]
+      end
+
+      def clickatell(code)
+        CLICKATELL[code]
+      end
+
+      def smstrade(code)
+        SMSTRADE[code]
+      end
+
+      def mediaburst(code)
+        MEDIABURST[code]
+      end
+
+      def nexmo(code)
+        NEXMO[code]
+      end
+
+    end
+  end
+end