SmsBlitz

SmsBlitz is a library for elixir that allows you to send SMS messages through multiple different providers.

SmsBlitz provides a generic behaviour to make it easy to write conforming client libraries, while also making it simple for developers to choose which provider to use (you could use elibphonenumber to detect the destination country and use the cheapest provider for that country, for example).

Installation

If available in Hex, the package can be installed as:

1. Add sms_blitz to your list of dependencies in mix.exs:

   def deps do

    [{:sms_blitz, "~> 0.0.1"}]

   end

2. Ensure sms_blitz is started before your application:

   def application do

    [applications: [:sms_blitz]]

   end

Setup

Setting up with SmsBlitz is easy. You simply add the authentication details for the providers you want to use into to your config:

config :sms_blitz, plivo: {"api_token", "api_key"}
config :sms_blitz, itagg: {"username", "password", "route"}
config :sms_blitz, twilio: {"account_sid"}

Then you can send the SMS to the provider as simply as this:

SmsBlitz.send_sms(:itagg, from: "Johnny", to: "07123456789", message: "Here's Johnny!")

# Or...

SmsBlitz.send_sms(:plivo, from: "Johnny", to: "07123456789", message: "Here's Johnny!")

# Or...

SmsBlitz.send_sms(:twilio, from: "Johnny", to: "07123456789", message: "Here's Johnny!")

The output of the send_sms/2 command above will either be like:

%{
  id: "id here",
  result_string: "Things went well",
  status_code: "1337"
}

Or an Array of maps formatted as above. It's important that you handle both types of responses!