# \[ANN\] Clickatell Ruby API 0.4

**URL:** <https://www.ruby-forum.com/t/ann-clickatell-ruby-api-0-4/113293>\
**Category:** Rails\
**Created:** [August 29, 2007, 4:53pm UTC](https://www.ruby-forum.com/t/ann-clickatell-ruby-api-0-4/113293 "2007-08-29T16:53:57Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![lukeredpath](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/l/9de0a6/32.png) [@lukeredpath](https://www.ruby-forum.com/u/lukeredpath)\
**Post date:** [August 29, 2007, 4:53pm UTC](https://www.ruby-forum.com/t/ann-clickatell-ruby-api-0-4/113293/1 "2007-08-29T16:53:57Z")

</div>

The Clickatell Ruby API is a Ruby interface to the Clickatell SMS  
gateway service ([www.clickatell.com](http://www.clickatell.com)). It allows you to send SMS  
messages in your Ruby and Rails applications.

It also comes with a command line utility, ‘sms’, for sending messages  
directly from the command line.

Using the library is simple, all you need is a Clickatell account and  
a HTTP API Key.

api = Clickatell::API.authenticate(‘your\_api\_id’, ‘your\_username’,  
‘your\_password’)  
api.send\_message(‘447771234567’, ‘Hello from clickatell’)

Using the sms command line utility:

$ sms 0797771234567 ‘Hello world!’

New in this release:

- Restructured API classes into individual files
- Refactored command execution into a separate object  
(CommandExecutor).
- Major refactoring of API module - converted it to a class with API  
methods implemented as instance methods. Code is much cleaner and  
Connection class becomes redundant. See updated documentation.

TO INSTALL:  
$ sudo gem install clickatell

RUBYFORGE:  
[http://rubyforge.org/projects/clickatell/](http://rubyforge.org/projects/clickatell/)

WEBSITE AND DOCUMENTATION:  
[http://clickatell.rubyforge.org](http://clickatell.rubyforge.org)  
[http://clickatell.rubyforge.org/rdoc/](http://clickatell.rubyforge.org/rdoc/)

All feed back is welcome!

Cheers  
Luke R.

---

<div class="post-metadata">

**Author:** ![lukeredpath](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/l/9de0a6/32.png) [@lukeredpath](https://www.ruby-forum.com/u/lukeredpath)\
**Post date:** [August 29, 2007, 5:56pm UTC](https://www.ruby-forum.com/t/ann-clickatell-ruby-api-0-4/113293/2 "2007-08-29T17:56:11Z")

</div>

As a follow up to this, I have written an article on my blog on how to  
use this library with Rails:

[http://www.lukeredpath.co.uk/2007/8/29/sending-sms-messages-from-your-rails-application](http://www.lukeredpath.co.uk/2007/8/29/sending-sms-messages-from-your-rails-application)

---

<div class="post-metadata">

**Author:** ![lukeredpath](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/l/9de0a6/32.png) [@lukeredpath](https://www.ruby-forum.com/u/lukeredpath)\
**Post date:** [August 29, 2007, 6:18pm UTC](https://www.ruby-forum.com/t/ann-clickatell-ruby-api-0-4/113293/3 "2007-08-29T18:18:13Z")

</div>

On 29-Aug-07, at 11:55 AM, Luke R. wrote:

> As a follow up to this, I have written an article on my blog on how to  
> use this library with Rails:
> 
> [http://www.lukeredpath.co.uk/2007/8/29/sending-sms-messages-from-](http://www.lukeredpath.co.uk/2007/8/29/sending-sms-messages-from-)  
> your-rails-application

thank you Luke. Looking forward to checking it out.

Cheers,  
Jodi