/simple_desk

API for getsimpledesk.com

Primary LanguageRubyMIT LicenseMIT

SimpleDesk

Simple Desk is an SMS customer engagement platform that allows companies to have 2-way conversations with their customers over SMS - whether it's for sales, customer service, funnel abandonment, or transactional messages.

Installation

Add this line to your application's Gemfile:

gem 'simple_desk'

And then execute:

$ bundle

Or install it yourself as:

$ gem install simple_desk

Then add your API token to your application_root/.env file, or create one if you don't have it.

	SIMPLE_DESK_TOKEN=MY_TOKEN

Usage

###Adding Customers To get started and add a new customer, run: SimpleDesk.add_customer({phone_number: "1231231232"})

While phone_number is required, you can pass additional properties in: - phone_number (required) - email (optional) - first_name (optional) - last_name (optional)

Like this:

	params = {phone_number: "1231231232", email: "elijah@example.com", first_name: "Elijah", last_name: "Murray"}
	SimpleDesk.add_customer(params)

You can also add any amount of additional properties like so (using phone_number as the identifier):

	properties = {revenue_amount: "$100", location: "San Francisco"}
	SimpleDesk.add_customer({phone_number: "1231231232"}, properties)

The gem will turn the properties into a Base64 encoded json object automatically.

You can use params and properties in the same add_customer call too!

###Messaging To message a user the format is similar Note: They do not have to be existing in the system to message. You'll automatically create a new user if you message a new phone number

	message_and_phone_number = {to: 5551231234, text: "Howdy partner!"}
	SimpleDesk.message_customer(message_and_phone_number)

To Do List

Features that still need to be implemented

	- Add ability to pass in properties and convert to base 64
	- Add auto capitalization for names
	- Parse formatting for phone number
- Update readme to explain setting up [IFTTT](https://ifttt.com/recipes/1110-send-an-sms-when-a-new-gmail-is-from-a-specific-email-address)

Contributing

  1. Fork it ( https://github.com/[my-github-username]/simple_desk/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request