AlexaRubykit

Gem VersionBuild Status

This gem implements a quick back-end service for deploying applications for Amazon's Echo (Alexa).

Installation

For Ruby Projects:

Add this line to your application's Gemfile:

gem 'better_alexa_rubykit'

And then execute:

$ bundle

Or install it yourself as:

$ gem install better_alexa_rubykit

Usage

This Gem provides methods to create and handle request and response objects to be used in your container of choice.

Sample usage:

require 'better_alexa_rubykit'
response = BetterAlexaRubykit::Response.new
response.add_speech('Ruby is running ready!')
response.build_response

Will generate a valid outputspeech response in JSON format:

$ {"version":"1.0","response":{"outputSpeech":{"type":"PlainText","text":"Ruby is running ready!"},"shouldEndSession":true}}

Troubleshooting

There are two sources of troubleshooting information: the Amazon Echo app/website and the EBS logs that you can get from the management console.

  • "Error in SSL handshake" : Make sure your used the FQDN when you generated the SSL and it's also the active SSL in EBS.
  • "Error communicating with the application" : Query the EBS logs from the management console and create an issue on GitHub.

Contributing

  1. Decide to work on the "dev" (unstable) branch or "master" (stable)
  2. Fork it ( https://github.com/kjanoudi/better_alexa_rubykit/fork )
  3. Create your feature branch (git checkout -b my-new-feature)
  4. Commit your changes (git commit -am 'Add some feature')
  5. Push to the branch (git push origin my-new-feature)
  6. Create a new Pull Request

Special Thanks To