nextbss/sendout

A Ruby gem to access and interact with the SendOut

Sendout

A ruby gem createb by SmartTechys for the SendOut API that allows your application to send text messages (Angolan and International).

ATTENTION

• API Version 1 - Gem sendout v0.1.1
• API Version 2 - Gem sendout v0.1.2

Installation

Add this line to your application's Gemfile:

gem 'sendout'

And then execute:

$ bundle

Or install it yourself as:

$ gem install sendout

Setup

• Make sure you've registed at SendOut and have produced your token(api_token) and id(your registered phone number).
• Setup your environments variables

SO_API_ID=244911222333
SO_API_TOKEN=your_api_token_obtained_from_control_panel_at_sendout

Usage

At the moment there's only two sendOut endpoints in production:

• Check your balance
• Send one or bulk message

Check your balance

Sendout.check_balance

# It will return a json

{
  "cliente": "2449XXXXXXXX"
   "saldo": "512"
   "enviadas": "203"
   "contactos": "2"
   "campanhas": "1"
}

Send one or bulk message - Production Environment

Sendout.send_sms(num, false, msg)

# The num has to be an array the debug a boolean, and the msg an string. This method will return an array of one or more JSON objects.

Response:

[
    {
        "id":"0800000018E1C4DA",
        "de":"2449XXXXXXX5",
        "para":"2449XXXXXXX0",
        "remetente":"SENDOUT",
        "caracteres":"24",
        "quantidade":"1",
        "data":"07-01-2017 18:59:37",
        "rede":"00000",
        "enviado":true,
        "estado":"Entregue"
    }
]

Send one or bulk message - Test Environment

You need to add a boolean value true to send as test; if false will send it to production

Sendout.send_sms(num, true, msg)

# The num has to be an array and the msg an string. This method will return an array of one or more JSON objects

Help and Docs

• SendOut
• RDoc

Development

• You can fork it
• bundle
• bundle rake exec
• Make your feature addition or fix a bug
• Do not mess with the rakefile version or history (do not submit version bump PLEASE or put it in a different commit so we can ignore it when pull)
• Send us the pull request

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/smaziano/sendout. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

License

The gem is available as open source under the terms of the MIT License.

sendout's Issues

Security - Rake Update (CVE-2020-8130)

Vulnerable versions: <= 12.3.2
Patched version: 12.3.3
There is an OS command injection vulnerability in Ruby Rake before 12.3.3 in Rake::FileList when supplying a filename that begins with the pipe character |.

Update to SendOut API V2

Update the gem to support the new version of the API.