Contents

# SmsManager

[![Gem Version](https://badge.fury.io/rb/sms_manager.png)](http://badge.fury.io/rb/sms_manager)
[![Build Status](https://travis-ci.org/dayweek/sms_manager.png?branch=master)](https://travis-ci.org/dayweek/sms_manager)
[![Dependency Status](https://gemnasium.com/dayweek/sms_manager.png)](https://gemnasium.com/dayweek/sms_manager)
[![Code Climate](https://codeclimate.com/github/dayweek/sms_manager.png)](https://codeclimate.com/github/dayweek/sms_manager)
[![Coverage Status](https://coveralls.io/repos/dayweek/sms_manager/badge.svg?branch=master&service=github)](https://coveralls.io/github/dayweek/sms_manager?branch=master)

A Ruby SDK for [smsmanager.cz](http://smsmanager.cz/) - Czech SMS provider.

## Installation

`gem install sms_manager`

Or add to Gemfile:

`gem 'sms_manager'`

## Usage

First you need to setup your credentials:

```ruby
SmsManager.configure do |config|
  config.username = YOUR_USERNAME
  config.hashed_password = HASHED_PASSWORD
end
```

Create the password hash with SHA-1 in console and then put the string into the configuration block:

```ruby
require 'digest/sha1'
Digest::SHA1.hexdigest 'password'
```

That's all. Now you can send SMS messages.

```ruby
SmsManager.send number: '[phone]', message: 'Hello!'
```

You can pass all the parameters available at [SmsManager API](http://smsmanager.cz/api/http/). These additional parameters will be appended to the request:

```ruby
SmsManager.send number: '[phone]', message: 'Hello!', gateway: 'lowcost', time: '2013-01-01T23:59:59'
```

If the service fails an exception is raised. The exception contains error code as well as error message.

```ruby
begin
  SmsManager.send number: '[phone]', message: 'Hello!'
rescue SmsManager::SendingError => e
  puts e.code # => 104
  puts e.message # => Neplatný parametr gateway
end
```

## Copyright

Copyright (c) 2013 David Hrachovy
See [LICENSE][] for details.

[license]: LICENSE.md

Version data entries

3 entries across 3 versions & 1 rubygems

Version	Path
sms_manager-0.3.1	README.md
sms_manager-0.3.0	README.md
sms_manager-0.2.1	README.md