# Ruby SDK

Official Ruby client for the Instasent Transactional API. Install the instasent gem, instantiate Instasent::Client with your api_sms token, and call send_sms.

Minimal client over the Transactional HTTP endpoints. For anything outside the methods below, drop back to a plain HTTP call — the [Reference](/transactional-api/http/reference) documents every endpoint.

## Installation

### Via RubyGems

```bash
gem install instasent
```

### Via Bundler

Add the gem to your `Gemfile`:

```ruby
gem "instasent"
```

Then run `bundle install`.

## Send an SMS

```ruby
require "instasent"

client = Instasent::Client.new(ENV["INSTASENT_TOKEN"])
response = client.send_sms("My company", "+34666666666", "test message")

puts response["response_code"]
puts response["response_body"]
```

## Available methods

```ruby
client.send_sms(sender, to, text)
client.get_sms(page, per_page)
client.get_sms_by_id(message_id)
```

## Getting help

For help installing or using the library, contact [support@instasent.com](mailto:support@instasent.com). Bugs and feature requests belong on the [GitHub repository](https://github.com/instasent).